capitate 0.1.9 → 0.2.1

data/docs/recipes/mongrel_cluster.txt

@@ -0,0 +1,40 @@
+h1. mongrel_cluster
+
+ "home":../index.html > "recipes":index.html >  mongrel_cluster  
+
+
+h2. Namespaces
+
+* "mongrel_cluster:centos":mongrel_cluster-centos.html (1) 
+
+
+h2. Tasks
+
+* "mongrel_cluster:setup_monit":#mongrel_cluster:setup_monit 
+
+
+h2. Task documentation
+
+h3(#mongrel_cluster:setup_monit). mongrel_cluster:setup_monit
+
+Create monit configuration for 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@
+  
+*mongrel_config_script*: Config script to load with mongrel. _Defaults to nil_
+
+@set :mongrel_config_script, "config/mongrel_handler.rb"@
+  
+*monit_conf_dir*: Destination for monitrc. _Defaults to "/etc/monit"_
+
+@set :monit_conf_dir, "/etc/monit"@
+
+
+

data/docs/recipes/monit-centos.txt

@@ -0,0 +1,32 @@
+h1. monit:centos
+
+ "home":../index.html > "recipes":index.html >  "monit":monit.html  >  centos  
+
+
+h2. Tasks
+
+* "monit:centos:install":#monit:centos:install 
+
+
+h2. Task documentation
+
+h3(#monit:centos:install). monit:centos:install
+
+Install monit.
+
+*monit_build_options*: Monit build options.
+
+*monit_port*: Monit port. _Defaults to 2812_
+
+@set :monit_port, 2812@
+
+*monit_password*: Monit password. _Defaults to password prompt_
+
+@set :monit_password, prompt.password('Monit admin password (to set): ')@
+
+*monit_conf_dir*: Directory for monitrc files.
+
+@set :monit_conf_dir, "/etc/monit"@
+
+
+

data/docs/recipes/monit.txt

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

data/docs/recipes/mysql-centos.txt

@@ -0,0 +1,22 @@
+h1. mysql:centos
+
+ "home":../index.html > "recipes":index.html >  "mysql":mysql.html  >  centos  
+
+
+h2. Tasks
+
+* "mysql:centos:install":#mysql:centos:install 
+
+
+h2. Task documentation
+
+h3(#mysql:centos:install). mysql:centos:install
+
+Install mysql.
+
+*mysql_admin_password_set*: Mysql admin password (to set). _Defaults to password prompt._
+
+<pre>set :mysql_admin_password_set, prompt.password('Mysql admin password (to set): ')</pre>
+
+
+

data/docs/recipes/mysql.txt

@@ -0,0 +1,58 @@
+h1. mysql
+
+ "home":../index.html > "recipes":index.html >  mysql  
+
+
+h2. Namespaces
+
+* "mysql:centos":mysql-centos.html (1) 
+
+
+h2. Tasks
+
+* "mysql:install_monit":#mysql:install_monit 
+* "mysql:setup":#mysql:setup 
+
+
+h2. Task documentation
+
+h3(#mysql:install_monit). mysql:install_monit
+
+Install mysql monit hooks.
+
+*db_port*: Mysql port. _Defaults to 3306_
+
+*mysql_pid_path*: Path to mysql pid file. _Defaults to /var/run/mysqld/mysqld.pid_
+
+@set :mysql_pid_path, "/var/run/mysqld/mysqld.pid"@
+
+*monit_conf_dir*: Destination for monitrc. _Defaults to "/etc/monit"_
+
+@set :monit_conf_dir, "/etc/monit"@
+
+
+
+h3(#mysql:setup). mysql:setup
+
+Create database, database user, and set grant permissions.
+
+*db_name*: Database name (application).
+
+*db_user*: Database user (application).
+  
+*db_pass*: Database password (application).
+
+*grant_locations*: Grant locations. _Defaults to localhost_
+
+@set :grant_locations, [ "localhost", "192.168.1.111" ]@
+
+*grant_priv_type*: Grant privilege types. _Defaults to ALL_
+
+@set :grant_priv_type, "ALL"@
+
+*mysql_admin_password*: Mysql admin password (to use to connect). Defaults to password prompt.
+
+@set :mysql_admin_password, prompt.password('Mysql admin password: '))@
+
+
+

data/docs/recipes/nginx-centos.txt

@@ -0,0 +1,43 @@
+h1. nginx:centos
+
+ "home":../index.html > "recipes":index.html >  "nginx":nginx.html  >  centos  
+
+
+h2. Tasks
+
+* "nginx:centos:install":#nginx:centos:install 
+* "nginx:centos:restart":#nginx:centos:restart 
+
+
+h2. Task documentation
+
+h3(#nginx:centos:install). nginx:centos:install
+
+Install nginx, conf, initscript, nginx user and service.
+
+*nginx_build_options*: Nginx build options.
+
+*nginx_bin_path*: Nginx sbin path. _Defaults to /sbin/nginx_
+
+@set :nginx_bin_path, "/sbin/nginx"@
+
+*nginx_conf_path*: Path to nginx conf. _Defaults to /etc/nginx/nginx.conf_
+
+@set :nginx_conf_path, "/etc/nginx/nginx.conf"@
+
+*nginx_pid_path*: Path to nginx pid file. _Defaults to /var/run/nginx.pid_
+
+@set :nginx_pid_path, "/var/run/nginx.pid"@
+
+*nginx_prefix_path*: Nginx install prefix. _Defaults to /var/nginx_
+
+@set :nginx_prefix_path, "/var/nginx"@
+
+
+
+h3(#nginx:centos:restart). nginx:centos:restart
+
+Restart nginx (service)
+
+
+

data/docs/recipes/nginx.txt

@@ -0,0 +1,51 @@
+h1. nginx
+
+ "home":../index.html > "recipes":index.html >  nginx  
+
+
+h2. Namespaces
+
+* "nginx:centos":nginx-centos.html (2) 
+
+
+h2. Tasks
+
+* "nginx:install_monit":#nginx:install_monit 
+* "nginx:setup_mongrel":#nginx:setup_mongrel 
+
+
+h2. Task documentation
+
+h3(#nginx:install_monit). nginx:install_monit
+
+Install nginx monit hooks.
+
+*nginx_pid_path*: Path to nginx pid file. _Defaults to /var/run/nginx.pid_
+
+@set :nginx_pid_path, "/var/run/nginx.pid"@
+
+*monit_conf_dir*: Destination for monitrc. _Defaults to "/etc/monit"_
+
+@set :monit_conf_dir, "/etc/monit"@
+
+
+
+h3(#nginx:setup_mongrel). nginx:setup_mongrel
+
+Create and update the nginx vhost include.
+
+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
+
+domain_name: Domain name for nginx virtual host, (without www prefix).    
+
+  set :domain_name, "foo.com"
+
+
+

data/docs/recipes/rails.txt

@@ -0,0 +1,58 @@
+h1. rails
+
+ "home":../index.html > "recipes":index.html >  rails  
+
+
+h2. Tasks
+
+* "rails:console":#rails:console 
+* "rails:mate_logs":#rails:mate_logs 
+* "rails:setup":#rails:setup 
+* "rails:tail_logs":#rails:tail_logs 
+* "rails:update_code":#rails:update_code 
+
+
+h2. Task documentation
+
+h3(#rails:console). rails:console
+
+Remotely console. (http://errtheblog.com/posts/19-streaming-capistrano)
+
+
+
+h3(#rails:mate_logs). rails:mate_logs
+
+Check production log files in TextMate.  (http://errtheblog.com/posts/19-streaming-capistrano)
+
+
+
+h3(#rails:setup). rails:setup
+
+Create database yaml in shared path.
+
+*db_name*: Database name (rails).    
+
+@set :db_name, "app_db_name"@
+
+*db_user*: Database user (rails).    
+
+@set :db_user, "app_db_user"@
+  
+*db_pass*: Database password (rails).    
+
+@set :db_pass, "the_password"@
+
+
+
+h3(#rails:tail_logs). rails:tail_logs
+
+Tail production log files. (http://errtheblog.com/posts/19-streaming-capistrano)
+
+
+
+h3(#rails:update_code). rails:update_code
+
+Make symlink for database yaml
+
+
+

data/docs/recipes/ruby-centos.txt

@@ -0,0 +1,22 @@
+h1. ruby:centos
+
+ "home":../index.html > "recipes":index.html >  "ruby":ruby.html  >  centos  
+
+
+h2. Tasks
+
+* "ruby:centos:install":#ruby:centos:install 
+
+
+h2. Task documentation
+
+h3(#ruby:centos:install). ruby:centos:install
+
+Install ruby and rubygems.
+
+*ruby_build_options*: Ruby build options.
+
+*rubygems_build_options*: Rubygems build options.
+
+
+

data/docs/recipes/ruby.txt

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

data/docs/recipes/sphinx-centos.txt

@@ -0,0 +1,35 @@
+h1. sphinx:centos
+
+ "home":../index.html > "recipes":index.html >  "sphinx":sphinx.html  >  centos  
+
+
+h2. Tasks
+
+* "sphinx:centos:install":#sphinx:centos:install 
+* "sphinx:centos:setup":#sphinx:centos:setup 
+
+
+h2. Task documentation
+
+h3(#sphinx:centos:install). sphinx:centos:install
+
+Install sphinx.
+
+*sphinx_build_options*: Sphinx build options.
+
+*sphinx_prefix*: Sphinx install prefix. _Defaults to "/usr/local/sphinx"_
+
+
+
+h3(#sphinx:centos:setup). sphinx:centos:setup
+
+Setup sphinx for application.
+
+*sphinx_prefix*: Sphinx install prefix. _Defaults to "/usr/local/sphinx"_
+
+*sphinx_pid_path*: Directory to sphinx pid. _Defaults to "[shared_path]/pids/searchd.pid"_
+
+*sphinx_conf_path*: Path to sphinx.conf. _Defaults to "[shared_path]/config/sphinx.conf"_
+
+
+

data/docs/recipes/sphinx.txt

@@ -0,0 +1,89 @@
+h1. sphinx
+
+ "home":../index.html > "recipes":index.html >  sphinx  
+
+
+h2. Namespaces
+
+* "sphinx:centos":sphinx-centos.html (2) 
+
+
+h2. Tasks
+
+* "sphinx:index_all":#sphinx:index_all 
+* "sphinx:restart":#sphinx:restart 
+* "sphinx:rotate_all":#sphinx:rotate_all 
+* "sphinx:setup_monit":#sphinx:setup_monit 
+* "sphinx:update_conf":#sphinx:update_conf 
+
+
+h2. Task documentation
+
+h3(#sphinx:index_all). sphinx:index_all
+
+Build sphinx indexes for application.
+
+*sphinx_prefix*: Location to sphinx install. _Defaults to nil_
+
+*sphinx_conf*: Location to sphinx conf. _Defaults to "[shared_path]/config/sphinx.conf"_
+
+
+
+h3(#sphinx:restart). sphinx:restart
+
+Restart sphinx
+
+
+
+h3(#sphinx:rotate_all). sphinx:rotate_all
+
+Rotate sphinx index for application.
+
+*sphinx_prefix*: Location to sphinx install. _Defaults to nil_
+
+*sphinx_conf*: Location to sphinx conf. _Defaults to "[shared_path]/config/sphinx.conf"_
+
+
+
+h3(#sphinx:setup_monit). sphinx:setup_monit
+
+Create monit configuration for sphinx.
+
+*monit_conf_dir*: Destination for monitrc. _Defaults to "/etc/monit"_
+
+*sphinx_pid_path*: Location for sphinx pid. _Defaults to "[shared_path]/pids/searchd.pid"_
+
+
+
+h3(#sphinx:update_conf). sphinx:update_conf
+
+Update sphinx for application.
+
+*sphinx_conf_template*: Path to sphinx.conf.erb. _Defaults to "config/templates/sphinx.conf.erb"_
+
+*sphinx_conf_path*: Path to sphinx.conf. _Defaults to "[shared_path]/config/sphinx.conf"_
+
+*sphinx_port*: Sphinx port. _Defaults to 3312_
+
+*sphinx_conf_root*: Directory for sphinx configuration, like stopwords.txt. _Defaults to [current_path]/config_
+
+*sphinx_index_root*: Directory for sphinx indexes. _Defaults to "[shared_path]/var/index"_
+
+*sphinx_log_root*: Directory for sphinx logs. _Defaults to "[shared_path]/log"_
+
+*sphinx_pid_root*: Directory for sphinx pids. _Defaults to "[shared_path]/pids"_
+
+
+*sphinx_db_user*: Sphinx DB user. _Defaults to db_user_
+
+*sphinx_db_pass*: Sphinx DB password. _Defaults to db_pass_
+
+*sphinx_db_name*: Sphinx DB name. _Defaults to db_name_
+
+
+*sphinx_db_host*: Sphinx DB host. _Defaults to location for primary :db role_
+
+*sphinx_host*: Sphinx DB host. _Defaults to location for :search role_
+
+
+

data/lib/capitate/cap_ext/run_via.rb

@@ -0,0 +1,14 @@
+module Capitate::CapExt::RunVia
+  
+  # Invoke command with current run_method setting.
+  #
+  # ==== Options
+  # +cmd+:: Command to run
+  # +options+:: Options (see invoke_command options)
+  #
+  def run_via(cmd, options = {}, &block)    
+    options[:via] = fetch(:run_method, :sudo) unless options.has_key?(:via)
+    invoke_command(cmd, options, &block)
+  end
+  
+end

data/lib/capitate/plugins/gem.rb

@@ -14,12 +14,11 @@ module Capitate::Plugins::Gem
     gems = [ gems ] unless gems.is_a?(Array)
     
     # Install one at a time because we may need to pass install args (e.g. mysql)
-    # TODO: Fix this
     gems.each do |gem|
-      sudo "gem install --no-rdoc --no-ri --no-verbose #{gem}"
+      run_via "gem install --no-rdoc --no-ri --no-verbose #{gem}"
     end
   end
   
 end
 
-Capistrano.plugin :gemc, Capitate::Plugins::Gem
+Capistrano.plugin :gems, Capitate::Plugins::Gem

data/lib/capitate/plugins/prompt.rb

@@ -0,0 +1,24 @@
+
+module Capitate::Plugins::Prompt
+  
+  def ask(label, &block)
+    Capistrano::CLI.ui.ask(label, &block)
+  end
+  
+  def password(label, verify = false)
+    # Lazy
+    Proc.new { 
+      password = Capistrano::CLI.password_prompt(label)
+    
+      if verify
+        password_verify = Capistrano::CLI.password_prompt("[Verify] #{label}")
+        raise "Passwords do not match" if password != password_verify
+      end
+    
+      password
+    }
+  end
+  
+end
+
+Capistrano.plugin :prompt, Capitate::Plugins::Prompt

data/lib/capitate/plugins/script.rb

@@ -16,9 +16,12 @@ module Capitate::Plugins::Script
   def make_install(name, options)
     install(name, options) do |dir|
       configure_options = options[:configure_options] || ""
-      sudo "echo 'Configuring #{name}...' && cd #{dir} && ./configure #{configure_options} > configure.log"
-      sudo "echo 'Compiling #{name}...' && cd #{dir} && make > make.log"
-      sudo "echo 'Installing #{name}...' && cd #{dir} && make install > make_install.log"        
+      
+      run_all <<-CMDS
+        echo 'Configuring #{name}...' && cd #{dir} && ./configure #{configure_options} > configure.log
+        echo 'Compiling #{name}...' && cd #{dir} && make > make.log
+        echo 'Installing #{name}...' && cd #{dir} && make install > make_install.log
+      CMDS
     end
   end
   
@@ -62,21 +65,18 @@ module Capitate::Plugins::Script
         
     if File.extname(script) == ".erb"
       name = script[0...script.length-4]
-      dest = "/tmp/#{name}"
-      run "mkdir -p #{File.dirname(dest)}"
+      dest = "/tmp/cap/#{name}"
+      run_via "mkdir -p #{File.dirname(dest)}"
       put template.load(script, override_binding || binding), dest
     else
       name = script
-      dest = "/tmp/#{name}"
-      run "mkdir -p #{File.dirname(dest)}"
+      dest = "/tmp/cap/#{name}"
+      run_via "mkdir -p #{File.dirname(dest)}"
       put template.load(script), dest
     end
     
     # If want verbose, -v
-    sudo "sh -v #{dest}"
-    
-    # Cleanup
-    sudo "rm -rf #{File.dirname(dest)}"    
+    run_via "sh -v #{dest} && rm -rf #{File.dirname(dest)}"
   end
   
   # Download and unpack URL.
@@ -103,16 +103,30 @@ module Capitate::Plugins::Script
     
     unpack_dir ||= file.gsub(/\.tar\.gz|\.tgz/, "")
     
-    sudo "echo 'Getting #{url}...' && mkdir -p #{dest} && cd #{dest} && wget -nv #{url}"
-    sudo "echo 'Unpacking...' && cd #{dest} && tar zxf #{file}"
+    run_all <<-CMDS
+      echo 'Getting #{url}...' && mkdir -p #{dest} && cd #{dest} && wget -nv #{url}
+      echo 'Unpacking...' && cd #{dest} && tar zxf #{file}
+    CMDS
     
     if block_given?
       yield("#{dest}/#{unpack_dir}")
-      sudo "rm -f #{dest}/#{file}"
-      sudo "rm -rf #{dest}" if clean
+      run_via "rm -f #{dest}/#{file}"
+      run_via "rm -rf #{dest}" if clean
     end
   end
   
+  # Run all commands (separated by newlines)
+  #
+  # ==== Options
+  # +cmds+:: Commands (separated by newlines)
+  # +options+:: See invoke_command options
+  #
+  def run_all(cmds, options = {}, &block)
+    cmds.split("\n").each do |cmd|
+      run_via(cmd, options, &block)
+    end    
+  end
+  
 end
 
 Capistrano.plugin :script, Capitate::Plugins::Script