2018-11-02 19:07:56 -04:00
|
|
|
BUNDLE-LOCK(1) BUNDLE-LOCK(1)
|
|
|
|
|
|
|
|
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
NAME
|
|
|
|
bundle-lock - Creates / Updates a lockfile without installing
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
SYNOPSIS
|
|
|
|
bundle lock [--update] [--local] [--print] [--lockfile=PATH]
|
2018-11-02 19:07:56 -04:00
|
|
|
[--full-index] [--add-platform] [--remove-platform] [--patch] [--minor]
|
|
|
|
[--major] [--strict] [--conservative]
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
DESCRIPTION
|
2018-11-02 19:07:56 -04:00
|
|
|
Lock the gems specified in Gemfile.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
OPTIONS
|
|
|
|
--update=<*gems>
|
2018-11-02 19:07:56 -04:00
|
|
|
Ignores the existing lockfile. Resolve then updates lockfile.
|
2019-04-14 02:01:35 -04:00
|
|
|
Taking a list of gems or updating all gems if no list is given.
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--local
|
|
|
|
Do not attempt to connect to rubygems.org. Instead, Bundler will
|
|
|
|
use the gems already present in Rubygems' cache or in ven-
|
|
|
|
dor/cache. Note that if a appropriate platform-specific gem
|
|
|
|
exists on rubygems.org it will not be found.
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--print
|
|
|
|
Prints the lockfile to STDOUT instead of writing to the file
|
2018-11-02 19:07:56 -04:00
|
|
|
system.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--lockfile=<path>
|
2018-11-02 19:07:56 -04:00
|
|
|
The path where the lockfile should be written to.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--full-index
|
2018-11-02 19:07:56 -04:00
|
|
|
Fall back to using the single-file index of all gems.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--add-platform
|
|
|
|
Add a new platform to the lockfile, re-resolving for the addi-
|
2018-11-02 19:07:56 -04:00
|
|
|
tion of that platform.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--remove-platform
|
2018-11-02 19:07:56 -04:00
|
|
|
Remove a platform from the lockfile.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--patch
|
2018-11-02 19:07:56 -04:00
|
|
|
If updating, prefer updating only to next patch version.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--minor
|
2018-11-02 19:07:56 -04:00
|
|
|
If updating, prefer updating only to next minor version.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--major
|
2018-11-02 19:07:56 -04:00
|
|
|
If updating, prefer updating to next major version (default).
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--strict
|
|
|
|
If updating, do not allow any gem to be updated past latest
|
2018-11-02 19:07:56 -04:00
|
|
|
--patch | --minor | --major.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
--conservative
|
2018-11-02 19:07:56 -04:00
|
|
|
If updating, use bundle install conservative update behavior and
|
|
|
|
do not allow shared dependencies to be updated.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
UPDATING ALL GEMS
|
|
|
|
If you run bundle lock with --update 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.
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
UPDATING A LIST OF GEMS
|
2018-11-02 19:07:56 -04:00
|
|
|
Sometimes, you want to update a single gem in the Gemfile(5), and leave
|
2019-04-14 02:01:35 -04:00
|
|
|
the rest of the gems that you specified locked to the versions in the
|
|
|
|
Gemfile.lock.
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
For instance, you only want to update nokogiri, run bundle lock
|
|
|
|
--update nokogiri.
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
Bundler will update nokogiri and any of its dependencies, but leave the
|
|
|
|
rest of the gems that you specified locked to the versions in the Gem-
|
|
|
|
file.lock.
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
SUPPORTING OTHER PLATFORMS
|
|
|
|
If you want your bundle to support platforms other than the one you're
|
|
|
|
running locally, you can run bundle lock --add-platform PLATFORM 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
|
2018-11-02 19:07:56 -04:00
|
|
|
that matches PLATFORM handy to install those platform-specific gems on.
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
For a full explanation of gem platforms, see gem help platform.
|
2018-11-02 19:07:56 -04:00
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
PATCH LEVEL OPTIONS
|
|
|
|
See bundle update(1) bundle-update.1.html for details.
|
2018-11-02 19:07:56 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
2019-04-14 02:01:35 -04:00
|
|
|
March 2019 BUNDLE-LOCK(1)
|