jnewland-san_juan 0.0.2

data/README.textile

@@ -0,0 +1,137 @@
+h2. Description
+
+Want "Capistrano":http://capify.org/ to talk to "God":http://god.rubyforge.org/? Find "San Juan":http://maps.google.com/maps?client=safari&ie=UTF8&oe=UTF-8&q=San+Juan+Capistrano,+CA,+USA&ll=33.495598,-117.665291&spn=0.020113,0.037851&t=h&z=15
+
+h2. Requirements
+
+* "God":http://god.rubyforge.org/
+* "Capistrano":http://capify.org/
+
+h2. Install
+
+<pre>
+<code>
+git clone git://github.com/jnewland/san_juan.git
+cd san_juan
+gem build san_juan.gemspec
+sudo gem install -l san_juan-*.gem
+</code>
+</pre>
+
+h2. Usage
+
+In your Capistrano deploy recipie:
+
+<pre>
+<code>
+require 'san_juan'
+
+role :app, 'foo.example.com'
+role :web, 'bar.example.com'
+
+san_juan.role :app, %w(mongrels memcached)
+san_juan.role :web, %w(nginx)
+</code>
+</pre>
+
+Now, check out @cap -T@:
+
+<pre>
+<code>
+  ...
+  cap god:all:quit                # Quit god, but not the processes it's monito...
+  cap god:all:reload              # Reloading God Config
+  cap god:all:start               # Start god
+  cap god:all:start_interactive   # Start god interactively
+  cap god:all:status              # Describe the status of the running tasks on...
+  cap god:all:terminate           # Terminate god and all monitored processes
+  cap god:app:memcached:log       # Log memcached
+  cap god:app:memcached:remove    # Remove memcached
+  cap god:app:memcached:restart   # Restart memcached
+  cap god:app:memcached:start     # Start memcached
+  cap god:app:memcached:stop      # Stop memcached
+  cap god:app:memcached:unmonitor # Unmonitor memcached
+  cap god:app:mongrels:log        # Log mongrels
+  cap god:app:mongrels:remove     # Remove mongrels
+  cap god:app:mongrels:restart    # Restart mongrels
+  cap god:app:mongrels:start      # Start mongrels
+  cap god:app:mongrels:stop       # Stop mongrels
+  cap god:app:mongrels:unmonitor  # Unmonitor mongrels
+  cap god:app:quit                # Quit god, but not the processes it's monito...
+  cap god:app:reload              # Reload the god config file
+  cap god:app:start               # Start god
+  cap god:app:start_interactive   # Start god interactively
+  cap god:app:terminate           # Terminate god and all monitored processes
+  cap god:web:nginx:log           # Log nginx
+  cap god:web:nginx:remove        # Remove nginx
+  cap god:web:nginx:restart       # Restart nginx
+  cap god:web:nginx:start         # Start nginx
+  cap god:web:nginx:stop          # Stop nginx
+  cap god:web:nginx:unmonitor     # Unmonitor nginx
+  cap god:web:quit                # Quit god, but not the processes it's monito...
+  cap god:web:reload              # Reload the god config file
+  cap god:web:start               # Start god
+  cap god:web:start_interactive   # Start god interactively
+  cap god:web:terminate           # Terminate god and all monitored processes
+  ...
+</pre>
+</code>
+
+To make capistrano start, stop, and restart your app using God, override the
+@deploy:start@, @deploy:stop@, and @deploy:restart@ tasks:
+
+<pre>
+<code>
+namespace :deploy do
+  desc "Use god to restart the app"
+  task :restart do
+    god.all.reload #ensures any changes to the god config are applied at deploy
+    god.app.mongrels.restart
+    # god.web.nginx.restart
+    # ...
+  end
+
+  desc "Use god to start the app"
+  task :start do
+    god.all.start
+  end
+
+  desc "Use god to stop the app"
+  task :stop do
+    god.all.terminate
+  end
+end
+</pre>
+</code>
+
+h2. Tweaks
+
+A few of the tasks in the @god:all@ namespace require the path to your god
+configuration file. This defaults to:
+
+@"#{current_path}/config/god/#{role}.god"@
+
+This can be changed by setting the @god_config_path@ capistrano variable:
+
+<pre>
+<code>
+require 'san_juan'
+
+set :god_config_path, "/path/to/config"
+
+role :app, 'foo.example.com'
+role :web, 'bar.example.com'
+
+san_juan.role :app, %w(mongrels memcached)
+san_juan.role :web, %w(nginx)
+
+</code>
+</pre>
+
+h2. Author
+
+"Jesse Newland":http://jnewland.com/
+
+h2. License
+
+"WTFPL":http://sam.zoy.org/wtfpl/

data/lib/san_juan.rb

@@ -0,0 +1,95 @@
+module SanJuan
+  @@roles = []
+
+  def roles
+    @@roles
+  end
+
+  def role(role, watches)
+    @@roles << role
+
+    namespace :god do
+
+      unless @meta_tasks_defined
+        namespace :all do
+          desc "Describe the status of the running tasks on each server"
+          task :status, :roles => san_juan.roles do
+            san_juan.roles.each { |role| send(role, :status) }
+          end
+
+          desc "Start god"
+          task :start do
+            san_juan.roles.each { |role| send(role, :start) }
+          end
+
+          desc "Reloading God Config"
+          task :reload do
+            san_juan.roles.each { |role| send(role, :reload) }
+          end
+
+          desc "Start god interactively"
+          task :start_interactive do
+            san_juan.roles.each { |role| send(role, :start_interactive) }
+          end
+
+          desc "Quit god, but not the processes it's monitoring"
+          task :quit do
+            san_juan.roles.each { |role| send(role, :quit) }
+          end
+
+          desc "Terminate god and all monitored processes"
+          task :terminate do
+            san_juan.roles.each { |role| send(role, :terminate) }
+          end
+        end
+      end
+      @meta_tasks_defined = true
+
+      namespace role do
+        desc "Start god"
+        task :start, :roles => role do
+          sudo "god -c #{san_juan.configuration_path(current_path, role)}"
+        end
+
+        desc "Start god interactively"
+        task :start_interactive, :roles => role do
+          sudo "god -c #{san_juan.configuration_path(current_path, role)} -D"
+        end
+
+        desc "Reload the god config file"
+        task :reload, :roles => role do
+          sudo "god load #{san_juan.configuration_path(current_path, role)}"
+        end
+
+        desc "Quit god, but not the processes it's monitoring"
+        task :quit, :roles => role do
+          sudo 'god quit'
+        end
+
+        desc "Terminate god and all monitored processes"
+        task :terminate, :roles => role do
+          sudo 'god terminate'
+        end
+
+        watches.each do |watch|
+          namespace watch do
+            %w(start restart stop unmonitor remove log).each do |command|
+              desc "#{command.capitalize} #{watch}"
+              task command, :roles => role do
+                sudo "god #{command} #{watch}"
+              end
+            end
+          end
+        end
+
+      end # end role namespace
+
+    end #end god namespace
+  end
+
+  def configuration_path(current_path, role)
+    fetch(:god_config_path, nil) || "#{current_path}/config/god/#{role}.god"
+  end
+
+end
+Capistrano.plugin :san_juan, SanJuan

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification 
+name: jnewland-san_juan
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Jesse Newland
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-05-20 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: god
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: capistrano
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Capistrano Recipies for God
+email: jnewland@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.textile
+files: 
+- lib/san_juan.rb
+- README.textile
+has_rdoc: false
+homepage: http://github.com/jnewland/san_juan
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Capistrano Recipies for God
+test_files: []
+