Heroku Buildpack for Ruby

This is a Heroku Buildpack for Ruby, Rack, and Rails apps. It uses Bundler for dependency management.

This buildpack requires 64-bit Linux.

About this fork

This is a fork of Heroku's official Ruby buildpack, but it uses the Gemfile.next file instead of Gemfile to install gems. The official buildpack does not support the use of the BUNDLE_GEMFILE environment variable.

This is useful for setups that use dual-boot:

• the official buildpack can be used to run the application using the gems in the Gemfile file
• this fork can be used to run the application using the gems in the Gemfile.next file

Usage

Ruby

Example Usage:

$ ls
Gemfile.next Gemfile.next.lock

$ heroku create --buildpack heroku/ruby

$ git push heroku main
...
-----> Heroku receiving push
-----> Fetching custom buildpack
-----> Ruby app detected
-----> Installing dependencies using Bundler version 1.1.rc
       Running: bundle install --without development:test --path vendor/bundle --deployment
       Fetching gem metadata from http://rubygems.org/..
       Installing rack (1.3.5)
       Using bundler (1.1.rc)
       Your bundle is complete! It was installed into ./vendor/bundle
       Cleaning up the bundler cache.
-----> Discovering process types
       Procfile declares types -> (none)
       Default types for Ruby  -> console, rake

The buildpack will detect your app as Ruby if it has a Gemfile.next and Gemfile.next.lock files in the root directory. It will then proceed to run bundle install after setting up the appropriate environment for ruby and Bundler.

Documentation

For more information about using Ruby and buildpacks on Heroku, see these Dev Center articles:

• Heroku Ruby Support
• Getting Started with Ruby on Heroku
• Getting Started with Rails 7 on Heroku
• Buildpacks
• Buildpack API

Hacking

To use this buildpack, fork it on Github. Push up changes to your fork, then create a test app with --buildpack <your-github-url> and push to it.

Testing

$ bundle exec hatchet install

$ bundle exec rake spec