capistrano-zen 0.0.2

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Capfile-rails.sample

@@ -0,0 +1,51 @@
+# default capistrano tasks
+load 'deploy'
+load 'deploy/assets'
+
+# the database.yml path
+set :pg_config_path, File.expand_path(File.dirname(__FILE__), 'config')
+
+# load the recipes
+require 'capistrano-zen/utils'
+require 'capistrano-zen/nginx'
+require 'capistrano-zen/postgresql'
+require 'capistrano-zen/rbenv'
+require 'capistrano-zen/unicorn'
+
+# Use Git as Version Control System
+set :scm, :git
+set :repository, "git@github.com:zenhacks/some_application.git"
+set :branch, 'master'
+
+# enable prompt for password
+default_run_options[:pty] = true
+
+# access github.com using as the local user
+ssh_options[:forward_agent] = true
+
+set :application, 'my_application'
+
+set :domain, "domain.com"
+
+server 'domain.com', :web, :app, :db, :primary => true
+
+set :user, 'deploy'
+set :group, 'deploy'
+set :deploy_to, "/home/#{user}/repositories/#{application}-production"
+
+
+## Deploy Dependencies
+after "deploy:install",
+  "nginx:install",
+  "nodejs:install",
+  "rbenv:install",
+  "dev_lib:install",
+  "pg:install"
+
+after "deploy:setup",
+  "nginx:setup",
+  "pg:setup",
+  "pg:init",
+  "unicorn:setup"
+
+after "deploy:finalize_update", "pg:symlink"

data/Capfile-static.sample

@@ -0,0 +1,52 @@
+require 'capistrano-zen/nginx'
+
+# enable prompt for password
+default_run_options[:pty] = true
+
+# try_sudo will not use sudo by default
+set :use_sudo, false
+
+# access github.com using as the local user
+ssh_options[:forward_agent] = true
+
+set :application, "application name"
+
+set :domain, "domain.com"
+
+# maxwell - 42.121.82.106, aliyun,hangzhou
+server 'server_name', :web, :app, :db, :primary => true
+
+set :user, 'deploy'
+set :deploy_to, "/home/#{user}/sites/#{application}-production"
+
+namespace :deploy do
+  desc "Deploys your project. This calls both `update' and `nginx.restart'. "
+  task :default, roles: :app do
+    update
+    nginx.restart
+  end
+
+  desc "Setup the directory for the application."
+  task :setup, roles: :app do
+    dirs = [deploy_to]
+    run "mkdir -p #{dirs.join(' ')}"
+    run "chmod g+w #{dirs.join(' ')}" if fetch(:group_writable, true)
+  end
+
+  desc "Update the dest code for this application."
+  task :update, roles: :app do
+    # your own deploy logic
+    
+    # sample for a middleman site
+    # system('bundle exec middleman build --clean')
+    # roles[:app].servers.each do |server|
+      # system("rsync -cuavz build/* #{user}@#{server}:#{deploy_to}")
+    # end
+  end
+end
+
+after "deploy:install",
+  "nginx:install"
+
+after "deploy:setup",
+  "nginx:setup:static"

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in capistrano-zen.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Steven Yang
+
+MIT License
+
+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.md

@@ -0,0 +1,156 @@
+## What Capistrano::Zen Is?
+`Capistrano-zen` is **a collection of capistrano recipes** to install and manage various services on production machine powered by Ubuntu. The current tested environment is Ubuntu 12.04LTS.
+
+It provides installation and management recipes for the following service:
+- nginx
+  - with config templates for rails app
+- nodejs
+- postgresql
+- unicorn (integrated with a nginx/railsapp)
+- rbenv
+
+The upcoming recipes include:
+- nginx
+  - global config template
+  - static website template
+- shorewall
+- vsftp
+- php-fpm
+- mysql
+- mongodb
+- redis
+
+`capistrano-zen` is extracted from the deployment procedure at [zenhacks.org](zenhacks.org) for a Rails application so it is designed to work with the structure of a rails application. But most recipes are independent and future development will detach general recipes from a rails application.
+
+## What Capistrano::Zen isn't?
+`capistrano-zen` only provides recipes of tasks, it doesn't handle:
+
+- the application dependencies
+- the logic of deployment logic
+- the server settings and configuration
+
+You will need to declare those in your own capistrano config file such as `Capfile` or `config/deploy.rb`.
+
+The gem includes some sample files to start with `Capfile-rails.sample`.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'capistrano-zen'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install capistrano-zen
+
+## Dependencies
+`capistrano-zen` uses `python-software-properties` to ease ppa source addition. You could install it with  use `python-software-properties` to ease ppa source addition. You could install it from your local machine with 
+
+    cap deploy:install
+
+Or install it mannually with 
+
+    sudo apt-get install python-software-properties
+
+## Usage
+
+To load a set of recipes, require them in your `Capfile` with:
+
+    require 'capistrano-zen/nginx'
+
+You could verify the load is successful with:
+
+    cap -T
+
+## Recipes
+Here is the recipes included in this gem:
+
+- nginx
+  - with config templates for rails app
+- nodejs
+- postgresql
+- unicorn (integrated with a nginx/railsapp)
+- rbenv
+
+### Nginx
+Default role: `web`
+
+Configuration variables: none
+
+Tasks:
+- `nginx:install` installs the lastest release from the ppa `ppa:nginx/stable`.
+- `nginx:start/stop/reload` maps to `sudo service nginx start/stop/reload` on the remote machine.
+- `nginx:setup` generates a nginx site configuration for a rails app runs with `unicorn` through unix socket.
+
+### NodeJS
+Default role: `app`
+
+Configuration variables: none
+
+Tasks:
+- `nodejs:install` installs `node` and `npm` from the `ppa:chris-lea/node.js`.
+
+The ppa comes from [official wiki](https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager).
+
+### Rbenv
+It uses the [rbenv installer](https://github.com/fesplugas/rbenv-installer) to create a `ruby` environment.
+
+Default role: `app`
+
+Configuration variables:
+- `ruby_version` indicates the ruby version installed.
+- `rbenv_bootstrap` indicates the ubuntu version to install the rbenv bootstrap.
+
+Tasks:
+- `rbenv:install` installs `rbenv`, setups configuration in `~/.bashrc` and installs `ruby` with `ruby_version`
+- `rbenv:patch` autoruns a ruby patch to enhance performance. [more info](https://gist.github.com/1688857?utm_source=rubyweekly&utm_medium=email)
+
+### PostgreSQL
+Currently, postgresql configuration is tightly attached to a rails application, it depends on the `config/database.yml` to setup remote server.
+
+Default role: `db`
+
+Configuration variables:
+- `pg_config_path` the path for the `database.yml` file, the recipe reads from it to create database and generate remote `database.yml`. If you are using this recipe out of Rails application, store your configuration in a `config/database.yml`. 
+- `pg_backup_path` the path to store database dumps.
+
+Tasks:
+- `pg:install` installs `postgresql` and `libpg-dev` from `ppa:pitti/postgresql`.
+- `pg:reset` drops the databases and roles with the same names as in the application.
+- `pg:init` generates roles and databases for the rails application.
+- `pg:setup` generates remote `database.yml` based on local `database.yml`'s `production` settings.
+- `pg:symlink` creates symbolic for the `database.yml` in the release.
+- `pg:dump` dumps and compresses the application database, store them in the `pg_backup_path`.
+- `pg:restore` prompts and restores selected dumps from the `pg_backup_path`, it defaults to lastest dump.
+
+### Unicorn
+This recipes setup unicorn configuration based on current rails application, and generate a `init.d` control scripts to manage the service.
+Default role: `app`
+
+Configuration variables: 
+- `unicorn_user` the user to run unicorn process, default to the same user as remote login user.
+- `unicorn_group` the group to run unicorn process.
+- `unicorn_pid` the path for the `unicorn.pid` file, default to the `current/tmp/pids/unicorn.pid`.
+- `unicorn_config` the path to put the unicorn config file, default to `shared/config/unicorn.rb`.
+- `unicorn_log` the path to put the unicorn log file, default to `shared/log/unicorn.log`.
+- `unicorn_workers` the number of unicorn workers, default to 4.
+
+Tasks: 
+- `unicorn:setup` generate `unicorn.rb` config file and register `service` with `unicorn_init`.
+- `unicorn:start/stop/restart/upgrade/force-stop` maps to remote `service unicorn start/stop/restart/upgrade/force-stop`. Details is in `/tmpls/unicorn_init.rb`
+
+### Utils
+- `check:revision` autoruns before any deployment tasks. It compares the local and remote master branch head to make sure remote master branch are up-to-date.
+- `dev_lib:install` install libraries on which some gems depend such as `nokogiri` or `paperclip`.
+
+## Get Started with Capistrano
+The [wiki page](https://github.com/capistrano/capistrano/wiki) of `capistrano` has good resources to make you up to speed.
+[Railscasts](http://railscasts.com/episodes?utf8=%E2%9C%93&search=capistrano) also has a good coverage for this tool.
+
+## TODO
+- make configuration rails-less
+- add more recipes

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/capistrano-zen.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'capistrano-zen/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "capistrano-zen"
+  gem.version       = Capistrano::Zen::VERSION
+  gem.authors       = ["Steven Yang"]
+  gem.email         = ["yangchenyun@gmail.com"]
+  gem.description   = %q{Capistrano Recipes used at zenhacks.org.}
+  gem.summary       = %q{Nginx, Unicorn, PostgreSQL, NodeJS Recipes install on a machine running Ubuntu. }
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+  gem.extra_rdoc_files = [
+    "LICENSE"
+  ]
+
+  gem.add_dependency "capistrano", ">= 2.5.3"
+end

data/lib/capistrano-zen/base.rb

@@ -0,0 +1,15 @@
+require 'capistrano-zen/common'
+
+configuration = Capistrano::Configuration.respond_to?(:instance) ?
+  Capistrano::Configuration.instance(:must_exist) :
+  Capistrano.configuration(:must_exist)
+
+configuration.load do
+  namespace :deploy do
+    desc "Install everything onto the server"
+    task :install do
+      run "#{sudo} apt-get -y update"
+      run "#{sudo} apt-get -y install python-software-properties"
+    end
+  end
+end

data/lib/capistrano-zen/common.rb

@@ -0,0 +1,10 @@
+def _cset(name, *args, &block)
+  unless exists?(name)
+    set(name, *args, &block)
+  end
+end
+
+def template(from, to)
+  erb = File.read(File.expand_path("../tmpls/#{from}", __FILE__))
+  put ERB.new(erb).result(binding), to
+end

data/lib/capistrano-zen/nginx.rb

@@ -0,0 +1,40 @@
+require 'capistrano-zen/base'
+
+configuration = Capistrano::Configuration.respond_to?(:instance) ?
+  Capistrano::Configuration.instance(:must_exist) :
+  Capistrano.configuration(:must_exist)
+
+configuration.load do
+  namespace :nginx do
+    desc "Install latest stable release of nginx"
+    task :install, roles: :web do
+      run "#{sudo} add-apt-repository -y ppa:nginx/stable"
+      run "#{sudo} apt-get -y update"
+      run "#{sudo} apt-get -y install nginx"
+      run "#{sudo} rm -f /etc/nginx/sites-enabled/default"
+    end
+
+    namespace :setup do
+      desc "Setup nginx configuration for unicorn application"
+      task :unicorn, roles: :web do
+        template "nginx_unicorn.erb", "/tmp/nginx_conf"
+        run "#{sudo} mv /tmp/nginx_conf /etc/nginx/sites-enabled/#{application}"
+        restart
+      end
+
+      desc "Setup nginx configuration for static website"
+      task :static, roles: :web do
+        template "nginx_static.erb", "/tmp/nginx_conf"
+        run "#{sudo} mv /tmp/nginx_conf /etc/nginx/sites-enabled/#{application}"
+        restart
+      end
+    end
+
+    %w[start stop restart reload].each do |command|
+      desc "#{command} nginx"
+      task command, roles: :web do
+        run "#{sudo} service nginx #{command}"
+      end
+    end
+  end
+end

data/lib/capistrano-zen/nodejs.rb

@@ -0,0 +1,18 @@
+require 'capistrano-zen/base'
+
+configuration = Capistrano::Configuration.respond_to?(:instance) ?
+  Capistrano::Configuration.instance(:must_exist) :
+  Capistrano.configuration(:must_exist)
+
+configuration.load do
+  namespace :nodejs do
+    desc "Install the latest relase of Node.js"
+    # Reference
+    # https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager
+    task :install, roles: :app do
+      run "#{sudo} add-apt-repository -y ppa:chris-lea/node.js"
+      run "#{sudo} apt-get -y update"
+      run "#{sudo} apt-get -y install nodejs npm"
+    end
+  end
+end

data/lib/capistrano-zen/postgresql.rb

@@ -0,0 +1,81 @@
+require 'capistrano-zen/base'
+require 'yaml'
+
+configuration = Capistrano::Configuration.respond_to?(:instance) ?
+  Capistrano::Configuration.instance(:must_exist) :
+  Capistrano.configuration(:must_exist)
+
+configuration.load do
+
+  _cset(:pg_config_path) { abort "[Error] posgtresql recipes need `pg_config_path` to find the database.yml file." }
+  _cset(:pg_backup_path) { abort "[Error] posgtresql recipes need `pg_backup_path` to execute backups." }
+
+  DB_FILE_PATH = "#{pg_config_path}/database.yml"
+  DBCONFIG = YAML.load_file(DB_FILE_PATH)
+
+  _cset(:psql_host) { DBCONFIG['production']['host'] }
+  _cset(:psql_user) { DBCONFIG['production']['username'] }
+  _cset(:psql_password) { DBCONFIG['production']['password'] }
+  _cset(:psql_database) { DBCONFIG['production']['database'] }
+
+  namespace :pg do
+    desc "Install the latest stable release of psql."
+    task :install, roles: :db, only: {primary: true} do
+      run "#{sudo} add-apt-repository -y ppa:pitti/psql"
+      run "#{sudo} apt-get -y update"
+      run "#{sudo} apt-get -y install psql libpq-dev"
+    end
+
+    desc "Create a database for this application."
+    task :init, roles: :db, only: { primary: true } do
+      # reset the database and role
+      run %Q{#{sudo} -u postgres psql -c "CREATE USER #{psql_user} WITH PASSWORD '#{psql_password}';"}
+      run %Q{#{sudo} -u postgres psql -c "CREATE DATABASE #{psql_database} OWNER #{psql_user};"}
+    end
+
+    desc "Reset the database and role for this application."
+    task :reset, roles: :db, only: { primary: true } do
+      # drop the database and role
+      run %Q{#{sudo} -u postgres psql -c "DROP DATABASE #{psql_database};"}
+      run %Q{#{sudo} -u postgres psql -c "DROP ROLE #{psql_user};"}
+    end
+
+    desc "Generate the database.yml configuration file."
+    task :setup, roles: :app do
+      run "mkdir -p #{shared_path}/config"
+      template "postgresql.yml.erb", "#{shared_path}/config/database.yml"
+      # init backup directory
+      run "#{sudo} mkdir -p #{pg_backup_path}"
+      run "#{sudo} chown :#{group} #{pg_backup_path}"
+      run "#{sudo} chmod g+w #{pg_backup_path}"
+    end
+
+    desc "Symlink the database.yml file into latest release"
+    task :symlink, roles: :app do
+      run "ln -nfs #{shared_path}/config/database.yml #{release_path}/config/database.yml"
+    end
+
+    desc "Dump the application's database to backup path."
+    task :dump, roles: :db, only: { primary: true } do
+      # ignore migrations / exclude ownership / clean restore
+      run "pg_dump #{psql_database} -T '*migrations' -O -c -U #{psql_user} -h #{psql_host} | gzip > #{pg_backup_path}/#{application}-#{release_name}.sql.gz" do |channel, stream, data|
+        puts data if data.length >= 3
+        channel.send_data("#{psql_password}\n") if data.include? 'Password'
+      end
+    end
+
+    desc "Restore the application's database from dump files."
+    task :restore, roles: :db, only: { primary: true } do
+      backups = capture("ls -x #{pg_backup_path}").split.sort
+      default_backup = backups.last
+      puts "Available backups: "
+      puts backups
+      backup = Capistrano::CLI.ui.ask "Which backup would you like to restore? [#{default_backup}] "
+      backup = backups.last if backup.empty?
+      run "gunzip -c #{pg_backup_path}/#{backup} | psql -d #{psql_database} -U #{psql_user} -h #{psql_host}" do |channel, stream, data|
+        puts data if data.length >= 3
+        channel.send_data("#{psql_password}\n") if data.include? 'Password'
+      end
+    end
+  end
+end

data/lib/capistrano-zen/rbenv.rb

@@ -0,0 +1,52 @@
+require 'capistrano-zen/base'
+
+configuration = Capistrano::Configuration.respond_to?(:instance) ?
+  Capistrano::Configuration.instance(:must_exist) :
+  Capistrano.configuration(:must_exist)
+
+configuration.load do
+  _cset :ruby_version, "1.9.3-p194"
+  _cset :rbenv_bootstrap, "bootstrap-ubuntu-12-04"
+  _cset(:root_password) { Capistrano::CLI.password_prompt "Root Password: " }
+
+  # https://github.com/fesplugas/rbenv-installer
+  namespace :rbenv do
+    desc "Install rbenv, Ruby, and the Bundler gem"
+    task :install, roles: :app do
+      run "#{sudo} apt-get -y install curl git-core"
+      run "curl -L https://raw.github.com/fesplugas/rbenv-installer/master/bin/rbenv-installer | bash"
+      # FIXME run command to change download path to taobao
+      bashrc = <<-BASHRC
+  if [ -d $HOME/.rbenv ]; then
+  export PATH="$HOME/.rbenv/bin:$PATH"
+  eval "$(rbenv init -)"
+  fi
+  BASHRC
+      put bashrc, "/tmp/rbenvrc"
+      run "cat /tmp/rbenvrc ~/.bashrc > ~/.bashrc.tmp"
+      run "mv ~/.bashrc.tmp ~/.bashrc"
+      run "rm /tmp/rbenvrc"
+      run "rbenv #{rbenv_bootstrap}" do |channel, stream, data|
+        puts data if data.length >= 3
+        channel.send_data("#{root_password}\n") if data.include? 'password'
+      end
+      run "rbenv install #{ruby_version}"
+      run "rbenv global #{ruby_version}"
+    end
+
+    task :patch, roles: :app do
+      # the performance patch
+      # https://gist.github.com/1688857?utm_source=rubyweekly&utm_medium=email
+      run "#{sudo} apt-get -y install autoconf"
+      case "#{ruby_version}"
+      when "1.9.3-p194"
+        run "curl https://raw.github.com/gist/1688857/rbenv.sh | sh ; rbenv global 1.9.3-p194-perf"
+      when "1.9.3-p286"
+        run "curl https://raw.github.com/gist/3885178/rbenv.sh | sh ; rbenv global 1.9.3-p286-perf"
+      end
+      run "gem install bundler --no-ri --no-rdoc"
+      run "rbenv rehash"
+    end
+    after "rbenv:install", "rbenv:patch"
+  end
+end

data/lib/capistrano-zen/tmpls/nginx_static.erb

@@ -0,0 +1,12 @@
+server {
+  listen 80;
+  server_name <%= domain %>;
+
+  root <%= deploy_to %>;
+  gzip_static on;
+
+  access_log  /var/log/nginx/<%= application %>-access.log;
+  error_log  /var/log/nginx/<%= application %>-error.log;
+
+  error_page  500 502 503 504 /500.html;
+}

data/lib/capistrano-zen/tmpls/nginx_unicorn.erb

@@ -0,0 +1,33 @@
+upstream <%= application %>_unicorn {
+  server unix:/tmp/unicorn.<%= application %>.sock fail_timeout=0;
+}
+
+server {
+  listen 80;
+  server_name <%= domain %>;
+
+  access_log  /var/log/nginx/<%= application %>-access.log;
+  error_log  /var/log/nginx/<%= application %>-error.log;
+
+  root <%= current_path %>/public;
+
+  location ^~ /assets/ {
+    gzip_static on;
+    expires max;
+    add_header Cache-Control public;
+  }
+
+  # try to serve static file first
+  try_files $uri/index.html $uri @unicorn;
+
+  location @unicorn {
+    proxy_set_header Host $http_host;
+    proxy_set_header X-Forward-For $proxy_add_x_forwarded_for;
+    proxy_redirect off;
+    proxy_pass http://<%= application %>_unicorn;
+  }
+
+  error_page  500 502 503 504 /500.html;
+  client_max_body_size 100M;
+  keepalive_timeout 10;
+}

data/lib/capistrano-zen/tmpls/postgresql.yml.erb

@@ -0,0 +1,8 @@
+production:
+  adapter: postgresql
+  encoding: unicode
+  database: <%= psql_database %>
+  pool: 5
+  username: <%= psql_user %>
+  password: <%= psql_password %>
+  host: <%= psql_host %>

data/lib/capistrano-zen/tmpls/unicorn.rb.erb

@@ -0,0 +1,89 @@
+RAILS_ENV = ENV['RAILS_ENV'] || 'production'
+
+# unicorn workers
+worker_processes <%= unicorn_workers %>
+
+# FIXME problems here
+# working_directory "<%= current_path %>"
+
+# Load rails+github.git into the master before forking workers
+# for super-fast worker spawn times
+preload_app true
+
+# Restart any workers that haven't responded in 30 seconds
+timeout 30
+
+pid "<%= unicorn_pid %>"
+stderr_path "<%= current_path %>/log/unicorn.stderr.log"
+stdout_path "<%= current_path %>/log/unicorn.stdout.log"
+
+# Listen on a Unix data socket
+listen '/tmp/unicorn.<%= application %>.sock', :backlog => 2048
+
+##
+# REE
+
+# http://www.rubyenterpriseedition.com/faq.html#adapt_apps_for_cow
+if GC.respond_to?(:copy_on_write_friendly=)
+    GC.copy_on_write_friendly = true
+end
+
+
+before_fork do |server, worker|
+    ##
+    # When sent a USR2, Unicorn will suffix its pidfile with .oldbin and
+    # immediately start loading up a new version of itself (loaded with a new
+    # version of our app). When this new Unicorn is completely loaded
+    # it will begin spawning workers. The first worker spawned will check to
+    # see if an .oldbin pidfile exists. If so, this means we've just booted up
+    # a new Unicorn and need to tell the old one that it can now die. To do so
+    # we send it a QUIT.
+    #
+    # Using this method we get 0 downtime deploys.
+
+    old_pid = '<%= unicorn_pid %>.oldbin'
+    if File.exists?(old_pid) && server.pid != old_pid
+        begin
+            Process.kill("QUIT", File.read(old_pid).to_i)
+        rescue Errno::ENOENT, Errno::ESRCH
+            # someone else did our job for us
+        end
+    end
+end
+
+
+after_fork do |server, worker|
+    ##
+    # Unicorn master loads the app then forks off workers - because of the way
+    # Unix forking works, we need to make sure we aren't using any of the parent's
+    # sockets, e.g. db connection
+
+    ActiveRecord::Base.establish_connection
+#    CHIMNEY.client.connect_to_server
+    # Redis and Memcached would go here but their connections are established
+    # on demand, so the master never opens a socket
+
+
+    ##
+    # Unicorn master is started as root, which is fine, but let's
+    # drop the workers to deploy:deploy
+
+    begin
+        uid, gid = Process.euid, Process.egid
+        user, group = '<%= unicorn_user %>', '<%= unicorn_group %>'
+        target_uid = Etc.getpwnam(user).uid
+        target_gid = Etc.getgrnam(group).gid
+        worker.tmp.chown(target_uid, target_gid)
+        if uid != target_uid || gid != target_gid
+            Process.initgroups(user, target_gid)
+            Process::GID.change_privilege(target_gid)
+            Process::UID.change_privilege(target_uid)
+        end
+    rescue => e
+        if RAILS_ENV == 'development'
+            STDERR.puts "couldn't change user, oh well"
+        else
+            raise e
+        end
+    end
+end

data/lib/capistrano-zen/tmpls/unicorn_init.erb

@@ -0,0 +1,84 @@
+#!/bin/sh
+### BEGIN INIT INFO
+# Provides:          unicorn
+# Required-Start:    $remote_fs $syslog
+# Required-Stop:     $remote_fs $syslog
+# Default-Start:     2 3 4 5
+# Default-Stop:      0 1 6
+# Short-Description: Manage unicorn server
+# Description:       Start, stop, restart unicorn server for a specific application.
+### END INIT INFO
+set -e
+
+# Feel free to change any of the following variables for your app:
+TIMEOUT=${TIMEOUT-60}
+APP_ROOT=<%= current_path %>
+PID=<%= unicorn_pid %>
+CMD="cd <%= current_path %>; bundle exec unicorn -D -c <%= unicorn_config %> -E production"
+AS_USER=<%= unicorn_user %>
+set -u
+
+OLD_PIN="$PID.oldbin"
+
+sig () {
+  test -s "$PID" && kill -$1 `cat $PID`
+}
+
+oldsig () {
+  test -s $OLD_PIN && kill -$1 `cat $OLD_PIN`
+}
+
+run () {
+  if [ "$(id -un)" = "$AS_USER" ]; then
+    eval $1
+  else
+    su -c "$1" - $AS_USER
+  fi
+}
+
+case "$1" in
+start)
+  sig 0 && echo >&2 "Already running" && exit 0
+  run "$CMD"
+  ;;
+stop)
+  sig QUIT && exit 0
+  echo >&2 "Not running"
+  ;;
+force-stop)
+  sig TERM && exit 0
+  echo >&2 "Not running"
+  ;;
+restart|reload)
+  sig HUP && echo reloaded OK && exit 0
+  echo >&2 "Couldn't reload, starting '$CMD' instead"
+  run "$CMD"
+  ;;
+upgrade)
+  if sig USR2 && sleep 2 && sig 0 && oldsig QUIT
+  then
+    n=$TIMEOUT
+    while test -s $OLD_PIN && test $n -ge 0
+    do
+      printf '.' && sleep 1 && n=$(( $n - 1 ))
+    done
+    echo
+
+    if test $n -lt 0 && test -s $OLD_PIN
+    then
+      echo >&2 "$OLD_PIN still exists after $TIMEOUT seconds"
+      exit 1
+    fi
+    exit 0
+  fi
+  echo >&2 "Couldn't upgrade, starting '$CMD' instead"
+  run "$CMD"
+  ;;
+reopen-logs)
+  sig USR1
+  ;;
+*)
+  echo >&2 "Usage: $0 <start|stop|restart|upgrade|force-stop|reopen-logs>"
+  exit 1
+  ;;
+esac

data/lib/capistrano-zen/unicorn.rb

@@ -0,0 +1,34 @@
+require 'capistrano-zen/base'
+
+configuration = Capistrano::Configuration.respond_to?(:instance) ?
+  Capistrano::Configuration.instance(:must_exist) :
+  Capistrano.configuration(:must_exist)
+
+configuration.load do
+  _cset(:unicorn_user) { user }
+  _cset(:unicorn_group) { group }
+  _cset(:unicorn_pid) { "#{current_path}/tmp/pids/unicorn.pid" }
+  _cset(:unicorn_config) { "#{shared_path}/config/unicorn.rb" }
+  _cset(:unicorn_log) { "#{shared_path}/log/unicorn.log" }
+  _cset(:unicorn_workers, 4)
+
+  namespace :unicorn do
+    desc "Setup Unicorn initializer and app configuration"
+    task :setup, roles: :app do
+      run "mkdir -p #{shared_path}/config"
+      template "unicorn.rb.erb", unicorn_config
+      template "unicorn_init.erb", "/tmp/unicorn_init"
+      run "chmod +x /tmp/unicorn_init"
+      run "#{sudo} mv /tmp/unicorn_init /etc/init.d/unicorn_#{application}"
+      run "#{sudo} update-rc.d -f unicorn_#{application} defaults"
+    end
+
+    %w[start stop restart upgrade force-stop].each do |command|
+      desc "#{command} unicorn"
+      task command, roles: :app do
+        run "service unicorn_#{application} #{command}"
+      end
+      after "deploy:#{command}", "unicorn:#{command}"
+    end
+  end
+end

data/lib/capistrano-zen/utils.rb

@@ -0,0 +1,35 @@
+require 'capistrano-zen/base'
+
+configuration = Capistrano::Configuration.respond_to?(:instance) ?
+  Capistrano::Configuration.instance(:must_exist) :
+  Capistrano.configuration(:must_exist)
+
+configuration.load do
+  before "deploy", "check:revision"
+  before "deploy:migrations", "check:revision"
+  before "deploy:cold", "check:revision"
+
+  namespace :check do
+    desc "Make sure local git is in sync with remote."
+    task :revision do
+      unless `git rev-parse #{branch}` == `git rev-parse origin/#{branch}`
+        puts "WARNING: HEAD is not the same as origin/#{branch}"
+        puts "Run `git push` to sync changes."
+        exit
+      end
+    end
+  end
+
+  namespace :dev_lib do
+    task :install do
+      # nokogiri dependencies
+      run "#{sudo} apt-get -y install libxslt-dev libxml2-dev"
+
+      # paperclip dependencies
+      run "#{sudo} apt-get -y install imagemagick"
+
+      # sqlite3 dependencies
+      run "#{sudo} apt-get -y install libsqlite3-dev"
+    end
+  end
+end

data/lib/capistrano-zen/version.rb

@@ -0,0 +1,5 @@
+module Capistrano
+  module Zen
+    VERSION = "0.0.2"
+  end
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification
+name: capistrano-zen
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Steven Yang
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.5.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.5.3
+description: Capistrano Recipes used at zenhacks.org.
+email:
+- yangchenyun@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+files:
+- .gitignore
+- Capfile-rails.sample
+- Capfile-static.sample
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- capistrano-zen.gemspec
+- lib/capistrano-zen/base.rb
+- lib/capistrano-zen/common.rb
+- lib/capistrano-zen/nginx.rb
+- lib/capistrano-zen/nodejs.rb
+- lib/capistrano-zen/postgresql.rb
+- lib/capistrano-zen/rbenv.rb
+- lib/capistrano-zen/tmpls/nginx_static.erb
+- lib/capistrano-zen/tmpls/nginx_unicorn.erb
+- lib/capistrano-zen/tmpls/postgresql.yml.erb
+- lib/capistrano-zen/tmpls/unicorn.rb.erb
+- lib/capistrano-zen/tmpls/unicorn_init.erb
+- lib/capistrano-zen/unicorn.rb
+- lib/capistrano-zen/utils.rb
+- lib/capistrano-zen/version.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Nginx, Unicorn, PostgreSQL, NodeJS Recipes install on a machine running Ubuntu.
+test_files: []