engineyard-eycap 0.3.3

data/History.txt

@@ -0,0 +1,84 @@
+== HEAD / 0000-00-00
+  * rake install_gem_no_doc for faster install
+
+== 0.3.3 / 2008-05-07
+  * add ey_logger to log deploys to server
+
+== 0.3.2 / 2008-04-29
+  * adding db:clone_to_local task to take a dump on the slice, fetch it, and load it into your dev db on your workstation
+  * only clone from replica database
+  * remove call to variable in task desc
+  * fix ferret symlinking
+  * gemspec for github
+
+== 0.3.1 / 2008-03-17
+  * Make the custom maintenance pages actually work!
+
+== 0.3.0 / 2008-03-05
+  * Adding custom maintenance pages is now as easy as copying a custom html file to #{shared_path}/system/maintenance.html.custom
+
+== 0.2.10 / 2008-03-02
+  * Symlink memcached.yml only on :memcached => true, except :no_release => true
+
+== 0.2.9 / 2008-02-27
+  * Fix a bug with ultrasphinx:configure running on multiple hosts
+
+== 0.2.8 / 2008-02-20
+  * Add tasks for solr starting,stopping, and log tailing.
+  * Add monit namespace and make appservers php/merb compatible
+  * Make ultrasphinx symlinking a little smarter
+  * Add tomcat tasks for spongecell
+
+== 0.2.6 / 2008-02-14
+  * Make mongrel restarts only apply to mongrel slices
+
+== 0.2.5 / 2008-02-11
+  * Added db cloning task
+
+== 0.2.4 / 2008-02-06
+  * Symlink memcached.yml in on deploy if you enable the callback
+
+== 0.2.3 / 2008-02-01
+  * Make log tailing environmentally aware.  Also add tasks to tail mongrel logs
+
+== 0.2.2 / 2008-01-25
+  * sphinx:configure ultrasphinx configuration task
+
+== 0.2.1 / 2008-01-25
+  * override default deploy recipe start/stop tasks
+
+== 0.2.0 / 2008-01-23
+  * sphinx:symlink ultrasphinx configuration directory
+
+== 0.1.9 / 2008-01-21
+  * Correct memcached tasks.
+
+== 0.1.8 / 2008-01-20
+  * Add memcached tasks
+
+== 0.1.7 / 2008-01-19
+  * fix symlink_configs task
+
+== 0.1.6 / 2008-01-19
+  * add restart tasks for backgroundrb
+
+== 0.1.5 / 2008-01-18
+  * fixed bug in filtered_remote_cache that prevented a changed checkout URL from taking over the cache
+
+== 0.1.4 / 2008-01-17
+  * added sphinx:[reindex|start|stop|restart] matches only app servers with :sphinx => true
+
+== 0.1.3 / 2008-01-17
+  * filtered_remote_cache to removes the cached copy of the source URL changed
+
+== 0.1.2 / 2008-01-15
+  * added filtered_remote_cache capistrano deployment strategy
+
+== 0.1.1 / 2008-01-15
+  * removed database tasks until problem with 'defer' is solved
+
+== 0.1.0 / 2008-01-14
+  * Bugfix for empty :application variable
+
+== 0.0.1 / 2008-01-14
+  * Initial release

data/Manifest.txt

@@ -0,0 +1,25 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/capistrano/recipes/deploy/strategy/filtered_remote_cache.rb
+lib/eycap.rb
+lib/eycap/lib/ey_logger.rb
+lib/eycap/lib/ey_logger_hooks.rb
+lib/eycap/recipes.rb
+lib/eycap/recipes/backgroundrb.rb
+lib/eycap/recipes/database.rb
+lib/eycap/recipes/deploy.rb
+lib/eycap/recipes/ferret.rb
+lib/eycap/recipes/juggernaut.rb
+lib/eycap/recipes/memcached.rb
+lib/eycap/recipes/mongrel.rb
+lib/eycap/recipes/monit.rb
+lib/eycap/recipes/nginx.rb
+lib/eycap/recipes/slice.rb
+lib/eycap/recipes/solr.rb
+lib/eycap/recipes/sphinx.rb
+lib/eycap/recipes/templates/maintenance.rhtml
+lib/eycap/recipes/tomcat.rb
+test/test_eycap.rb
+test/test_helper.rb

data/README.txt

@@ -0,0 +1,63 @@
+= eycap
+
+== DESCRIPTION:
+
+Engine Yard capistrano tasks for use specifically with Engine Yard slices. They include convenience methods for managed a database, mongrel, nginx or other services.
+
+Also included is a deployment strategy, :filtered_remote_cache, which speeds up deployment like :remote_cache, but filters out .svn directory which are a security risk and write slowly to shared disks.
+
+== REQUIREMENTS:
+
+* capistrano (http://capify.org) > 2.0.0, but recommended with > 2.2.0
+
+== INSTALL:
+
+  $ gem sources -a http://gems.github.com/ (you only need to do this once)
+  $ gem install engineyard-eycap
+
+== SOURCE:
+ 
+eycaps git repo is available on GitHub, which can be browsed at:
+ 
+  http://github.com/engineyard/eycap
+   
+and cloned from:
+   
+  git://github.com/engineyard/eycap.git
+
+== USAGE:
+
+= Include in capistrano
+
+In your deploy.rb, simply include this line at the top:
+
+require 'eycap/recipes'
+
+= Filtered remote cache
+
+To use filtered_remote_cache, simply:
+
+set :deploy_via, :filtered_remote_cache
+
+== LICENSE:
+
+Copyright (c) 2008 Engine Yard
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,33 @@
+require 'rubygems'
+require 'hoe'
+require './lib/eycap'
+
+Hoe.new('eycap', Eycap::VERSION) do |p|
+  p.author = 'Engine Yard'
+  p.email = 'tech@engineyard.com'
+  p.summary = 'Capistrano tasks for Engine Yard slices'
+  p.description = 'A bunch of useful recipes to help deployment to Engine Yard slices'
+  p.url = 'http://eycap.rubyforge.org'
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.extra_deps << ['capistrano', '>= 2.2.0']
+end
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -r ./lib/eycap.rb"
+end
+
+task :coverage do
+  system("rm -fr coverage")
+  system("rcov test/test_*.rb")
+  system("open coverage/index.html")
+end
+
+desc "Upload site to Rubyforge"
+task :site do
+end
+
+desc 'Install the package as a gem.'
+task :install_gem_no_doc => [:clean, :package] do
+  sh "#{'sudo ' unless Hoe::WINDOZE}gem install --local --no-rdoc --no-ri pkg/*.gem"
+end

data/lib/capistrano/recipes/deploy/strategy/filtered_remote_cache.rb

@@ -0,0 +1,48 @@
+require 'capistrano/recipes/deploy/strategy/remote'
+
+module Capistrano
+  module Deploy
+    module Strategy
+
+      # Implements the deployment strategy that keeps a cached checkout of
+      # the source code on each remote server. Each deploy simply updates the
+      # cached checkout, and then filters a copy through tar to remove unwanted .svn directories,
+      # finally leaving a pristeen, export-like copy at the destination.
+      class FilteredRemoteCache < Remote
+        # Executes the SCM command for this strategy and writes the REVISION
+        # mark file to each host.
+        def deploy!
+          update_repository_cache
+          tar_copy_repository_cache
+        end
+
+        def check!
+          super.check do |d|
+            d.remote.writable(shared_path)
+          end
+        end
+
+        private
+
+          def repository_cache
+            configuration[:repository_cache] || "/var/cache/engineyard/#{configuration[:application]}"
+          end
+
+          def update_repository_cache
+            logger.trace "checking if the cached copy URL matches this deploy, then updating it"
+            command = "if [ -d #{repository_cache} ] && ! [ `svn info #{repository_cache} | grep URL | awk '{print $2}'` = '#{configuration[:repository]}'  ]; then " + 
+              "rm -rf #{repository_cache} && #{source.checkout(revision, repository_cache)}; " + 
+              "elif [ -d #{repository_cache} ]; then #{source.sync(revision, repository_cache)}; " +
+              "else #{source.checkout(revision, repository_cache)}; fi"
+            scm_run(command)
+          end
+
+          def tar_copy_repository_cache
+            logger.trace "copying and filtering .svn via tar from cached version to #{configuration[:release_path]}"
+            run "mkdir #{configuration[:release_path]} && tar c --exclude=#{configuration[:filter_spec] || ".svn"} -C #{repository_cache} . | tar xC #{configuration[:release_path]} && #{mark}"
+          end
+      end
+
+    end
+  end
+end

data/lib/eycap/lib/ey_logger.rb

@@ -0,0 +1,124 @@
+require 'tmpdir'
+module Capistrano
+  
+  class Logger  
+    
+    def ey_log(level, message, line_prefix = nil)
+      EYLogger.log(level, message, line_prefix) if EYLogger.setup?
+      log_without_ey_logging(level, message, line_prefix)
+    end
+    
+    unless method_defined?(:log_without_ey_logging)
+      alias_method :log_without_ey_logging, :log 
+      alias_method :log, :ey_log
+    end
+    
+    def close
+      device.close if @needs_close
+      EYLogger.close if EYLogger.setup?
+    end
+  end
+  
+  class EYLogger
+    
+    # Sets up the EYLogger to beging capturing capistrano's logging.  You should pass the capistrno configuration
+    # and the deploy type as a string.  The deploy type is for reporting purposes only but must be included.  
+    def self.setup(configuration, deploy_type, options = {})
+      @_configuration = configuration
+      @_deploy_type = deploy_type.gsub(/:/, "_")
+      @_log_path = options[:deploy_log_path] || Dir.tmpdir
+      @_log_path << "/" unless @_log_path =~ /\/$/
+      FileUtils.mkdir_p(@_log_path)
+      @_setup = true
+      @_success = true
+    end
+    
+    def self.log(level, message, line_prefix=nil)
+      return nil unless setup?
+      @release_name = @_configuration[:release_name] if @release_name.nil?
+      @_log_file_path = @_log_path + @release_name + ".log" unless @_log_file_path
+      @_deploy_log_file = File.open(@_log_file_path, "w") if @_deploy_log_file.nil?
+       
+      indent = "%*s" % [Logger::MAX_LEVEL, "*" * (Logger::MAX_LEVEL - level)]
+      message.each do |line|
+        if line_prefix
+          @_deploy_log_file << "#{indent} [#{line_prefix}] #{line.strip}\n"
+        else
+          @_deploy_log_file << "#{indent} #{line.strip}\n"
+        end
+      end
+    end
+    
+    def self.post_process      
+      unless ::Interrupt === $!
+        puts "\n\nPlease wait while the log file is processed\n"
+        # Should dump the stack trace of an exception if there is one
+        error = $!
+        unless error.nil?
+          @_deploy_log_file << error.message << "\n"
+          @_deploy_log_file << error.backtrace.join("\n")
+          @_success = false
+        end
+        self.close
+
+        hooks = [:any]
+        hooks << self.successful? ? :success : :failure
+        puts "Executing Post Processing Hooks"
+        hooks.each do |h|
+          @_post_process_hooks[h].each do |key|
+            @_configuration.parent.find_and_execute_task(key)
+          end
+        end
+        puts "Finished Post Processing Hooks"
+      end
+    end
+    
+    # Adds a post processing hook.  
+    #
+    # Provide a task name to execute.  These tasks are executed after capistrano has actually run its course. 
+    #
+    # Takes a key to control when the hook is executed.'
+    # :any - always executed
+    # :success - only execute on success
+    # :failure - only execute on failure
+    #
+    # ==== Example
+    #  Capistrano::EYLogger.post_process_hook( "ey_logger:upload_log_to_slice", :any) 
+    #
+    def self.post_process_hook(task, key = :any)
+      @_post_process_hooks ||= Hash.new{|h,k| h[k] = []}
+      @_post_process_hooks[key] << task
+    end
+
+    def self.setup?
+      !!@_setup
+    end   
+    
+    def self.deploy_type
+      @_deploy_type
+    end
+    
+    def self.successful?
+      !!@_success
+    end
+    
+    def self.failure?
+      !@_success
+    end
+    
+    def self.log_file_path
+      @_log_file_path
+    end
+    
+    def self.remote_log_file_name
+      @_log_file_name ||= "#{@_configuration[:release_name]}-#{@_deploy_type}-#{self.successful? ? "SUCCESS" : "FAILURE"}.log"
+    end
+    
+    def self.close
+      @_deploy_log_file.flush unless @_deploy_log_file.nil?
+      @_deploy_log_file.close unless @_deploy_log_file.nil?
+      @_setup = false
+    end
+    
+  end
+end

data/lib/eycap/lib/ey_logger_hooks.rb

@@ -0,0 +1,14 @@
+require File.join(File.dirname(__FILE__), "ey_logger")
+
+# These tasks are setup to use with the logger as post commit hooks.
+Capistrano::Configuration.instance(:must_exist).load do
+  namespace :ey_logger do
+    task :upload_log_to_slice, :except => { :no_release => true} do
+      logger = Capistrano::EYLogger
+      run "mkdir -p #{shared_path}/deploy_logs"
+      put File.open(logger.log_file_path).read, "#{shared_path}/deploy_logs/#{logger.remote_log_file_name}"
+    end
+  end
+end
+
+Capistrano::EYLogger.post_process_hook("ey_logger:upload_log_to_slice")

data/lib/eycap/recipes/backgroundrb.rb

@@ -0,0 +1,23 @@
+Capistrano::Configuration.instance(:must_exist).load do
+
+  namespace :bdrb do
+    desc "After update_code you want to reindex"
+    task :reindex, :roles => :app, :only => {:backgroundrb => true} do
+      run "/engineyard/bin/searchd #{application} reindex"
+    end
+  
+    desc "Start Backgroundrb"
+    task :start, :roles => :app, :only => {:backgroundrb => true} do
+      sudo "/usr/bin/monit start all -g backgroundrb_#{application}"
+    end
+    desc "Stop Backgroundrb"
+    task :stop, :roles => :app, :only => {:backgroundrb => true} do
+      sudo "/usr/bin/monit stop all -g backgroundrb_#{application}"
+    end
+    desc "Restart Backgroundrb"
+    task :restart, :roles => :app, :only => {:backgroundrb => true} do
+      sudo "/usr/bin/monit restart all -g backgroundrb_#{application}"
+    end        
+  end
+
+end

data/lib/eycap/recipes/database.rb

@@ -0,0 +1,37 @@
+Capistrano::Configuration.instance(:must_exist).load do
+
+  namespace :db do
+    task :backup_name, :only => { :primary => true } do
+      now = Time.now
+      run "mkdir -p #{shared_path}/db_backups"
+      backup_time = [now.year,now.month,now.day,now.hour,now.min,now.sec].join('-')
+      set :backup_file, "#{shared_path}/db_backups/#{environment_database}-snapshot-#{backup_time}.sql"
+    end
+  
+    desc "Clone Production Database to Staging Database."
+    task :clone_prod_to_staging, :roles => :db, :only => { :primary => true } do
+      backup_name
+      on_rollback { run "rm -f #{backup_file}" }
+      run "mysqldump --add-drop-table -u #{dbuser} -h #{production_dbhost}-replica -p#{dbpass} #{production_database} > #{backup_file}"
+      run "mysql -u #{dbuser} -p#{dbpass} -h #{staging_dbhost} #{staging_database} < #{backup_file}"
+      run "rm -f #{backup_file}"
+    end
+  
+    desc "Backup your database to shared_path+/db_backups"
+    task :dump, :roles => :db, :only => {:primary => true} do
+      backup_name
+      run "mysqldump --add-drop-table -u #{dbuser} -h #{environment_dbhost}-replica -p#{dbpass} #{environment_database} | bzip2 -c > #{backup_file}.bz2"
+    end
+    
+    desc "Sync your production database to your local workstation"
+    task :clone_to_local, :roles => :db, :only => {:primary => true} do
+      backup_name
+      dump
+      get "#{backup_file}.bz2", "/tmp/#{application}.sql.gz"
+      development_info = YAML.load_file("config/database.yml")['development']
+      run_str = "bzcat /tmp/#{application}.sql.gz | mysql -u #{development_info['username']} -p#{development_info['password']} -h #{development_info['host']} #{development_info['database']}"
+      %x!#{run_str}!
+    end
+  end
+
+end

data/lib/eycap/recipes/deploy.rb

@@ -0,0 +1,90 @@
+require File.join(File.dirname(__FILE__), "..", "lib", "ey_logger.rb")
+Capistrano::Configuration.instance(:must_exist).load do
+  
+  namespace :deploy do    
+    # This is here to hook into the logger for deploy and deploy:long tasks
+    ["deploy", "deploy:long"].each do |tsk|
+      before(tsk) do
+        Capistrano::EYLogger.setup( self, tsk )
+        at_exit{ Capistrano::EYLogger.post_process if Capistrano::EYLogger.setup? }
+      end
+    end
+
+    desc "Link the database.yml and mongrel_cluster.yml files into the current release path."
+    task :symlink_configs, :roles => :app, :except => {:no_release => true} do
+      run <<-CMD
+        cd #{release_path} &&
+        ln -nfs #{shared_path}/config/database.yml #{release_path}/config/database.yml &&
+        ln -nfs #{shared_path}/config/mongrel_cluster.yml #{release_path}/config/mongrel_cluster.yml
+      CMD
+    end
+  
+    desc "Display the maintenance.html page while deploying with migrations. Then it restarts and enables the site again."
+    task :long do
+      transaction do
+        update_code
+        web.disable
+        symlink
+        migrate
+      end
+  
+      restart
+      web.enable
+    end
+
+    desc "Restart the Mongrel processes on the app slices."
+    task :restart, :roles => :app do
+      mongrel.restart
+    end
+
+    desc "Start the Mongrel processes on the app slices."
+    task :spinner, :roles => :app do
+      mongrel.start
+    end
+
+    desc "Start the Mongrel processes on the app slices."
+    task :start, :roles => :app do
+      mongrel.start
+    end    
+    
+    desc "Stop the Mongrel processes on the app slices."
+    task :stop, :roles => :app do
+      mongrel.stop
+    end
+    
+    namespace :web do
+      desc <<-DESC
+        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 copy your html file to shared_path+'/system/maintenance.html.custom'.
+        If this file exists it will be used instead of the default capistrano ugly page
+      DESC
+      task :disable, :roles => :web, :except => { :no_release => true } do
+        maint_file = "#{shared_path}/system/maintenance.html"
+        require 'erb'
+        on_rollback { run "rm #{shared_path}/system/maintenance.html" }
+
+        reason = ENV['REASON']
+        deadline = ENV['UNTIL']
+
+        template = File.read(File.join(File.dirname(__FILE__), "templates", "maintenance.rhtml"))
+        result = ERB.new(template).result(binding)
+
+        put result, "#{shared_path}/system/maintenance.html.tmp", :mode => 0644
+        run "if [ -f #{shared_path}/system/maintenance.html.custom ]; then cp #{shared_path}/system/maintenance.html.custom #{maint_file}; else cp #{shared_path}/system/maintenance.html.tmp #{maint_file}; fi"
+      end
+    end
+  end
+
+end

data/lib/eycap/recipes/ferret.rb

@@ -0,0 +1,20 @@
+Capistrano::Configuration.instance(:must_exist).load do
+
+  namespace :ferret do
+    desc "After update_code you want to symlink the index and ferret_server.yml file into place"
+    task :symlink_configs, :roles => :app, :except => {:no_release => true} do
+      run <<-CMD
+        cd #{release_path} &&
+        ln -nfs #{shared_path}/config/ferret_server.yml #{release_path}/config/ferret_server.yml &&
+        if [ -d #{release_path}/index ]; then mv #{release_path}/index #{release_path}/index.bak; fi &&
+        ln -nfs #{shared_path}/index #{release_path}/index
+      CMD
+    end
+    [:start,:stop,:restart].each do |op|
+      desc "#{op} ferret server"
+      task op, :roles => :app, :except => {:no_release => true} do
+        sudo "/usr/bin/monit #{op} all -g ferret_#{application}"
+      end
+    end
+  end
+end

data/lib/eycap/recipes/juggernaut.rb

@@ -0,0 +1,18 @@
+Capistrano::Configuration.instance(:must_exist).load do
+
+  namespace :juggernaut do
+    desc "After update_code you want to symlink the juggernaut.yml file into place"
+    task :symlink_configs, :roles => :app, :except => {:no_release => true} do
+      run <<-CMD
+        cd #{release_path} &&
+        ln -nfs #{shared_path}/config/juggernaut.yml #{release_path}/config/juggernaut.yml
+      CMD
+    end
+    [:start,:stop,:restart].each do |op|
+      desc "#{op} juggernaut server"
+      task op, :roles => :app, :except => {:no_release => true} do
+        sudo "/usr/bin/monit #{op} all -g juggernaut_#{application}"
+      end
+    end
+  end
+end

data/lib/eycap/recipes/memcached.rb

@@ -0,0 +1,20 @@
+Capistrano::Configuration.instance(:must_exist).load do
+  namespace :memcached do 
+    desc "Start memcached"
+    task :start, :roles => :app, :only => {:memcached => true} do
+      sudo "/etc/init.d/memcached start"
+    end
+    desc "Stop memcached"
+    task :stop, :roles => :app, :only => {:memcached => true} do
+      sudo "/etc/init.d/memcached stop"
+    end
+    desc "Restart memcached"
+    task :restart, :roles => :app, :only => {:memcached => true} do
+      sudo "/etc/init.d/memcached restart"
+    end        
+    desc "Symlink the memcached.yml file into place if it exists"
+    task :symlink_configs, :roles => :app, :only => {:memcached => true }, :except => { :no_release => true } do
+      run "if [ -f #{shared_path}/config/memcached.yml ]; then ln -nfs #{shared_path}/config/memcached.yml #{release_path}/config/memcached.yml; fi"
+    end
+  end
+end

data/lib/eycap/recipes/mongrel.rb

@@ -0,0 +1,28 @@
+Capistrano::Configuration.instance(:must_exist).load do
+  namespace :mongrel do
+    desc <<-DESC
+    Start Mongrel processes on the app server.  This uses the :use_sudo variable to determine whether to use sudo or not. By default, :use_sudo is
+    set to true.
+    DESC
+    task :start, :roles => :app do
+      sudo "/usr/bin/monit start all -g #{monit_group}"
+    end
+
+    desc <<-DESC
+    Restart the Mongrel processes on the app server by starting and stopping the cluster. This uses the :use_sudo
+    variable to determine whether to use sudo or not. By default, :use_sudo is set to true.
+    DESC
+    task :restart, :roles => :app do
+      sudo "/usr/bin/monit restart all -g #{monit_group}"
+    end
+
+    desc <<-DESC
+    Stop the Mongrel processes on the app server.  This uses the :use_sudo
+    variable to determine whether to use sudo or not. By default, :use_sudo is
+    set to true.
+    DESC
+    task :stop, :roles => :app do
+      sudo "/usr/bin/monit stop all -g #{monit_group}"
+    end
+  end
+end

data/lib/eycap/recipes/monit.rb

@@ -0,0 +1,17 @@
+Capistrano::Configuration.instance(:must_exist).load do
+
+  namespace :monit do
+    desc "Get the status of your mongrels"
+    task :status, :roles => :app do
+      @monit_output ||= { }
+      sudo "/usr/bin/monit status" do |channel, stream, data|
+        @monit_output[channel[:server].to_s] ||= [ ]
+        @monit_output[channel[:server].to_s].push(data.chomp)
+      end
+      @monit_output.each do |k,v|
+        puts "#{k} -> #{'*'*55}"
+        puts v.join("\n")
+      end
+    end
+  end
+end

data/lib/eycap/recipes/nginx.rb

@@ -0,0 +1,36 @@
+Capistrano::Configuration.instance(:must_exist).load do
+
+  namespace :nginx do 
+    desc "Start Nginx on the app slices."
+    task :start, :roles => :app do
+      sudo "/etc/init.d/nginx start"
+    end
+
+    desc "Restart the Nginx processes on the app slices."
+    task :restart , :roles => :app do
+      sudo "/etc/init.d/nginx restart"
+    end
+
+    desc "Stop the Nginx processes on the app slices."
+    task :stop , :roles => :app do
+      sudo "/etc/init.d/nginx stop"
+    end
+
+    desc "Tail the nginx access logs for this application"
+    task :tail, :roles => :app do
+      run "tail -f /var/log/engineyard/nginx/#{application}.access.log" do |channel, stream, data|
+        puts "#{channel[:server]}: #{data}" unless data =~ /^10\.[01]\.0/ # skips lb pull pages
+        break if stream == :err    
+      end
+    end
+
+    desc "Tail the nginx error logs on the app slices"
+    task :tail_error, :roles => :app do
+      run "tail -f /var/log/engineyard/nginx/error.log" do |channel, stream, data|
+        puts "#{channel[:server]}: #{data}" unless data =~ /^10\.[01]\.0/ # skips lb pull pages
+        break if stream == :err    
+      end
+    end
+
+  end
+end

data/lib/eycap/recipes/slice.rb

@@ -0,0 +1,21 @@
+Capistrano::Configuration.instance(:must_exist).load do
+
+  namespace :slice do
+    desc "Tail the Rails production log for this environment"
+    task :tail_production_logs, :roles => :app do
+      run "tail -f #{shared_path}/log/#{rails_env}.log" do |channel, stream, data|
+        puts  # for an extra line break before the host name
+        puts "#{channel[:server]} -> #{data}" 
+        break if stream == :err    
+      end
+    end
+    desc "Tail the Mongrel logs this environment"
+    task :tail_mongrel_logs, :roles => :app do
+      run "tail -f #{shared_path}/log/mongrel*.log" do |channel, stream, data|
+        puts  # for an extra line break before the host name
+        puts "#{channel[:server]} -> #{data}" 
+        break if stream == :err    
+      end
+    end
+  end
+end

data/lib/eycap/recipes/solr.rb

@@ -0,0 +1,37 @@
+Capistrano::Configuration.instance(:must_exist).load do
+
+  namespace :solr do
+    desc "After update_code you want to symlink the index and ferret_server.yml file into place"
+    task :symlink_configs, :roles => :app, :except => {:no_release => true} do
+      run <<-CMD
+        cd #{release_path} && ln -nfs #{shared_path}/config/solr.yml #{release_path}/config/solr.yml
+      CMD
+    end
+    
+    [:start,:stop,:restart].each do |op|
+      desc "#{op} ferret server"
+      task op, :roles => :app, :only => {:solr => true} do
+        sudo "/usr/bin/monit #{op} all -g solr_#{application}"
+      end
+    end
+    
+    namespace :tail do
+      desc "Tail the Solr logs this environment"
+      task :logs, :roles => :app, :only => {:solr => true} do
+        run "tail -f /var/log/engineyard/solr/#{application}.log" do |channel, stream, data|
+          puts  # for an extra line break before the host name
+          puts "#{channel[:server]} -> #{data}" 
+          break if stream == :err    
+        end
+      end
+      desc "Tail the Solr error logs this environment"
+      task :errors, :roles => :app, :only => {:solr => true} do
+        run "tail -f /var/log/engineyard/solr/#{application}.err.log" do |channel, stream, data|
+          puts  # for an extra line break before the host name
+          puts "#{channel[:server]} -> #{data}" 
+          break if stream == :err    
+        end
+      end
+    end    
+  end
+end

data/lib/eycap/recipes/sphinx.rb

@@ -0,0 +1,34 @@
+Capistrano::Configuration.instance(:must_exist).load do
+
+  namespace :sphinx do
+    desc "After update_code you want to configure, then reindex"
+    task :configure, :roles => :app, :only => {:sphinx => true}, :except => {:no_release => true} do
+      run "/engineyard/bin/searchd #{application} configure"
+    end
+
+    desc "After configure you want to reindex"
+    task :reindex, :roles => :app, :only => {:sphinx => true} do
+      run "/engineyard/bin/searchd #{application} reindex"
+    end
+      
+    desc "Start Sphinx Searchd"
+    task :start, :roles => :app, :only => {:sphinx => true} do
+      sudo "/usr/bin/monit start all -g sphinx_#{application}"
+    end
+    desc "Stop Sphinx Searchd"
+    task :stop, :roles => :app, :only => {:sphinx => true} do
+      sudo "/usr/bin/monit stop all -g sphinx_#{application}"
+    end
+    desc "Restart Sphinx Searchd"
+    task :restart, :roles => :app, :only => {:sphinx => true} do
+      sudo "/usr/bin/monit restart all -g sphinx_#{application}"
+    end        
+
+    desc "Symlink the sphinx config file"
+    task :symlink, :roles => :app, :only => {:sphinx => true}, :except => {:no_release => true} do
+      run "if [ -d #{release_path}/config/ultrasphinx ]; then mv #{release_path}/config/ultrasphinx #{release_path}/config/ultrasphinx.bak; fi"
+      run "ln -nfs #{shared_path}/config/ultrasphinx #{release_path}/config/ultrasphinx"
+    end
+  end
+
+end

data/lib/eycap/recipes/templates/maintenance.rhtml

@@ -0,0 +1,53 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+
+<head>
+  <meta http-equiv="content-type" content="text/html;charset=UTF-8" />
+  <title>System down for maintenance</title>
+
+  <style type="text/css">
+    div.outer {
+      position: absolute;
+      left: 50%;
+      top: 50%;
+      width: 500px;
+      height: 300px;
+      margin-left: -260px; 
+      margin-top: -150px;
+    }
+
+    .DialogBody {
+      margin: 0;
+      padding: 10px;
+      text-align: left;
+      border: 1px solid #ccc;
+      border-right: 1px solid #999;
+      border-bottom: 1px solid #999;
+      background-color: #fff;
+    }
+
+    body { background-color: #fff; }
+  </style>
+</head>
+
+<body>
+
+  <div class="outer">
+     <div class="DialogBody" style="text-align: center;">
+       <div style="text-align: center; width: 200px; margin: 0 auto;">
+         <p style="color: red; font-size: 16px; line-height: 20px;">
+           The system is down for <%= reason ? reason : "maintenance" %>
+           as of <%= Time.now.strftime("%H:%M %Z") %>.
+         </p>
+         <p style="color: #666;">
+           It'll be back <%= deadline ? deadline : "shortly" %>.
+         </p>
+       </div>
+     </div>
+  </div>
+
+</body>
+</html>

data/lib/eycap/recipes/tomcat.rb

@@ -0,0 +1,16 @@
+Capistrano::Configuration.instance(:must_exist).load do
+  namespace :tomcat do 
+    desc "Start tomcat"
+    task :start, :roles => :app, :only => {:tomcat => true} do
+      sudo "/etc/init.d/tomcat start"
+    end
+    desc "Stop tomcat"
+    task :stop, :roles => :app, :only => {:tomcat => true} do
+      sudo "/etc/init.d/tomcat stop"
+    end
+    desc "Restart tomcat"
+    task :restart, :roles => :app, :only => {:tomcat => true} do
+      sudo "/etc/init.d/tomcat restart"
+    end
+  end
+end

data/lib/eycap/recipes.rb

@@ -0,0 +1,23 @@
+require 'eycap/lib/ey_logger'
+require 'eycap/lib/ey_logger_hooks'
+require 'eycap/recipes/database'
+require 'eycap/recipes/ferret'
+require 'eycap/recipes/mongrel'
+require 'eycap/recipes/nginx'
+require 'eycap/recipes/slice'
+require 'eycap/recipes/deploy'
+require 'eycap/recipes/sphinx'
+require 'eycap/recipes/backgroundrb'
+require 'eycap/recipes/memcached'
+require 'eycap/recipes/solr'
+require 'eycap/recipes/monit'
+require 'eycap/recipes/tomcat'
+require 'eycap/recipes/juggernaut'
+
+Capistrano::Configuration.instance(:must_exist).load do
+  
+  default_run_options[:pty] = true if respond_to?(:default_run_options)
+  set :keep_releases, 3
+  set :runner, defer { user }
+  
+end

data/lib/eycap.rb

@@ -0,0 +1,3 @@
+module Eycap
+  VERSION = '0.3.3'
+end

data/test/test_eycap.rb

@@ -0,0 +1,11 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestEycap < Test::Unit::TestCase
+
+  def setup
+  end
+  
+  def test_truth
+    assert true
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,2 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/eycap'

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification 
+name: engineyard-eycap
+version: !ruby/object:Gem::Version 
+  version: 0.3.3
+platform: ruby
+authors: 
+- Engine Yard
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-05-12 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: capistrano
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.2.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.5.1
+    version: 
+description: A bunch of useful recipes to help deployment to Engine Yard slices
+email: tech@engineyard.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/capistrano/recipes/deploy/strategy/filtered_remote_cache.rb
+- lib/eycap.rb
+- lib/eycap/lib/ey_logger.rb
+- lib/eycap/lib/ey_logger_hooks.rb
+- lib/eycap/recipes.rb
+- lib/eycap/recipes/backgroundrb.rb
+- lib/eycap/recipes/database.rb
+- lib/eycap/recipes/deploy.rb
+- lib/eycap/recipes/ferret.rb
+- lib/eycap/recipes/juggernaut.rb
+- lib/eycap/recipes/memcached.rb
+- lib/eycap/recipes/mongrel.rb
+- lib/eycap/recipes/monit.rb
+- lib/eycap/recipes/nginx.rb
+- lib/eycap/recipes/slice.rb
+- lib/eycap/recipes/solr.rb
+- lib/eycap/recipes/sphinx.rb
+- lib/eycap/recipes/templates/maintenance.rhtml
+- lib/eycap/recipes/tomcat.rb
+- test/test_eycap.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://eycap.rubyforge.org
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+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: eycap
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Capistrano tasks for Engine Yard slices
+test_files: 
+- test/test_eycap.rb
+- test/test_helper.rb