A Cloud Foundry buildpack for Ruby based apps.
Official buildpack documentation can be found at Ruby buildpack docs.
To build this buildpack, run the following commands from the buildpack's directory:
-
Source the .envrc file in the buildpack directory.
source .envrc
To simplify the process in the future, install direnv which will automatically source .envrc when you change directories.
-
Install buildpack-packager
go install github.com/cloudfoundry/libbuildpack/packager/buildpack-packager
-
Build the buildpack
buildpack-packager build [ --cached ]
-
Use in Cloud Foundry
Upload the buildpack to your Cloud Foundry and optionally specify it by name
cf create-buildpack [BUILDPACK_NAME] [BUILDPACK_ZIP_FILE_PATH] 1 cf push my_app [-b BUILDPACK_NAME]
Buildpacks use the Cutlass framework for running integration tests against Cloud Foundry. Before running the integration tests, you need to login to your Cloud Foundry using the cf cli:
cf login -a https://api.your-cf.com -u [email protected] -p pa55woRD
Note that your user requires permissions to run cf create-buildpack
and cf update-buildpack
. To run the integration tests, run the following commands from the buildpack's directory:
-
Source the .envrc file in the buildpack directory.
source .envrc
To simplify the process in the future, install direnv which will automatically source .envrc when you change directories.
-
Run unit tests
./scripts/unit.sh
-
Run integration tests
./scripts/integration.sh
More information can be found on Github cutlass.
Find our guidelines here.
Join the #buildpacks channel in our Slack community if you need any further assistance.
Please fill out the issue template fully if you'd like to start an issue for the buildpack.
The project backlog is on Pivotal Tracker.
Inspired by the Heroku buildpack.