capistrano-boss 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2009-2010 Andrew Carter
+
+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/README.rdoc

@@ -0,0 +1,164 @@
+= capistrano-boss
+
+Collection of extensions for managing Rails projects via Capistrano in production environments.
+
+These recipes are extracted from two years of running Ruby on Rails projects in production environments.
+
+---
+
+== Installation
+
+Install the gem:
+
+  sudo gem install capistrano-boss
+
+
+Capify a project:
+
+  rails test
+  cd test
+  capify .
+
+Capbossify to add the extensions:
+
+  capbossify .
+
+The Capfile will be extended to include the capistrano-boss recipes.
+
+---
+
+== Usage
+
+Once _capbossify_ has been used on a project, the recipes will be added to the list of available recipes.
+
+---
+
+== Recipes
+
+The capistrano-boss recipes are split into several namespaces.
+
+=== Deploy
+
+One extra recipe is added for SSH key management:
+
+  cap deploy:authorized_keys         # Upload authorized_keys file.
+
+This task uploads an *authorized_keys* file to the cap user +.ssh/authorized_keys+ location. Keyfile is expected to be +authorized_keys+ or set the environment variable +keys+:
+
+  cap deploy:authorized_keys keys=my_auth_keys
+
+=== Apache
+
+The set of apache recipes are for using the standard apachectl options as well as some convenience recipes for handling logs.
+
+  cap apache:graceful                # Graceful Apache web service
+  cap apache:graceful_stop           # Graceful-stop Apache web service
+  cap apache:log:fetch               # Download Apache httpd logs
+  cap apache:log:tail                # Tail Apache httpd logs
+  cap apache:log:watch               # Watch Apache httpd logs
+  cap apache:restart                 # Restart Apache web service
+  cap apache:start                   # Start Apache web service
+  cap apache:stop                    # Stop Apache web service
+
+By default, the variable +apache_logs+ is set to an array that includes the error and access log from the default location for Red Hat. Override with the location of the logs or to add custom logs.
+
+The control tasks use +apachectl+ variable to determine the select the HTTP server control interface.
+
+===== apache:log:fetch
+
+Copies log files to +./log/deploy/RAILS_ENV/TIMESTAMP/HOST-LOGFILENAME.log+.
+
+===== apache:log:tail
+
+Tail last n lines of the log files by host. Set environment variable +lines+ to set number of lines.
+
+  cap apache:log:tail lines=50
+
+===== apache:log:watch
+
+Running tail of all the log files with a host and timestamp for each line. Useful to watch all the logs in real-time.
+
+=== Passenger
+
+Simple task to restart a Passenger managed application. This recipe is an alias for the +touch+ +tmp/restart.txt+ method. It makes other tasks that want to restart the app more readable.
+
+  cap passenger:restart              # Restart Rails application
+
+=== Rails
+
+The Rails set of recipes help with configuration and monitoring.
+
+  cap rails:about                    # About Rails environment
+  cap rails:config                   # Generate Rails configuration
+  cap rails:config:database          # Create a database.yml file in shared con...
+  cap rails:deploy:config            # Deploy Rails configuration files
+  cap rails:deploy:snapshot_database # Snapshot database.
+  cap rails:log:fetch                # Download Rails application log
+  cap rails:log:tail                 # Tail Rails application log
+  cap rails:log:watch                # Watch Rails application log
+
+If the application is not rails, set the variable +rails_disable+ to true in the +./config/deploy.rb+ file to disable all the Rails recipes:
+
+  set :rails_disable, false
+
+===== rails:config
+
+Meta recipe that runs all the config tasks. Useful when initializing a new environment (when using the capistrano-ext multistage extension for example). Creates a +SHARED_PATH/config+ directory for config files that don't change for each deploy.
+
+===== rails:config:database
+
+Generate +SHARED_PATH/config/database.yml+ file. It will prompt for the database password if not provided. This method allows for writing the config file into a production environment without checking in the database password. Set +db_*+ variables to write the environment section in the database.yml file. Defaults are valid for MySQL with database default of +USER_RAILS_ENV+.
+
+===== rails:deploy:config
+
+Symlink +SHARED_PATH/config/database.yml+ to +CURRENT_PATH/config/database.yml+. Used for deploys to utilize the shared database config.
+
+===== rails:deploy:snapshot_database
+
+Run a MySQL dump to the location specified by environment variable +dbpath+. Default location is +SHARED_PATH/backup/db/DATABASE_TIMESTAMP.sql.gz+.
+
+  cap rails:deploy:snapshot_database dbpath=/var/backup/db
+
+===== rails:log:fetch
+
+Copies RAILS_ENV.log file to +./log/deploy/RAILS_ENV/TIMESTAMP/HOST-RAILS_ENV.log+
+
+===== rails:log:tail
+
+Tail last n lines of the log files by host. Set environment variable +lines+ to set number of lines.
+
+  cap rails:log:tail lines=50
+
+===== rails:log:watch
+
+Running tail of all the log files with a host and timestamp for each line. Useful to watch all the logs in real-time.
+
+=== Subversion
+
+Support for the subversion scm has been extended to include +branch+ and +tag+ variables. If either variable is set, the repository path is adjusted to take the tag or branch into account. The default is to use +trunk+. The repository should be the base URL without trunk/branches/tags. Also, it assumes a standard subversion layout:
+
+  project/
+    branches/
+    tags/
+    trunk/
+
+Examples:
+
+==== trunk
+  set :repository, '/path/to/svn/root/project'
+  => Repository is /path/to/svn/root/project/trunk at runtime
+
+==== branch
+  set :repository, '/path/to/svn/root/project'
+  set :branch, 'mybranch'
+  => Repository is /path/to/svn/root/project/branches/mybranch
+
+==== tag
+  set :repository, '/path/to/svn/root/project'
+  set :tag, 'mytag'
+  => Repository is /path/to/svn/root/project/tags/mytag
+
+== Copyright
+
+Copyright (c) 2009-2010 Andrew Carter. See LICENSE for details.
+

data/Rakefile

@@ -0,0 +1,45 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "capistrano-boss"
+    gem.summary = %Q{Capistrano extensions for configuring, provisioning, and management}
+    gem.description = %Q{Collection of capistrano extensions focused on configuration, provisioning, and management.}
+    gem.email = "ascarter@gmail.com"
+    gem.homepage = "http://github.com/ascarter/capistrano-boss"
+    gem.authors = ["Andrew Carter"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "capistrano-boss #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/capbossify

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'fileutils'
+
+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
+
+if ARGV.empty?
+  abort "Please specify the directory to capbossify, 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 capbossify."
+end
+
+base = ARGV.shift
+capfile = File.join(base, "Capfile")
+if !File.exists?(capfile)
+  abort "Please run capify on directory before using capbossify"
+end
+
+contents = File.readlines(capfile)
+begin
+  capboss_require = "require 'capistrano-boss'\n"
+  contents.each { |line| raise Exception.exception("'#{capfile}' already capbossified") if line == capboss_require }
+  out = File.open(capfile, "w")
+  contents.each do |line|
+    out << line
+    if line =~ /^load \'deploy\' if respond_to\?\(\:namespace\)/
+      puts "[add] adding capistrano-boss require"
+      out << capboss_require
+    end
+  end
+  out.close
+rescue Exception => ex
+  warn "[skip] #{ex.message}"
+end
+
+puts "[done] capbossified!"

data/capistrano-boss.gemspec

@@ -0,0 +1,68 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{capistrano-boss}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Andrew Carter"]
+  s.date = %q{2010-01-27}
+  s.default_executable = %q{capbossify}
+  s.description = %q{Collection of capistrano extensions focused on configuration, provisioning, and management.}
+  s.email = %q{ascarter@gmail.com}
+  s.executables = ["capbossify"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "bin/capbossify",
+     "capistrano-boss.gemspec",
+     "lib/capistrano-boss.rb",
+     "lib/capistrano_boss/channel.rb",
+     "lib/capistrano_boss/database.rb",
+     "lib/capistrano_boss/database/mysql.rb",
+     "lib/capistrano_boss/extensions.rb",
+     "lib/capistrano_boss/extensions/subversion.rb",
+     "lib/capistrano_boss/log.rb",
+     "lib/recipes/apache.rb",
+     "lib/recipes/deploy.rb",
+     "lib/recipes/passenger.rb",
+     "lib/recipes/rails.rb",
+     "spec/capistrano-boss_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/ascarter/capistrano-boss}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Capistrano extensions for configuring, provisioning, and management}
+  s.test_files = [
+    "spec/capistrano-boss_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+  end
+end
+

data/lib/capistrano-boss.rb

@@ -0,0 +1,21 @@
+#require 'capistrano/recipes/deploy/scm/subversion'
+require 'capistrano_boss/extensions'
+require 'capistrano_boss/database'
+require 'capistrano_boss/channel'
+require 'capistrano_boss/log'
+
+# Include extensions
+include CapistranoBoss::Log, CapistranoBoss::Channel, CapistranoBoss::Database
+
+Capistrano::Configuration.instance.load do
+  Dir[File.join(File.dirname(__FILE__), "recipes", "*.rb")].each { |plugin| load(plugin) }
+end
+
+module CapistranoBoss
+  # Standardized timestamp
+  # Example:
+  #   200912241432
+  def self.timestamp
+    Time.now.strftime("%Y%m%d%H%M")
+  end
+end

data/lib/capistrano_boss/channel.rb

@@ -0,0 +1,69 @@
+module CapistranoBoss
+  module Channel
+    # Execute command using sudo and collect output in hash
+    # keyed by channel
+    def sudo_by_channel(command)
+      exec_by_channel(command, :sudo)
+    end
+    
+    # Execute command using run and collect output in hash
+    # keyed by channel
+    def run_by_channel(command)
+      exec_by_channel(command, :run)
+    end
+    
+    # Print channel output data to destination file stream
+    def print_channel(channel, data, file = $stdout)
+      file.puts
+      file.puts "--- #{channel[:host]} | #{Time.now.to_s} ---"
+      file.puts "#{data}"
+      file.puts
+    end
+
+    def print_buffered_channel(output, file = $stdout)
+      output.sort.each do |channel, data|
+        unless file == $stdout
+          file.puts "Method:  #{context.to_s}"
+          file.puts "Command: #{command}"
+        end
+        file.puts
+        file.puts "--- #{channel} ---"
+        file.puts "#{data}"
+        file.puts
+      end
+    end
+
+    # Execute command on each channel and collect output in hash
+    # keyed by channel
+    #
+    # Execution contexts:
+    # run::
+    #   Using run method
+    # sudo::
+    #   Using sudo method
+    #
+    # Stream::
+    #   Stream results back immediately (true)
+    #   Buffer results and print on completion (false)
+    #
+    # File::
+    #   Any valid stream object to capture output
+    def exec_by_channel(command, context = :run, stream = false, file = $stdout)
+      output = {}
+
+      # Run command on each channel and collect the results
+      send(context, command, :pty => true) do |channel, stream, data|
+        if stream
+          print_channel(channel, data, file)
+        else
+          key = channel[:host].to_s
+          output[key] = "" unless output.has_key?(key)
+          output[key] << data
+        end
+        break if stream == :err
+      end
+
+      print_buffered_channel(output, file) unless stream
+    end
+  end
+end

data/lib/capistrano_boss/database.rb

@@ -0,0 +1,53 @@
+require 'capistrano_boss/database/mysql.rb'
+# require 'capistrano_boss/database/sqlite.rb'
+# require 'capistrano_boss/database/postgresql.rb'
+
+require 'yaml'
+
+module CapistranoBoss
+  module Database
+    # Load adapter module
+    def self.load_adapter(config)
+      case config['adapter']
+      when "mysql"
+        adapter = MySQL.new(config)
+      else
+        abort "Unsupported database adapter: #{config['adapter']}"
+      end
+      
+      return adapter
+    end
+
+    # Load database.yml and return configuration for current Rails environment
+    def read_database_yml
+      database_yml = {}
+      run "cat #{current_path}/config/database.yml" do |channel, stream, data|
+        database_yml = YAML.load(data)
+      end
+
+      unless database_yml.has_key?(rails_env)
+        abort "Missing configuration for #{rails_env}"
+      end
+
+      # Return config for current environment
+      database_yml[rails_env]
+    end
+
+    # Run query and stream results back
+    def query(sql)
+      config = read_database_yml
+      adapter = CapistranoBoss::Database.load_adapter(config)
+      run "#{adapter.query(sql)}"
+    end
+
+    # Create a snapshot of database to remote path
+    def dump(db_path)
+      config = read_database_yml
+      adapter = CapistranoBoss::Database.load_adapter(config)
+      snapshot_file = "#{adapter.option(:database)}_#{CapistranoBoss.timestamp}.sql.gz"
+      run "mkdir -p #{db_path}; #{adapter.dump} | gzip > #{db_path}/#{snapshot_file}"
+    end
+
+  end
+end
+

data/lib/capistrano_boss/database/mysql.rb

@@ -0,0 +1,54 @@
+module CapistranoBoss
+  module Database
+    class MySQL
+      def initialize(options = {})
+        self.options = options
+      end
+      
+      def options
+        @options
+      end
+
+      def option(key)
+        self.options[key.to_s]
+      end
+
+      def options=(options)
+        @options = options
+      end
+
+      def set(option, value)
+        self.options[option.to_s] = value
+      end
+
+      def query(sql)
+        command_line("mysql") << " -e \"#{sql}\""
+      end
+      
+      def dump
+        command_line("mysqldump --no-create-db ")
+      end
+
+      private
+      
+      def command_line(command)
+        args = []
+        args << "-u #{options['username']}" if options.has_key?('username')
+        args << "-p#{options['password']}" if options.has_key?('password')
+        args << "-h #{options['host']}" if options.has_key?('host')
+        args << "--default-character-set=#{options['encoding']}" if options.has_key?('encoding')
+        args << "-P #{options['port']}" if options.has_key?('port')
+        args << "-S #{options['socket']}" if options.has_key?('socket')
+        args << "--ssl-key=#{options['sslkey']}" if options.has_key?('sslkey')
+        args << "--ssl-cert=#{options['sslcert']}" if options.has_key?('sslcert')
+        args << "--ssl-capath=#{options['sslpath']}" if options.has_key?('sslpath')
+        args << "--ssl-cipher=#{options['sslcipher']}" if options.has_key?('sslcipher')
+        args << "--unbuffered" if options.has_key?('unbuffered')
+        args << "#{options['database']}" if options.has_key?('database')
+
+        "#{command} #{args.join(' ')}"
+      end
+    end    
+  end
+end
+

data/lib/capistrano_boss/extensions.rb

@@ -0,0 +1,2 @@
+require 'capistrano_boss/extensions/subversion'
+

data/lib/capistrano_boss/extensions/subversion.rb

@@ -0,0 +1,25 @@
+require 'capistrano/recipes/deploy/scm/base'
+
+module Capistrano
+  module Deploy
+    module SCM
+      class Subversion < Base
+        # Returns working subversion repository path
+        # Defaults to trunk
+        # If variable :tag or :branch are set, path is adjusted
+        # Repository path should refer to root of standard svn layout
+        def repository
+          if variable(:svn_explicit_path)
+            variable(:repository)
+          elsif variable(:tag)
+            "#{variable(:repository)}/tags/#{variable(:tag)}"
+          elsif variable(:branch)
+            "#{variable(:repository)}/branches/#{variable(:branch)}"
+          else
+            "#{variable(:repository)}/trunk"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/capistrano_boss/log.rb

@@ -0,0 +1,42 @@
+module CapistranoBoss
+  module Log
+    def source_logs(input)
+      input.is_a?(Array) ? input : [ input ]
+    end
+
+    # Download log to destination/<timestamp>
+    def fetch_log(input, destination = ".")
+      target_dir = File.join(destination, rails_env, CapistranoBoss::timestamp)
+      FileUtils.mkdir_p(target_dir)
+      source_logs(input).each do |s|
+        download s, "#{target_dir}/$CAPISTRANO:HOST$-#{File.basename(s)}"
+      end
+    end
+    
+    # Tail log and output by channel
+    def tail_log(input, context = :run)
+      nlines = ENV['lines'].nil? ? "10" : ENV['lines']
+      cmd = "tail -n #{nlines} #{source_logs(input).join(' ')}"
+      exec_by_channel(cmd, context)
+    end
+
+    # Watch log and stream by channel
+    def watch_log(input, context = :run)
+      cmd =  "tail -f #{source_logs(input).join(' ')}"
+      exec_by_channel(cmd, context, true)
+    end
+
+    # Pretty print a stats hash.
+    # Expects::
+    #  { "host" => { "key1" => value, "key2" => value } }
+    def dump_stats(stats)
+      stats.each do |host, values|
+        puts "-" * 40
+        puts "#{host}"
+        puts "-" * 40
+        values.sort.each {|k,v| puts "  #{k} => #{v}" }
+      end
+    end    
+  end
+end
+

data/lib/recipes/apache.rb

@@ -0,0 +1,55 @@
+namespace :apache do
+  set :apachectl, 'apachectl'
+  set :apachectl_options, '-k'
+  set :apache_logs, ['/var/log/httpd/error_log', '/var/log/httpd/access_log']
+
+  desc "Start Apache web service"
+  task :start, :roles => :app do
+    apachectl_cmd("start")
+  end
+
+  desc "Stop Apache web service"
+  task :stop, :roles => :app do
+    apachectl_cmd("stop")
+  end
+
+  desc "Restart Apache web service"
+  task :restart, :roles => :app do
+    apachectl_cmd("restart")
+  end
+
+  desc "Graceful Apache web service"
+  task :graceful, :roles => :app do
+    apachectl_cmd("graceful")
+  end
+
+  desc "Graceful-stop Apache web service"
+  task :graceful_stop, :roles => :app do
+    apachectl_cmd("graceful-stop")
+  end
+
+  namespace :log do
+    desc "Download Apache httpd logs"
+    task :fetch, :roles => :app do
+      dest = ENV['destination'] || File.join('log', 'deploy')
+      fetch_log(apache_log_files, dest)
+    end
+
+    desc "Tail Apache httpd logs"
+    task :tail, :roles => :app do
+      tail_log(apache_logs, :sudo)
+    end
+
+    desc "Watch Apache httpd logs"
+    task :watch, :roles => :app do
+      watch_log(apache_logs, :sudo)
+    end
+  end
+
+  # Helpers
+
+  def apachectl_cmd(action)
+    sudo "#{apachectl} #{apachectl_options} #{action}", :pty => true
+  end
+end
+

data/lib/recipes/deploy.rb

@@ -0,0 +1,13 @@
+namespace :deploy do
+  desc  "Upload authorized_keys file. Specify file by setting keys=<path>"
+  task :authorized_keys do
+    keyfile = ENV['keys'] || "authorized_keys"
+    unless File.exist?(keyfile)
+      abort "Missing authorized_keys file at #{keyfile}"
+    end
+    run "mkdir -p -m 700 .ssh"
+    run "if [ -e .ssh/authorized_keys ]; then cp .ssh/authorized_keys .ssh/authorized_keys.#{CapistranoBoss.timestamp}; fi;"
+    put File.new(keyfile).read, ".ssh/authorized_keys", :mode => 0600
+  end
+end
+

data/lib/recipes/passenger.rb

@@ -0,0 +1,6 @@
+namespace :passenger do
+  desc "Restart Rails application"
+  task :restart, :roles => :app do
+    run "touch #{current_release}/tmp/restart.txt"
+  end
+end

data/lib/recipes/rails.rb

@@ -0,0 +1,93 @@
+namespace :rails do
+  after "deploy:setup", "rails:config"
+  after "deploy:update_code", "rails:deploy:config"
+
+  desc "About Rails environment"
+  task :about do
+    run "RAILS_ENV=#{rails_env} #{current_path}/script/about "
+  end
+
+  namespace :config do
+    desc "Generate Rails configuration"
+    task :default, :roles => :app do
+      run "mkdir -p #{shared_path}/config"
+      rails::config::database unless disabled?(:database)
+    end
+
+    desc "Create a database.yml file in shared configuration"
+    task :database, :roles => :app do
+
+      # Set required fields
+      set(:db_adapter, "mysql") unless exists?(:db_adapter)
+      set(:db_username, user) unless exists?(:db_username)
+      set(:db_database, "#{user}_#{rails_env}") unless exists?(:db_database)
+      unless exists?(:db_password)
+        set(:db_password) { Capistrano::CLI.password_prompt("#{rails_env} #{db_adapter} password: ") }
+      end
+
+      # Create database config
+      db_config = {
+        "#{rails_env}" => {
+          "adapter" => db_adapter,
+          "database" => db_database,
+          "username" => db_username,
+          "password" => db_password
+        }
+      }
+
+      # Add any optional overrides
+      %w[host port socket encoding sslkey sslcert sslcapath sslcipher pool].each do |attribute|
+        varname = "db_#{attribute}".to_sym
+        if exists?(varname)
+          db_config["#{rails_env}"][attribute] = fetch(varname)
+        end
+      end
+
+      # Write config file to shared/config/database.yml
+      put(db_config.to_yaml, "#{shared_path}/config/database.yml")
+    end
+  end
+
+  namespace :deploy do
+    desc "Deploy Rails configuration files"
+    task :config, :roles => :app do
+      source = "#{shared_path}/config/database.yml"
+      dest = "#{release_path}/config/database.yml"
+      run "if [ -e \"#{source}\" ]; then cp #{source} #{dest}; fi"
+    end
+
+    desc "Snapshot database. Snapshot location specified by dbpath=<path>"
+    task :snapshot_database, :roles => :db do
+      db_path = ENV['dbpath'] || "#{shared_path}/backup/db" 
+      dump(db_path)
+    end
+  end
+
+  namespace :log do
+    desc "Download Rails application log"
+    task :fetch, :roles => :app do
+      source = "#{shared_path}/log/#{rails_env}.log"
+      dest = ENV['destination'] || File.join('log', 'deploy')
+      fetch_log source, dest
+    end
+
+    desc "Tail Rails application log"
+    task :tail, :roles => :app do
+      tail_log "#{shared_path}/log/#{rails_env}.log"
+    end
+
+    desc "Watch Rails application log"
+    task :watch, :roles => :app do
+      watch_log "#{shared_path}/log/#{rails_env}.log"
+    end
+  end
+
+  #
+  # Helper methods
+  #
+
+  def disabled?(key)
+    exists?(:rails_disable) ? rails_disable.include?(key.to_sym) : false
+  end
+
+end

data/spec/capistrano-boss_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "CapistranoBoss" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'capistrano-boss'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification 
+name: capistrano-boss
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Andrew Carter
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-01-27 00:00:00 -08:00
+default_executable: capbossify
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.9
+    version: 
+description: Collection of capistrano extensions focused on configuration, provisioning, and management.
+email: ascarter@gmail.com
+executables: 
+- capbossify
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- bin/capbossify
+- capistrano-boss.gemspec
+- lib/capistrano-boss.rb
+- lib/capistrano_boss/channel.rb
+- lib/capistrano_boss/database.rb
+- lib/capistrano_boss/database/mysql.rb
+- lib/capistrano_boss/extensions.rb
+- lib/capistrano_boss/extensions/subversion.rb
+- lib/capistrano_boss/log.rb
+- lib/recipes/apache.rb
+- lib/recipes/deploy.rb
+- lib/recipes/passenger.rb
+- lib/recipes/rails.rb
+- spec/capistrano-boss_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/ascarter/capistrano-boss
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: 3
+summary: Capistrano extensions for configuring, provisioning, and management
+test_files: 
+- spec/capistrano-boss_spec.rb
+- spec/spec_helper.rb