h1. Capistrano plugins, recipes and templates

h1. → 'capitate'


h2. What

Capistrano plugins, recipes and templates.

h2. Installing

<pre syntax="ruby">sudo gem install capitate</pre>

Create a Capfile (in your project):

<pre syntax="ruby">capitate</pre>

Create and set a profile in you Capfile:

<pre syntax="ruby"># load "config/deployment/centos-sick.rb"</pre>

<em>See profiles section below for more info</em>


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. Profiles

Profiles are capfiles which store lists of recipes to run for cap install and deploy and settings for those recipes.

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

TODO: More on profiles...


h3. Install recipes

To install a group of applications based on a profile (see Profiles section below):

  cap install

<em>You may need to comment out "Defaults requiretty" in /etc/sudoders on the image before capistrano recipes will work.</em>

  
h3. Deploying (application)

If this is the first time you've deployed you'll need to run:

  cap deploy:setup

Otherwise, your standard deploy options:
  
  cap deploy

  cap deploy:migrations (deploys and does migration)
  
  cap deploy:migrate (only does migration on existing deployment)



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/var/svn/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