mirror of
https://github.com/ruby/ruby.git
synced 2025-08-24 13:34:17 +02:00
fef0051926
There already different ways of toggling off this behavior, like setting
`bundle config clean false`, or configuring Bundler to install to system
gems with `bundle config path.system true`.
6daa09f60a
75 lines
3.6 KiB
Groff
75 lines
3.6 KiB
Groff
.\" generated with Ronn-NG/v0.10.1
|
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
.TH "BUNDLE\-LOCK" "1" "July 2025" ""
|
|
.SH "NAME"
|
|
\fBbundle\-lock\fR \- Creates / Updates a lockfile without installing
|
|
.SH "SYNOPSIS"
|
|
\fBbundle lock\fR [\-\-update] [\-\-bundler[=BUNDLER]] [\-\-local] [\-\-print] [\-\-lockfile=PATH] [\-\-full\-index] [\-\-gemfile=GEMFILE] [\-\-add\-checksums] [\-\-add\-platform] [\-\-remove\-platform] [\-\-normalize\-platforms] [\-\-patch] [\-\-minor] [\-\-major] [\-\-pre] [\-\-strict] [\-\-conservative]
|
|
.SH "DESCRIPTION"
|
|
Lock the gems specified in Gemfile\.
|
|
.SH "OPTIONS"
|
|
.TP
|
|
\fB\-\-update[=<list>]\fR
|
|
Ignores the existing lockfile\. Resolve then updates lockfile\. Taking a list of gems or updating all gems if no list is given\.
|
|
.TP
|
|
\fB\-\-bundler[=BUNDLER]\fR
|
|
Update the locked version of bundler to the given version or the latest version if no version is given\.
|
|
.TP
|
|
\fB\-\-local\fR
|
|
Do not attempt to connect to \fBrubygems\.org\fR\. Instead, Bundler will use the gems already present in Rubygems' cache or in \fBvendor/cache\fR\. Note that if a appropriate platform\-specific gem exists on \fBrubygems\.org\fR it will not be found\.
|
|
.TP
|
|
\fB\-\-print\fR
|
|
Prints the lockfile to STDOUT instead of writing to the file system\.
|
|
.TP
|
|
\fB\-\-lockfile=LOCKFILE\fR
|
|
The path where the lockfile should be written to\.
|
|
.TP
|
|
\fB\-\-full\-index\fR
|
|
Fall back to using the single\-file index of all gems\.
|
|
.TP
|
|
\fB\-\-gemfile=GEMFILE\fR
|
|
Use the specified gemfile instead of [\fBGemfile(5)\fR][Gemfile(5)]\.
|
|
.TP
|
|
\fB\-\-add\-checksums\fR
|
|
Add checksums to the lockfile\.
|
|
.TP
|
|
\fB\-\-add\-platform=<list>\fR
|
|
Add a new platform to the lockfile, re\-resolving for the addition of that platform\.
|
|
.TP
|
|
\fB\-\-remove\-platform=<list>\fR
|
|
Remove a platform from the lockfile\.
|
|
.TP
|
|
\fB\-\-normalize\-platforms\fR
|
|
Normalize lockfile platforms\.
|
|
.TP
|
|
\fB\-\-patch\fR
|
|
If updating, prefer updating only to next patch version\.
|
|
.TP
|
|
\fB\-\-minor\fR
|
|
If updating, prefer updating only to next minor version\.
|
|
.TP
|
|
\fB\-\-major\fR
|
|
If updating, prefer updating to next major version (default)\.
|
|
.TP
|
|
\fB\-\-pre\fR
|
|
If updating, always choose the highest allowed version, regardless of prerelease status\.
|
|
.TP
|
|
\fB\-\-strict\fR
|
|
If updating, do not allow any gem to be updated past latest \-\-patch | \-\-minor | \-\-major\.
|
|
.TP
|
|
\fB\-\-conservative\fR
|
|
If updating, use bundle install conservative update behavior and do not allow shared dependencies to be updated\.
|
|
.SH "UPDATING ALL GEMS"
|
|
If you run \fBbundle lock\fR with \fB\-\-update\fR option without list of gems, bundler will ignore any previously installed gems and resolve all dependencies again based on the latest versions of all gems available in the sources\.
|
|
.SH "UPDATING A LIST OF GEMS"
|
|
Sometimes, you want to update a single gem in the Gemfile(5), and leave the rest of the gems that you specified locked to the versions in the \fBGemfile\.lock\fR\.
|
|
.P
|
|
For instance, you only want to update \fBnokogiri\fR, run \fBbundle lock \-\-update nokogiri\fR\.
|
|
.P
|
|
Bundler will update \fBnokogiri\fR and any of its dependencies, but leave the rest of the gems that you specified locked to the versions in the \fBGemfile\.lock\fR\.
|
|
.SH "SUPPORTING OTHER PLATFORMS"
|
|
If you want your bundle to support platforms other than the one you're running locally, you can run \fBbundle lock \-\-add\-platform PLATFORM\fR to add PLATFORM to the lockfile, force bundler to re\-resolve and consider the new platform when picking gems, all without needing to have a machine that matches PLATFORM handy to install those platform\-specific gems on\.
|
|
.P
|
|
For a full explanation of gem platforms, see \fBgem help platform\fR\.
|
|
.SH "PATCH LEVEL OPTIONS"
|
|
See bundle update(1) \fIbundle\-update\.1\.html\fR for details\.
|