Capistrano is old and busted, right? Time to move on? WRONG! Caplets makes capistrano the new hotness once again. It bring capistrano into the future with all your favorite goodies: git, bundler, unicorn, and more.
WARNING: Caplets has evolved out of Mint Digital's real-world deployments of many large Rails/Rack applications. Although we have tried to keep it as generic and customizable as possible, it is still very opinionated. That is to say, it is largely tailored to how we like to deploy applications. If caplets is missing something important to you, submit an issue or fork away.
$ gem install caplets
# config/deploy.rb
require 'caplets'
load 'caplets/memcached'
load 'caplets/whenever'
# etc...
Caplets depends heavily on capistrano's concept of server roles to apply tasks only to the servers that require them. Most often, your sever definitions will look like this:
server 'app1.mintdigital.com',
:app, :memcached, :sphinx, :assets,
:primary => true
Caplets is a series of load
able capistrano extensions. This given you
maximum flexibility in your deployments without having to remember to
set/unset loads of capistrano variables. Only the tasks you need get run.
See the MODULES file for descriptions of all the available modules, along with what tasks they add and what variables they use.
The one module you will always get, even if you just require
caplets/basic
is caplets/deploy
. This file is the heart of caplets; it
sets up the essentials of what caplets considers a modern deployment.
The biggest change to the standard capistrano setup is that we use git to manage releases. Let me say that again as it's important:
** Instead of using subdirectories and symlinks to manage releases, caplets uses git.**
That means:
- You will not have
releases
orshared
directories. - Your code will be directly inside your
:deploy_to
directory. :current_path
,:current_release
,:release_path
,:latest_release
, and:shared_path
will all be the same.- Rollbacks still work, through the power of
git reset
- "shared" files are really just files written to your project root but not under git version control -- no symlinks needed.
Here are a few other changes that caplets/deploy
makes:
:use_sudo
is false by default:rails_env
is replaced with:environment
, which caplets expects you to set in your deploy file.:user
and:group
default todeploy
:shared_children
is not used. Use:required_children
instead.- The standard
deploy
task is disabled. Usedeploy:quick
to do andeploy:update
+deploy:reload
. Loadcaplets/db
for caplets' replacementdeploy:migrations
task. - Capistrano's built-in
deploy:web:enable
anddeploy:web:disable
are disabled. Loadcaplets/web
for caplets' replacements.
Requiring caplets
gets you the most common modules in one go. If you don't
want them all, you can always require caplets/basic
instead.
# config/deploy.rb
require 'caplets'
# Equivalent to...
require 'caplets/basic'
load 'caplets/bundle'
load 'caplets/db'
load 'caplets/logs'
load 'caplets/web'
load 'caplets/yaml'