1BUNDLE-CACHE(1)                                                BUNDLE-CACHE(1)
2
3
4

NAME

6       bundle-cache - Package your needed .gem files into your application
7

SYNOPSIS

9       bundle cache
10
11       alias: package, pack
12

DESCRIPTION

14       Copy  all of the .gem files needed to run the application into the ven‐
15       dor/cache  directory.  In  the  future,  when   running   [bundle   in‐
16       stall(1)][bundle-install],  use  the gems in the cache in preference to
17       the ones on rubygems.org.
18

GIT AND PATH GEMS

20       The bundle cache command can also package :git and  :path  dependencies
21       besides  .gem  files. This needs to be explicitly enabled via the --all
22       option. Once used, the --all option will be remembered.
23

SUPPORT FOR MULTIPLE PLATFORMS

25       When using gems that have different packages for  different  platforms,
26       Bundler  supports caching of gems for other platforms where the Gemfile
27       has been resolved (i.e. present in the lockfile) in vendor/cache.  This
28       needs  to  be enabled via the --all-platforms option. This setting will
29       be remembered in your local bundler configuration.
30

REMOTE FETCHING

32       By default, if you run bundle install(1)](bundle-install.1.html)  after
33       running bundle cache(1) bundle-cache.1.html, bundler will still connect
34       to rubygems.org to check whether a platform-specific gem exists for any
35       of the gems in vendor/cache.
36
37       For instance, consider this Gemfile(5):
38
39
40
41           source "https://rubygems.org"
42
43           gem "nokogiri"
44
45
46
47       If you run bundle cache under C Ruby, bundler will retrieve the version
48       of nokogiri for the "ruby" platform. If you deploy  to  JRuby  and  run
49       bundle  install,  bundler  is  forced  to check to see whether a "java"
50       platformed nokogiri exists.
51
52       Even though the nokogiri gem for the Ruby platform is  technically  ac‐
53       ceptable  on JRuby, it has a C extension that does not run on JRuby. As
54       a result, bundler will, by default, still connect  to  rubygems.org  to
55       check  whether  it  has  a version of one of your gems more specific to
56       your platform.
57
58       This problem is also not limited to  the  "java"  platform.  A  similar
59       (common) problem can happen when developing on Windows and deploying to
60       Linux, or even when developing on OSX and deploying to Linux.
61
62       If you know for sure that the gems packaged in vendor/cache are  appro‐
63       priate  for the platform you are on, you can run bundle install --local
64       to skip checking for more appropriate gems, and use the  ones  in  ven‐
65       dor/cache.
66
67       One  way  to be sure that you have the right platformed versions of all
68       your gems is to run bundle cache on an identical machine and  check  in
69       the  gems. For instance, you can run bundle cache on an identical stag‐
70       ing box during your staging process, and check in the vendor/cache  be‐
71       fore deploying to production.
72
73       By  default,  bundle  cache(1) bundle-cache.1.html fetches and also in‐
74       stalls the gems to the default location. To package the dependencies to
75       vendor/cache without installing them to the local install location, you
76       can run bundle cache --no-install.
77

HISTORY

79       In Bundler 2.1, cache took in the functionalities of  package  and  now
80       package and pack are aliases of cache.
81
82
83
84                                 October 2022                  BUNDLE-CACHE(1)
Impressum