capitate 0.1.9 → 0.2.1

data/Capfile

@@ -11,6 +11,7 @@ require 'lib/capitate/recipes'
 
 require 'erb'
 
-
-set :recipes_run, [ "centos:setup_for_web", "packages:install", "ruby:centos:install" ]
 set :user, "root"
+
+# For testing
+load "lib/deployment/install-centos-rubyweb.rb"

data/History.txt

@@ -1,3 +1,9 @@
+== 0.2.1 2008-02-24
+
+* Removing all my brain dead recipes.
+* Added build options for install tasks.
+* Updating documentation
+
 == 0.1.9 2008-02-23
 
 * Adding config_script to mongrel_cluster recipe

data/Manifest.txt

@@ -7,25 +7,47 @@ Rakefile
 bin/capitate
 config/hoe.rb
 config/requirements.rb
+docs/nginx.README
+docs/recipes/centos.txt
+docs/recipes/deploy-pending.txt
+docs/recipes/deploy-web.txt
+docs/recipes/deploy.txt
+docs/recipes/docs.txt
+docs/recipes/imagemagick-centos.txt
+docs/recipes/imagemagick.txt
+docs/recipes/index.txt
+docs/recipes/memcached-centos.txt
+docs/recipes/memcached.txt
+docs/recipes/mongrel_cluster-centos.txt
+docs/recipes/mongrel_cluster.txt
+docs/recipes/monit-centos.txt
+docs/recipes/monit.txt
+docs/recipes/mysql-centos.txt
+docs/recipes/mysql.txt
+docs/recipes/nginx-centos.txt
+docs/recipes/nginx.txt
+docs/recipes/rails.txt
+docs/recipes/ruby-centos.txt
+docs/recipes/ruby.txt
+docs/recipes/sphinx-centos.txt
+docs/recipes/sphinx.txt
 lib/capitate.rb
 lib/capitate/cap_ext/connections.rb
 lib/capitate/cap_ext/extension_proxy.rb
+lib/capitate/cap_ext/run_via.rb
 lib/capitate/cap_ext/variables.rb
 lib/capitate/plugins/base.rb
 lib/capitate/plugins/gem.rb
-lib/capitate/plugins/package.rb
-lib/capitate/plugins/profiles.rb
+lib/capitate/plugins/prompt.rb
 lib/capitate/plugins/script.rb
 lib/capitate/plugins/templates.rb
 lib/capitate/plugins/upload.rb
-lib/capitate/plugins/wget.rb
 lib/capitate/plugins/yum.rb
 lib/capitate/recipes.rb
 lib/capitate/task_node.rb
 lib/capitate/version.rb
-lib/profiles/centos-sick.rb
-lib/recipes/README
-lib/recipes/centos/README
+lib/deployment/deploy.rb
+lib/deployment/install-centos-rubyweb.rb
 lib/recipes/centos/centos.rb
 lib/recipes/centos/imagemagick.rb
 lib/recipes/centos/memcached.rb
@@ -37,18 +59,13 @@ lib/recipes/centos/ruby.rb
 lib/recipes/centos/sphinx.rb
 lib/recipes/deploy.rb
 lib/recipes/docs.rb
-lib/recipes/gems.rb
 lib/recipes/memcached.rb
 lib/recipes/mongrel_cluster.rb
 lib/recipes/mysql.rb
 lib/recipes/nginx.rb
-lib/recipes/packages.rb
 lib/recipes/rails.rb
-lib/recipes/recipes.rb
 lib/recipes/sphinx.rb
 lib/templates/capistrano/Capfile
-lib/templates/centos/setup_for_web.sh
-lib/templates/centos/sudoers
 lib/templates/memcached/memcached.initd.centos.erb
 lib/templates/memcached/memcached.monitrc.erb
 lib/templates/mongrel/mongrel_cluster.initd.erb

data/bin/capitate

@@ -1,78 +1,30 @@
 #!/usr/bin/env ruby
 
-require 'optparse'
-
-OptionParser.new do |opts|
-  opts.banner = "Usage: #{File.basename($0)} [path]"
-
-  opts.on("-h", "--help", "Displays this help info") do
-    puts opts
-    exit 0
-  end
-
-  begin
-    opts.parse!(ARGV)
-  rescue OptionParser::ParseError => e
-    warn e.message
-    puts opts
-    exit 1
-  end
-end
-
 begin
   require 'capitate'
 rescue LoadError
   require 'rubygems'
-  require 'capitate'
+  require 'capitate'  
 end
 
+require 'capistrano/cli'
 
-class CapitateBin
-  class << self
-    include Capitate::Plugins::Templates    
-  end
-end
+cli = Capistrano::CLI.new(ARGV)
+cli.parse_options!
 
-if ARGV.empty?
-  abort "Please specify the directory to capify, e.g. `#{File.basename($0)} .'"
-elsif !File.exists?(ARGV.first)
-  abort "`#{ARGV.first}' does not exist."
-elsif !File.directory?(ARGV.first)
-  abort "`#{ARGV.first}' is not a directory."
-elsif ARGV.length > 1
-  abort "Too many arguments; please specify only the directory to capitate."
-end
-
-base = ARGV.shift
-
-puts <<-EOS
+config = cli.instantiate_configuration
+config.logger.level = cli.options[:verbose]
 
-  Generating capistrano configuration...
+cli.set_pre_vars(config)
+cli.load_recipes(config)
 
-EOS
-
-files = { "Capfile" => "capistrano/Capfile" }
-
-files.each do |file, template|
-  file = File.join(base, file)
-  if File.exists?(file)
-    warn "`#{file}' already exists"
-  elsif File.exists?(file.downcase)
-    warn "`#{file.downcase}' exists, which could conflict with `#{file}'"
-  elsif !File.exists?(File.dirname(file))
-    warn "Directory `#{File.dirname(file)}' does not exist"
-  else
-    # Write Capfile
-    CapitateBin.write(template, file)
-  end
+config.load do 
+  require 'capitate/recipes'
 end
 
-puts <<-EOS
-
-  You now need to create and set you deployment "profile" in the Capfile.
-  This is currently a manual process, see the documentation on profiles 
-  for more information.
+config.trigger(:load)
+cli.execute_requested_actions(config)
+config.trigger(:exit)
 
-EOS
 
 

data/config/hoe.rb

@@ -55,7 +55,7 @@ hoe = Hoe.new(GEM_NAME, VERS) do |p|
   p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
   p.test_globs = ["test/**/test_*.rb"]
   p.clean_globs |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']  #An array of file patterns to delete on clean.
-  p.clean_globs += ['website/recipes/**', 'docs/recipes/**']
+  p.clean_globs += ['website/recipes/**']
   
   # == Optional
   p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
@@ -69,4 +69,4 @@ end
 CHANGES = hoe.paragraphs_of('History.txt', 0..1).join("\\n\\n")
 PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "#{RUBYFORGE_PROJECT}/#{GEM_NAME}"
 hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')
-hoe.rsync_args = '-av --delete --ignore-errors'
+hoe.rsync_args = '-av --delete --ignore-errors'

data/docs/nginx.README

@@ -0,0 +1,12 @@
+=== Nginx + mongrel
+http://brainspl.at/articles/2006/08/23/nginx-my-new-favorite-front-end-for-mongrel-cluster
+http://brainspl.at/articles/2007/01/03/new-nginx-conf-with-optimizations
+http://topfunky.net/svn/shovel/nginx
+
+=== Nginx + memcached:
+http://www.igvita.com/2008/02/11/nginx-and-memcached-a-400-boost/
+http://blog.kovyrin.net/2007/08/05/using-nginx-ssi-and-memcache-to-make-your-web-applications-faster/
+
+=== Nginx
+http://robsanheim.com/2008/02/07/beware-the-default-nginx-config-old-ie6-hates-gzip/
+http://brainspl.at/articles/2007/11/09/a-fair-proxy-balancer-for-nginx-and-mongrel

data/docs/recipes/centos.txt

@@ -0,0 +1,33 @@
+h1. centos
+
+ "home":../index.html > "recipes":index.html >  centos  
+
+
+h2. Tasks
+
+* "centos:add_user":#centos:add_user 
+
+
+h2. Task documentation
+
+h3(#centos:add_user). centos:add_user
+
+Add user and set user password for application. Adds user to specified groups. 
+
+*user*: User to add.
+
+@set :user, "app_user"@
+*groups*: Groups for user to be in. _Defaults to none_
+
+@set :groups, "admin,foo"@
+
+*home*: Home directory for user. _Defaults to <tt>:deploy_to</tt> setting_
+
+@set :home, "/var/www/apps/app_name"@
+
+*home_readable*: Whether home permissions are readable by all. Needed if using deploy dir as home. _Defaults to true_
+
+@set :home_readable, true@
+
+
+

data/docs/recipes/deploy-pending.txt

@@ -0,0 +1,25 @@
+h1. deploy:pending
+
+ "home":../index.html > "recipes":index.html >  "deploy":deploy.html  >  pending  
+
+
+h2. Tasks
+
+* "deploy:pending":#deploy:pending 
+* "deploy:pending:diff":#deploy:pending:diff 
+
+
+h2. Task documentation
+
+h3(#deploy:pending). deploy:pending
+
+Displays the commits since your last deploy. This is good for a summary       of the changes that have occurred since the last deploy. Note that this       might not be supported on all SCM's.
+
+
+
+h3(#deploy:pending:diff). deploy:pending:diff
+
+Displays the `diff' since your last deploy. This is useful if you want       to examine what changes are about to be deployed. Note that this might       not be supported on all SCM's.
+
+
+

data/docs/recipes/deploy-web.txt

@@ -0,0 +1,33 @@
+h1. deploy:web
+
+ "home":../index.html > "recipes":index.html >  "deploy":deploy.html  >  web  
+
+
+h2. Tasks
+
+* "deploy:web:disable":#deploy:web:disable 
+* "deploy:web:enable":#deploy:web:enable 
+
+
+h2. Task documentation
+
+h3(#deploy:web:disable). deploy:web:disable
+
+Present a maintenance page to visitors. Disables your application's web       interface by writing a "maintenance.html" file to each web server. The       servers must be configured to detect the presence of this file, and if       it is present, always display it instead of performing the request.
+
+By default, the maintenance page will just say the site is down for       "maintenance", and will be back "shortly", but you can customize the       page by specifying the REASON and UNTIL environment variables:
+
+  $ cap deploy:web:disable \
+        REASON="hardware upgrade" \
+        UNTIL="12pm Central Time"
+
+Further customization will require that you write your own task.
+
+
+
+h3(#deploy:web:enable). deploy:web:enable
+
+Makes the application web-accessible again. Removes the       "maintenance.html" page generated by deploy:web:disable, which (if your       web servers are configured correctly) will make your application       web-accessible again.
+
+
+

data/docs/recipes/deploy.txt

@@ -0,0 +1,159 @@
+h1. deploy
+
+ "home":../index.html > "recipes":index.html >  deploy  
+
+
+h2. Namespaces
+
+* "deploy:pending":deploy-pending.html (2) 
+* "deploy:web":deploy-web.html (2) 
+
+
+h2. Tasks
+
+* "deploy":#deploy 
+* "deploy:check":#deploy:check 
+* "deploy:cleanup":#deploy:cleanup 
+* "deploy:cold":#deploy:cold 
+* "deploy:finalize_update":#deploy:finalize_update 
+* "deploy:migrate":#deploy:migrate 
+* "deploy:migrations":#deploy:migrations 
+* "deploy:restart":#deploy:restart 
+* "deploy:rollback":#deploy:rollback 
+* "deploy:rollback_code":#deploy:rollback_code 
+* "deploy:setup":#deploy:setup 
+* "deploy:start":#deploy:start 
+* "deploy:stop":#deploy:stop 
+* "deploy:symlink":#deploy:symlink 
+* "deploy:update":#deploy:update 
+* "deploy:update_code":#deploy:update_code 
+* "deploy:upload":#deploy:upload 
+
+
+h2. Task documentation
+
+h3(#deploy). deploy
+
+Deploys your project. This calls both `update' and `restart'. Note that     this will generally only work for applications that have already been deployed     once. For a "cold" deploy, you'll want to take a look at the `deploy:cold'     task, which handles the cold start specifically.
+
+
+
+h3(#deploy:check). deploy:check
+
+Test deployment dependencies. Checks things like directory permissions,     necessary utilities, and so forth, reporting on the things that appear to     be incorrect or missing. This is good for making sure a deploy has a     chance of working before you actually run `cap deploy'.
+
+You can define your own dependencies, as well, using the `depend' method:
+
+  depend :remote, :gem, "tzinfo", ">=0.3.3"
+  depend :local, :command, "svn"
+  depend :remote, :directory, "/u/depot/files"
+
+
+
+h3(#deploy:cleanup). deploy:cleanup
+
+Clean up old releases. By default, the last 5 releases are kept on each     server (though you can change this with the keep_releases variable). All     other deployed revisions are removed from the servers. By default, this     will use sudo to clean up the old releases, but if sudo is not available     for your environment, set the :use_sudo variable to false instead.
+
+
+
+h3(#deploy:cold). deploy:cold
+
+Deploys and starts a `cold' application. This is useful if you have not     deployed your application before, or if your application is (for some     other reason) not currently running. It will deploy the code, run any     pending migrations, and then instead of invoking `deploy:restart', it will     invoke `deploy:start' to fire up the application servers.
+
+
+
+h3(#deploy:finalize_update). deploy:finalize_update
+
+[internal] Touches up the released code. This is called by update_code     after the basic deploy finishes. It assumes a Rails project was deployed,     so if you are deploying something else, you may want to override this     task with your own environment's requirements.
+
+This task will make the release group-writable (if the :group_writable     variable is set to true, which is the default). It will then set up     symlinks to the shared directory for the log, system, and tmp/pids     directories, and will lastly touch all assets in public/images,     public/stylesheets, and public/javascripts so that the times are     consistent (so that asset timestamping works).
+
+
+
+h3(#deploy:migrate). deploy:migrate
+
+Run the migrate rake task. By default, it runs this in most recently     deployed version of the app. However, you can specify a different release     via the migrate_target variable, which must be one of :latest (for the     default behavior), or :current (for the release indicated by the     `current' symlink). Strings will work for those values instead of symbols,     too. You can also specify additional environment variables to pass to rake     via the migrate_env variable. Finally, you can specify the full path to the     rake executable by setting the rake variable. The defaults are:
+
+  set :rake,           "rake"
+  set :rails_env,      "production"
+  set :migrate_env,    ""
+  set :migrate_target, :latest
+
+
+
+h3(#deploy:migrations). deploy:migrations
+
+Deploy and run pending migrations. This will work similarly to the     `deploy' task, but will also run any pending migrations (via the     `deploy:migrate' task) prior to updating the symlink. Note that the     update in this case it is not atomic, and transactions are not used,     because migrations are not guaranteed to be reversible.
+
+
+
+h3(#deploy:restart). deploy:restart
+
+
+
+
+
+h3(#deploy:rollback). deploy:rollback
+
+Rolls back to a previous version and restarts. This is handy if you ever     discover that you've deployed a lemon; `cap rollback' and you're right     back where you were, on the previously deployed version.
+
+
+
+h3(#deploy:rollback_code). deploy:rollback_code
+
+Rolls back to the previously deployed version. The `current' symlink will     be updated to point at the previously deployed version, and then the     current release will be removed from the servers. You'll generally want     to call `rollback' instead, as it performs a `restart' as well.
+
+
+
+h3(#deploy:setup). deploy:setup
+
+Prepares one or more servers for deployment. Before you can use any     of the Capistrano deployment tasks with your project, you will need to     make sure all of your servers have been prepared with `cap setup'. When     you add a new server to your cluster, you can easily run the setup task     on just that server by specifying the HOSTS environment variable:
+
+  $ cap HOSTS=new.server.com setup
+
+It is safe to run this task on servers that have already been set up; it     will not destroy any deployed revisions or data.
+
+
+
+h3(#deploy:start). deploy:start
+
+
+
+
+
+h3(#deploy:stop). deploy:stop
+
+
+
+
+
+h3(#deploy:symlink). deploy:symlink
+
+Updates the symlink to the most recently deployed version. Capistrano works     by putting each new release of your application in its own directory. When     you deploy a new version, this task's job is to update the `current' symlink     to point at the new version. You will rarely need to call this task     directly; instead, use the `deploy' task (which performs a complete     deploy, including `restart') or the 'update' task (which does everything     except `restart').
+
+
+
+h3(#deploy:update). deploy:update
+
+Copies your project and updates the symlink. It does this in a     transaction, so that if either `update_code' or `symlink' fail, all     changes made to the remote servers will be rolled back, leaving your     system in the same state it was in before `update' was invoked. Usually,     you will want to call `deploy' instead of `update', but `update' can be     handy if you want to deploy, but not immediately restart your application.
+
+
+
+h3(#deploy:update_code). deploy:update_code
+
+Copies your project to the remote servers. This is the first stage     of any deployment; moving your updated code and assets to the deployment     servers. You will rarely call this task directly, however; instead, you     should call the `deploy' task (to do a complete deploy) or the `update'     task (if you want to perform the `restart' task separately).
+
+You will need to make sure you set the :scm variable to the source     control software you are using (it defaults to :subversion), and the     :deploy_via variable to the strategy you want to use to deploy (it     defaults to :checkout).
+
+
+
+h3(#deploy:upload). deploy:upload
+
+Copy files to the currently deployed version. This is useful for updating     files piecemeal, such as when you need to quickly deploy only a single     file. Some files, such as updated templates, images, or stylesheets,     might not require a full deploy, and especially in emergency situations     it can be handy to just push the updates to production, quickly.
+
+To use this task, specify the files and directories you want to copy as a     comma-delimited list in the FILES environment variable. All directories     will be processed recursively, with all files being pushed to the     deployment servers. Any file or directory starting with a '.' character     will be ignored.
+
+  $ cap deploy:upload FILES=templates,controller.rb
+
+
+

data/docs/recipes/docs.txt

@@ -0,0 +1,26 @@
+h1. docs
+
+ "home":../index.html > "recipes":index.html >  docs  
+
+
+h2. Tasks
+
+* "docs:recipes":#docs:recipes 
+
+
+h2. Task documentation
+
+h3(#docs:recipes). docs:recipes
+
+Generate documentation for all currently loaded recipes. Assumes textile formatting.
+
+*docs_recipes_dir*: Destination directory. _Defaults to "docs/recipes"_
+
+@set :docs_recipes_dir, "docs/recipes"@
+   
+*docs_recipes_clear*: Whether to clear destination before generating.
+
+@set :docs_recipes_clear, true@
+
+
+

data/docs/recipes/imagemagick-centos.txt

@@ -0,0 +1,20 @@
+h1. imagemagick:centos
+
+ "home":../index.html > "recipes":index.html >  "imagemagick":imagemagick.html  >  centos  
+
+
+h2. Tasks
+
+* "imagemagick:centos:install":#imagemagick:centos:install 
+
+
+h2. Task documentation
+
+h3(#imagemagick:centos:install). imagemagick:centos:install
+
+Install imagemagick.
+
+*imagemagick_build_options*: Imagemagick build options.
+
+
+

data/docs/recipes/imagemagick.txt

@@ -0,0 +1,8 @@
+h1. imagemagick
+
+ "home":../index.html > "recipes":index.html >  imagemagick  
+
+
+h2. Namespaces
+
+* "imagemagick:centos":imagemagick-centos.html (1) 

data/docs/recipes/index.txt

@@ -0,0 +1,26 @@
+h1. Recipes
+
+ "home":../index.html > "recipes":index.html >  
+
+
+h2. Namespaces
+
+* "centos":centos.html (1) 
+* "deploy":deploy.html (17) 
+* "deploy:pending":deploy-pending.html (2) 
+* "deploy:web":deploy-web.html (2) 
+* "docs":docs.html (1) 
+* "imagemagick:centos":imagemagick-centos.html (1) 
+* "memcached":memcached.html (1) 
+* "memcached:centos":memcached-centos.html (1) 
+* "mongrel_cluster":mongrel_cluster.html (1) 
+* "mongrel_cluster:centos":mongrel_cluster-centos.html (1) 
+* "monit:centos":monit-centos.html (1) 
+* "mysql":mysql.html (2) 
+* "mysql:centos":mysql-centos.html (1) 
+* "nginx":nginx.html (2) 
+* "nginx:centos":nginx-centos.html (2) 
+* "rails":rails.html (5) 
+* "ruby:centos":ruby-centos.html (1) 
+* "sphinx":sphinx.html (5) 
+* "sphinx:centos":sphinx-centos.html (2) 

data/docs/recipes/memcached-centos.txt

@@ -0,0 +1,32 @@
+h1. memcached:centos
+
+ "home":../index.html > "recipes":index.html >  "memcached":memcached.html  >  centos  
+
+
+h2. Tasks
+
+* "memcached:centos:install":#memcached:centos:install 
+
+
+h2. Task documentation
+
+h3(#memcached:centos:install). memcached:centos:install
+
+Install memcached.
+
+*memcached_build_options*: Memcached build options.
+
+*memcached_memory*: Memcached memory (in MB).
+
+@set :memcached_memory, 64@
+
+*memcached_pid_path*: Path to memcached pid file. Defaults to /var/run/memcached.pid
+
+@set :memcached_pid_path, "/var/run/memcached.pid"@
+
+*memcached_port*: Memcached port. Defaults to 11211.
+
+@set :memcached_port, 11211@
+
+
+

data/docs/recipes/memcached.txt

@@ -0,0 +1,35 @@
+h1. memcached
+
+ "home":../index.html > "recipes":index.html >  memcached  
+
+
+h2. Namespaces
+
+* "memcached:centos":memcached-centos.html (1) 
+
+
+h2. Tasks
+
+* "memcached:install_monit":#memcached:install_monit 
+
+
+h2. Task documentation
+
+h3(#memcached:install_monit). memcached:install_monit
+
+Generate and install memcached monitrc.
+
+*memcached_pid_path*: Path to memcached pid file. _Defaults to /var/run/memcached.pid_
+
+@set :memcached_pid_path, "/var/run/memcached.pid"@
+
+*memcached_port*: Memcached port. _Defaults to 11211_   
+
+@set :memcached_port, 11211@
+   
+*monit_conf_dir*: Destination for monitrc. _Defaults to "/etc/monit"_
+
+@set :monit_conf_dir, "/etc/monit"@
+
+
+

data/docs/recipes/mongrel_cluster-centos.txt

@@ -0,0 +1,27 @@
+h1. mongrel_cluster:centos
+
+ "home":../index.html > "recipes":index.html >  "mongrel_cluster":mongrel_cluster.html  >  centos  
+
+
+h2. Tasks
+
+* "mongrel_cluster:centos:setup":#mongrel_cluster:centos:setup 
+
+
+h2. Task documentation
+
+h3(#mongrel_cluster:centos:setup). mongrel_cluster:centos:setup
+
+Create mongrel cluster.
+
+*mongrel_size*: Number of mongrels.
+
+@set :mongrel_size, 3@
+
+*mongrel_port*: Starting port for mongrels. If there are 3 mongrels with port 9000, 
+then instances will be at 9000, 9001, and 9002
+  
+@set :mongrel_port, 9000@
+
+
+