Contents

# 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:

    rake heroku_deploy:staging backup=false

###Coming Soon
* 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
* Before and after hooks that allow you to arbitrarily execute code before and after deploy

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
heroku_deploy-0.1.10	README.markdown
heroku_deploy-0.1.9	README.markdown
heroku_deploy-0.1.8	README.markdown