Heroploy

A few helpful rake tasks to manage deploying Rails apps to development, staging and production Heroku servers.

Installation

Add this line to your application's Gemfile:

gem 'heroploy'

And then execute:

$ bundle

Or install it yourself as:

$ gem install heroploy

Usage

Add a heroploy.yml file to your application's config directory which describes the Heroku apps you will deploy to, and the checks you would like when deploying to each.

If you're running Rails, you can use this generator to add an example config file:

rails generate heroploy:install

Here's an example heroploy.yml file:

environments:
  development:
    app: my-development-app

  staging:
    app: my-staging-app
    checks:
      pushed: true
      branch: master

  production:
    app: my-production-app
    tag: 'RELEASE_%Y%m%dT%H%M%S%z'
    checks:
      pushed: true
      branch: master
      staged: true

This file:

• Describes development, staging and production deployment rules for three Heroku apps (named my-development-app, my-staging-app and my-production-app on Heroku).
• Allows any branch to be pushed directly to development.
• Only allows master to be pushed to staging, and requires all changes to have first been pushed to origin.
• Only allows deployment to production if the changes have first been staged on staging.

To deploy to one of these environments, run rake heroploy:<environment>:deploy. For example:

rake heroploy:production:deploy

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request