A Cloud Foundry buildpack for Ruby based apps.
This is based on the [Heroku buildpack] (https://github.com/heroku/heroku-buildpack-ruby).
Additional information can be found at CloudFoundry.org.
This buildpack will be used if your app has a Gemfile
and Gemfile.lock
in the root directory. It will then use Bundler to install your dependencies.
cf push my_app -b https://github.com/cloudfoundry/ruby-buildpack.git
To use this buildpack on Cloud Foundry, where the Cloud Foundry instance limits some or all internet activity, please read the Disconnected Environments documentation.
As stated in the Disconnected Environments documentation, your application must 'vendor' it's dependencies.
For the Ruby buildpack, use bundler:
cd <your app dir>
bundle package --all
cf push
uploads your vendored dependencies. The buildpack will compile any dependencies requiring compilation while staging your application.
The buildpack only supports the two most stable patches for each dependency in the manifest.yml.
- Make sure you have fetched submodules
git submodule update --init
- Get latest buildpack dependencies
BUNDLE_GEMFILE=cf.Gemfile bundle
- Build the buildpack
BUNDLE_GEMFILE=cf.Gemfile bundle exec buildpack-packager [ uncached | cached ]
-
Use in Cloud Foundry
Upload the buildpack to your Cloud Foundry and optionally specify it by name
cf create-buildpack custom_ruby_buildpack ruby_buildpack-cached-custom.zip 1 cf push my_app -b custom_ruby_buildpack
If you would like to build the buildpack with previously supported dependency versions, provide the --use-custom-manifest=manifest-including-unsupported.yml
option to buildpack-packager
.
Find our guidelines here.
Open an issue on this project
The project backlog is on Pivotal Tracker