heroku_deploy

This gem is an easy way to quickly setup and deploy staging and production branches and environments for your project on heroku.

###Installation Instructions Install the gem: sudo gem install heroku_deploy

In environment.rb config.gem "heroku_deploy"

or in your Gemfile gem "heroku_deploy" gem "heroku"

In your Rakefile: begin require 'heroku_deploy' HerokuDeploy::Tasks.new( :staging_app => "example-app-staging", :production_app => "example-app") rescue LoadError puts "heroku_deploy (or a dependency) not available. Install it with: gem install heroku_deploy" end

###Setup and Deploy heroku_deploy assumes that origin/master is your main development branch. It also assumes your heroku credentials are saved in ~/.heroku/credentials Once you have that in place, run:

rake heroku_deploy:setup

This creates two additional branches: staging and production. These branches hold your deploys. It also creates the two heroku apps specified in your Rakefile.

Next, deploy to your staging app:

rake heroku_deploy:staging

Once you've vetted your app at http://example-app-staging.heroku.com, deploy to production:

rake heroku_deploy:production

It's easy!

Doing a deploy will automatically backup and download your code and database in a heroku bundle. To back up without deploying, run:

rake heroku_deploy:backup:staging

or

rake heroku_deploy:backup:production

To skip the backup when deploying to staging or production run set backup=false:

rake heroku_deploy:staging backup=false

To skip maintenance mode set maintenance=false:

rake heroku_deploy:production maintenance=false

You can also define before and after hooks either in your environment or an intializer or pretty much anywhere that gets loaded:

class HerokuDeploy

  def before_staging_deploy
    `rake asset:packager:build_all`
  end

  def after_production_deploy
    `script/move_latest_backup_to_nas`
  end

end

###Coming Soon

• Rails 3 compatibility
• Prompts for credentials if you haven't entered them
• No need to include gem "heroku" in your Gemfile
• Better error messages if you're trying to create an existing heroku app