Katana

Manage multiple environments on Heroku with ease!

This project was greatly inspired by Capistrano and Heroku San.

Add the following to your Gemfile.

group :development do
  gem "katana"
end

and run

bundle install

You do not need to include the Heroku gem (it gets included as a dependency).

gem install katana

To use Katana with an existing or future Heroku app, run:

kat init your-app-name

This will create a file in config/katana.yml.

You can run any Heroku command through Katana. Simply prefix the command with the environment. For instance:

heroku rake db:migrate

becomes

kat staging rake db:migrate

to run it on staging, and

kat production rake db:migrate

to run it on production.

Katana provides extra, Capistrano-like commands to make deployments easier.

kat staging deploy:setup

Initializes a git repo (if necessary), removes the "heroku" remote, creates a remote for the environment specified, and runs config:update and stack:update (see below for details).

kat staging deploy

Pushes the master branch to Heroku, runs your migrations, and restarts the app.

kat staging config:update

Runs config:add with all the vars listed in your configuration file.

kat staging stack:update

Runs stack:migrate with the stack listed in your configuration file.

If you have suggestions or find a bug, create an issue at the top of the page. We also accept pull requests for those feeling adventurous...