h1. → 'capitate'

h2. What

Capistrano plugins, recipes and templates.

h2. Installing

<pre>sudo gem install capitate</pre>


h2. Running

Add capitate to your Capfile. Copy this somewhere near the top:

<pre syntax="ruby">require 'capitate'  
require 'capitate/recipes'
set :project_root, File.dirname(__FILE__)
</pre>


h2. The basics

Capitate has recipes for:

* Installing applications, via package manager or manually building with make.
* Common deployment setup and update_code tasks, such as symlinking in database.yml and more advanced recipes such as sphinx configuration.
* ERB templates for application configuration files, init scripts, monit configuration, etc.
* And more...


h3. Beefing up your deploy

For an example deploy, see "centos-sick.rb":http://svn.ducktyper.com/capitate/trunk/lib/profiles/centos-sick.rb

You could copy this profile into config/deployment/ and add it to your Capfile:

  load "config/deployment/centos-sick.rb"



h3. Use recipes

"View recipes documentation":recipes/index.html

For example, to script the install of a group of applications as root, use "recipes:run":recipes/recipes.html:

Configure your Capfile to run it:

<pre syntax="ruby">
set :recipes_run, [ "ruby:centos:install", "memcached:centos:install" ]
set :recipes_user, "root"
</pre>

Then run:

  cap recipes:run

This is just a basic example.

h2. Forum

"http://groups.google.com/group/capitate":http://groups.google.com/group/capitate

h2. How to submit patches

Read the "8 steps for fixing other people's code":http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/ and for section "8b: Submit patch to Google Groups":http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/#8b-google-groups, use the Google Group above.

The trunk repository is <code>http://svn.ducktyper.com/capitate/trunk</code> for anonymous access.

h2. License

This code is free to use under the terms of the MIT license. 

h2. Contact

Comments are welcome. Send an email to "Gabriel Handford":mailto:gabrielh@gmail.com via the "forum":http://groups.google.com/group/capitate