crossroads_capistrano 1.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in crossroads_capistrano.gemspec
+gemspec

data/README.textile

@@ -0,0 +1,18 @@
+h1. Crossroads Capistrano
+
+A "Crossroads":http://www.crossroads.org.hk specific set of generic capistrano recipes.
+
+This gem can be included in all our rails apps that use Capistrano.
+
+h3. Usage
+
+Add the following to your project's *Gemfile* :
+
+bc. gem 'crossroads_capistrano', :git => 'http://github.com/crossroads/crossroads_capistrano.git'
+ 
+Add the following to your project's *config/deploy.rb* :
+
+bc. require 'crossroads_capistrano'
+CrossroadsCapistrano.load_recipes %w(prompt stack rvm passenger postgresql newrelic log)
+# or ..
+CrossroadsCapistrano.load_recipes :all

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/crossroads_capistrano.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "crossroads_capistrano"
+  s.version     = "1.1.0"
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Steve Kenworthy", "Ben Tillman", "Nathan Broadbent"]
+  s.email       = ["it_dept@crossroads.org.hk"]
+  s.homepage    = "http://www.crossroads.org.hk"
+  s.summary     = %q{Crossroads capistrano recipes}
+  s.description = %q{A Crossroads Foundation collection of generic capistrano recipes.}
+
+  s.rubyforge_project = "crossroads_capistrano"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/crossroads_capistrano.rb

@@ -0,0 +1,17 @@
+module CrossroadsCapistrano
+  @@cap_config = Capistrano::Configuration.instance(:must_exist)
+  class << self  
+    def load_recipes(recipes)
+      @@cap_config.load do
+        if recipes == :all
+          # Load all available recipes.
+          Dir.glob(File.join(File.dirname(__FILE__), 'crossroads_capistrano', '*.rb')).each{|f| load f}
+        else
+          # Load each specified recipe.
+          recipes.each {|r| load File.join(File.dirname(__FILE__),'crossroads_capistrano',"#{r}.rb")}
+        end
+      end
+    end
+  end
+end
+

data/lib/crossroads_capistrano/delayed_job.rb

@@ -0,0 +1,21 @@
+namespace :delayed_job do
+  desc "Stop the delayed_job process"
+  task :stop, :roles => :app do
+    run "cd #{current_path}; RAILS_ENV=production script/delayed_job stop"
+  end
+
+  desc "Start the delayed_job process"
+  task :start, :roles => :app do
+    run "cd #{current_path}; RAILS_ENV=production script/delayed_job start"
+  end
+
+  desc "Restart the delayed_job process"
+  task :restart, :roles => :app do
+    run "cd #{current_path}; RAILS_ENV=production script/delayed_job restart"
+  end
+
+  desc "delayed_job status"
+  task :status, :roles => :app do
+    run "ps aux | grep 'delayed_job'"
+  end
+end

data/lib/crossroads_capistrano/log.rb

@@ -0,0 +1,12 @@
+namespace :log do
+
+  desc "tail production log files"
+  task :tail, :roles => :app do
+    run "tail -f #{shared_path}/log/production.log" do |channel, stream, data|
+      puts  # for an extra line break before the host name
+      puts "#{channel[:host]}: #{data}"
+      break if stream == :err
+    end
+  end
+
+end

data/lib/crossroads_capistrano/newrelic.rb

@@ -0,0 +1,14 @@
+namespace :newrelic do
+
+  task :default do
+    newrelic.yml
+  end
+
+  desc "Copy newrelic.yml"
+  task :yml do
+    run "ln -sf #{deploy_to}/shared/config/newrelic.yml #{release_path}/config/newrelic.yml"
+  end
+
+end
+
+before "deploy:symlink", "newrelic:yml"

data/lib/crossroads_capistrano/passenger.rb

@@ -0,0 +1,49 @@
+#
+# Adds passenger tasks to deploy stack
+#
+# Ensure the following variables are set in your deploy.rb
+#   - set :ip_address, "127.0.0.1"
+#   - set :site_domain_name, "www.example.com"
+#   - set :passenger_version, "3.0.0"
+#
+# And that the following files exist:
+#
+# config/httpd-rails.conf
+# config/passenger.conf
+#
+
+namespace :deploy do
+
+  %w(start stop restart reload).each do |t|
+    desc "#{t.capitalize} passenger using httpd"
+    task "#{t.to_sym}", :roles => :app, :except => { :no_release => true } do
+      run "/etc/init.d/httpd #{t}"
+    end
+  end
+
+end
+
+namespace :passenger do
+
+  desc "Install Passenger"
+  task :install, :roles => :web do
+    install_deps
+
+    run "gem install passenger --no-rdoc --no-ri --version #{passenger_version}"
+    run "passenger-install-apache2-module --auto"
+  end
+
+  task :install_deps, :roles => :web do
+    yum.install( {:base => %w(curl-devel httpd-devel apr-devel)}, :stable )
+  end
+
+  desc "Apache config files"
+  task :config, :roles => :web do
+    run "sed -e 's,@DEPLOY_TO@,#{deploy_to},g' -e 's,@IP_ADDR@,#{ip_address},g' -e 's,@SERVER_NAME@,#{site_domain_name},g' #{release_path}/config/httpd-rails.conf > /etc/httpd/sites-enabled/010-#{application}-#{stage}.conf"
+    run "sed -e 's,@RVM_RUBY_STRING@,#{rvm_ruby_string},g' -e 's,@PASSENGER_VERSION@,#{passenger_version},g' #{release_path}/config/passenger.conf > /etc/httpd/mods-enabled/passenger.conf"
+  end
+
+end
+
+before "deploy:cold",        "passenger:install"
+after  "deploy:update_code", "passenger:config"

data/lib/crossroads_capistrano/postgresql.rb

@@ -0,0 +1,29 @@
+namespace :postgresql do
+
+  task :symlink do
+    sudo "ln -sf #{deploy_to}/shared/config/database.yml #{release_path}/config/database.yml"
+  end
+
+  desc "Start PostgreSQL"
+  task :start, :roles => :db do
+    send(run_method, "/etc/init.d/postgresql start")
+  end
+
+  desc "Stop PostgreSQL"
+  task :stop, :roles => :db do
+    send(run_method, "/etc/init.d/postgresql stop")
+  end
+
+  desc "Restart PostgreSQL"
+  task :restart, :roles => :db do
+    send(run_method, "/etc/init.d/postgresql restart")
+  end
+
+  desc "Reload PostgreSQL"
+  task :reload, :roles => :db do
+    send(run_method, "/etc/init.d/postgresql reload")
+  end
+
+end
+
+after "deploy:update_code", "postgresql:symlink"

data/lib/crossroads_capistrano/prompt.rb

@@ -0,0 +1,12 @@
+# Helper function which prompts for user input, if none selected the returned
+# variable is set to the default.
+# 'prompt'  -> user prompt
+# 'var'     -> variable
+# 'default' -> default value set if no user input is received.
+
+def prompt_with_default(prompt, var, default)
+  set(var) do
+    Capistrano::CLI.ui.ask "#{prompt} [#{default}]: "
+  end
+  set var, default if eval("#{var.to_s}.empty?")
+end

data/lib/crossroads_capistrano/rvm.rb

@@ -0,0 +1,17 @@
+namespace :rvm do
+
+  desc "Install rvm"
+  task :install, :roles => :web do
+    install_deps
+
+    #~ run "if ! (which rvm); then curl -L http://bit.ly/rvm-install-system-wide | bash; fi"
+    run "if ! (rvm list | grep #{rvm_ruby_string}); then rvm install #{rvm_ruby_string}; fi"
+  end
+
+  task :install_deps, :roles => :web do
+    yum.install( {:base => %w(curl git gcc-c++ patch readline readline-devel zlib zlib-devel libyaml-devel libffi-devel)}, :stable )
+  end
+
+end
+
+before "deploy:cold", "rvm:install"

data/lib/crossroads_capistrano/stack.rb

@@ -0,0 +1,57 @@
+require File.expand_path('../yum', __FILE__)
+
+#
+# Capistrano recipes for cold deployments
+#
+# Usage (add the following to your deploy.rb):
+#
+#    load 'recipes/stack'
+#    set :gems_for_project, ""
+#    ...
+#
+#    Then just run "cap deploy:cold" and this stack will hook into it
+#
+
+namespace :stack do
+
+  # Override this if you don't want particular stack items
+  desc "Setup operating system and rails environment"
+  task :default do
+    yum.update
+    yum.install( {:base => packages_for_project}, :stable ) if packages_for_project
+    gems
+
+    deploy.setup
+    shared.setup
+  end
+
+  desc "Install required gems"
+  task :gems do
+    run "gem install #{gems_for_project} --no-rdoc --no-ri"
+  end
+
+end
+
+namespace 'shared' do
+
+  desc "Setup shared directory"
+  task :setup do
+    sudo "mkdir -p #{deploy_to}/shared/config"
+  end
+
+  desc "Setting proper permissions on shared directory"
+  task :permissions do
+    run "chown -R apache:apache #{deploy_to}/shared/"
+    #~ run "chmod -R 755 #{deploy_to}/shared/"
+    # during deployments
+    run "if [ -d #{release_path}/ ]; then chown -R apache:apache #{release_path}/; fi"
+    run "if [ -d #{release_path}/ ]; then chmod -R 755 #{release_path}/; fi"
+  end
+
+end
+
+#
+# Hooks
+#
+before "deploy:cold",        "stack"
+before "deploy:symlink",     "shared:permissions"

data/lib/crossroads_capistrano/whenever.rb

@@ -0,0 +1,12 @@
+#
+# Updates the crontab using wheneverize
+#
+
+after "deploy:symlink", "deploy:update_crontab"
+
+namespace :deploy do
+  desc "Update the crontab file"
+  task :update_crontab, :roles => :db do
+    run "cd #{current_path} && bundle exec whenever --update-crontab #{application}"
+  end
+end

data/lib/crossroads_capistrano/yum.rb

@@ -0,0 +1,66 @@
+require 'capistrano'
+
+# = Purpose
+# yum is a Capistrano plugin module providing a set of methods
+# that invoke the *yum* package manager (as used in Centos)
+#
+# Installs within Capistrano as the plugin _yum_.
+#
+# =Usage
+#
+#    require 'recipes/yum'
+#
+# Prefix all calls to the library with <tt>yum.</tt>
+#
+module Yum
+
+  # Default yum command - reduces any interactivity to the minimum.
+  YUM_COMMAND="yum -y"
+
+  # Run the yum install program across the package list in 'packages'.
+  # Select those packages referenced by <tt>:base</tt> and the +version+
+  # of the distribution you want to use.
+  def install(packages, version, options={})
+    special_options = options[:repositories].collect { |repository| " --enablerepo=#{repository}"} if (options && options[:repositories].is_a?(Array))
+    send(run_method, %{
+      sh -c "#{YUM_COMMAND} #{special_options.to_s} install #{package_list(packages, version)}"
+    }, options)
+  end
+
+  # Run a yum clean
+  def clean(options={})
+    send(run_method, %{sh -c "#{YUM_COMMAND} -qy clean"}, options)
+  end
+
+  # Run a yum autoclean
+  def autoclean(options={})
+    send(run_method, %{sh -c "#{YUM_COMMAND} -qy autoclean"}, options)
+  end
+
+  # Run a yum distribution upgrade
+  def dist_upgrade(options={})
+    send(run_method, %{sh -c "#{YUM_COMMAND} -qy dist-upgrade"}, options)
+  end
+
+  # Run a yum upgrade. Use dist_upgrade instead if you want to upgrade
+  # the critical base packages.
+  def upgrade(options={})
+    send(run_method, %{sh -c "#{YUM_COMMAND} -qy upgrade"}, options)
+  end
+
+  # Run a yum update.
+  def update(options={})
+    send(run_method, %{sh -c "#{YUM_COMMAND} -qy update"}, options)
+  end
+
+private
+
+  # Provides a string containing all the package names in the base
+  #list plus those in +version+.
+  def package_list(packages, version)
+    packages[:base].to_a.join(' ') + ' ' + packages[version].to_a.join(' ')
+  end
+
+end
+
+Capistrano.plugin :yum, Yum

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification 
+name: crossroads_capistrano
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 1
+  - 0
+  version: 1.1.0
+platform: ruby
+authors: 
+- Steve Kenworthy
+- Ben Tillman
+- Nathan Broadbent
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-22 00:00:00 +08:00
+default_executable: 
+dependencies: []
+
+description: A Crossroads Foundation collection of generic capistrano recipes.
+email: 
+- it_dept@crossroads.org.hk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.textile
+- Rakefile
+- crossroads_capistrano.gemspec
+- lib/crossroads_capistrano.rb
+- lib/crossroads_capistrano/delayed_job.rb
+- lib/crossroads_capistrano/log.rb
+- lib/crossroads_capistrano/newrelic.rb
+- lib/crossroads_capistrano/passenger.rb
+- lib/crossroads_capistrano/postgresql.rb
+- lib/crossroads_capistrano/prompt.rb
+- lib/crossroads_capistrano/rvm.rb
+- lib/crossroads_capistrano/stack.rb
+- lib/crossroads_capistrano/whenever.rb
+- lib/crossroads_capistrano/yum.rb
+has_rdoc: true
+homepage: http://www.crossroads.org.hk
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: crossroads_capistrano
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Crossroads capistrano recipes
+test_files: []
+