Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cloudfoundry/ruby-buildpack
Cloud Foundry buildpack for Ruby, Sinatra and Rails
https://github.com/cloudfoundry/ruby-buildpack
v2b
Last synced: 1 day ago
JSON representation
Cloud Foundry buildpack for Ruby, Sinatra and Rails
- Host: GitHub
- URL: https://github.com/cloudfoundry/ruby-buildpack
- Owner: cloudfoundry
- License: apache-2.0
- Created: 2013-01-24T19:22:06.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2024-10-03T18:23:31.000Z (about 1 month ago)
- Last Synced: 2024-11-01T17:39:47.714Z (16 days ago)
- Topics: v2b
- Language: Go
- Homepage: http://docs.cloudfoundry.org/buildpacks/
- Size: 69.3 MB
- Stars: 65
- Watchers: 75
- Forks: 160
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-ibmcloud - ruby-buildpack - Cloud Foundry buildpack for Ruby, Sinatra and Rails. (Platform)
README
# Cloud Foundry Ruby Buildpack
[ Join us on Slack](https://cloudfoundry.slack.com/messages/buildpacks/)
A Cloud Foundry [buildpack](http://docs.cloudfoundry.org/buildpacks/) for Ruby based apps.
### Buildpack User Documentation
Official buildpack documentation can be found at [Ruby buildpack docs](http://docs.cloudfoundry.org/buildpacks/ruby/index.html).
### Building the Buildpack
To build this buildpack, run the following commands from the buildpack's directory:
1. Source the .envrc file in the buildpack directory.
```bash
source .envrc
```
To simplify the process in the future, install [direnv](https://direnv.net/) which will automatically source `.envrc` when you change directories.
1. Install buildpack-packager
```bash
go install github.com/cloudfoundry/libbuildpack/packager/buildpack-packager@master
```
1. Build the buildpack
```bash
buildpack-packager build [ --cached ]
```
1. Use in Cloud Foundry
Upload the buildpack to your Cloud Foundry and optionally specify it by name
```bash
cf create-buildpack [BUILDPACK_NAME] [BUILDPACK_ZIP_FILE_PATH] 1
cf push my_app [-b BUILDPACK_NAME]
```
### Testing
Buildpacks use the [Cutlass](https://github.com/cloudfoundry/libbuildpack/tree/master/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](https://github.com/cloudfoundry/cli):
```bash
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:
1. Source the .envrc file in the buildpack directory.
```bash
source .envrc
```
To simplify the process in the future, install [direnv](https://direnv.net/) which will automatically source .envrc when you change directories.
1. Run unit tests
```bash
./scripts/unit.sh
```
1. Run integration tests
```bash
./scripts/integration.sh
```
More information can be found on Github [cutlass](https://github.com/cloudfoundry/libbuildpack/cutlass).
### Contributing
Find our guidelines [here](./CONTRIBUTING.md).
### Help and Support
Join the #buildpacks channel in our [Slack community](http://slack.cloudfoundry.org/) if you need any further assistance.
### Reporting Issues
Please fill out the issue template fully if you'd like to start an issue for the buildpack.
### Active Development
The project backlog is on [Pivotal Tracker](https://www.pivotaltracker.com/projects/1042066).
### Acknowledgements
Inspired by the [Heroku buildpack](https://github.com/heroku/heroku-buildpack-ruby).