Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Capistrano integration for Unicorn!
branch: master

This branch is 4 commits ahead, 77 commits behind sosedoff:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
examples
lib
.gitignore
Gemfile
LICENSE
README.md
Rakefile
capistrano-unicorn.gemspec

README.md

Capistrano Unicorn

Capistrano plugin that integrates Unicorn tasks into capistrano deployment script.

Installation

Install library from rubygems:

gem install capistrano-unicorn

Usage

Setup

Add the library to your Gemfile:

group :development do
  gem 'capistrano-unicorn', :require => false
end

And load it into your deployment script config/deploy.rb:

require 'capistrano-unicorn'

Add unicorn restart task hook:

after 'deploy:restart', 'unicorn:reload' # app IS NOT preloaded
after 'deploy:restart', 'unicorn:restart'  # app preloaded

Create a new configuration file config/unicorn/unicorn.rb or config/unicorn/STAGE.rb, where stage is your deployment environment.

Example config - examples/rails3.rb. Please refer to unicorn documentation for more examples and configuration options.

Test

First, make sure you're running the latest release:

cap deploy

Then you can test each individual task:

cap unicorn:start
cap unicorn:stop
cap unicorn:reload

Configuration

You can modify any of the following options in your deploy.rb config.

  • unicorn_env - Set unicorn environment. Default to rails_env variable.
  • unicorn_pid - Set unicorn PID file path. Default to current_path/tmp/pids/unicorn.pid
  • unicorn_bin - Set unicorn executable file. Default to unicorn.
  • unicorn_bundle - Set bundler command for unicorn. Default to bundle.

If you are using capistrano multistage, please refer to Using capistrano unicorn with multistage environment.

Available Tasks

To get a list of all capistrano tasks, run cap -T:

cap unicorn:add_worker                # Add a new worker
cap unicorn:remove_worker             # Remove amount of workers
cap unicorn:reload                    # Reload Unicorn
cap unicorn:restart                   # Restart Unicorn
cap unicorn:shutdown                  # Immediately shutdown Unicorn
cap unicorn:start                     # Start Unicorn master process
cap unicorn:stop                      # Stop Unicorn

License

See LICENSE file for details.

Something went wrong with that request. Please try again.