san_juan 0.0.4

data/README.textile

@@ -0,0 +1,136 @@
+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>
+gem install jnewland-san_juan
+OR
+gem install jnewland-san_juan -s http://gems.github.com
+</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 proce...
+  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 ...
+  cap god:all:terminate                              # Terminate god and all monit...
+  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: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:quit                                   # Quit god, but not the proce...
+  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 monit...
+  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 proce...
+  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 monit...
+  ...
+</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,100 @@
+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 do
+            san_juan.roles.each { |role| send(role).send(:status) }
+          end
+
+          desc "Start god"
+          task :start do
+            san_juan.roles.each { |role| send(role).send(:start) }
+          end
+
+          desc "Reloading God Config"
+          task :reload do
+            san_juan.roles.each { |role| send(role).send(:reload) }
+          end
+
+          desc "Start god interactively"
+          task :start_interactive do
+            san_juan.roles.each { |role| send(role).send(:start_interactive) }
+          end
+
+          desc "Quit god, but not the processes it's monitoring"
+          task :quit do
+            san_juan.roles.each { |role| send(role).send(:quit) }
+          end
+
+          desc "Terminate god and all monitored processes"
+          task :terminate do
+            san_juan.roles.each { |role| send(role).send(: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
+
+        desc "Describe the status of the running tasks"
+        task :status, :roles => role do
+          sudo 'god status'
+        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,65 @@
+--- !ruby/object:Gem::Specification 
+name: san_juan
+version: !ruby/object:Gem::Version 
+  version: 0.0.4
+platform: ruby
+authors: 
+- Jesse Newland
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-05-20 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: capistrano
+  type: :runtime
+  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: true
+homepage: http://github.com/jnewland/san_juan
+licenses: []
+
+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.3.5
+signing_key: 
+specification_version: 2
+summary: Capistrano Recipies for God
+test_files: []
+