alpha_omega 0.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+.bundle
+/vendor/bundle
+/current
+/releases
+/log
+/*.gem

data/Capfile

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+require 'etc'
+require 'recipes/alpha_omega/deploy'
+
+ssh_options[:forward_agent] = true
+
+set :application, File.basename(Dir.pwd)
+set :repository, "git://localhost/.git"
+
+set :user, Etc.getlogin
+set :group, Etc.getgrgid(Etc.getpwnam(Etc.getlogin).gid).name
+set :deploy_to, Dir.pwd
+set :releases, %w(alpha beta gamma omega)
+
+role :app, "localhost", :once => true, :shell => "/bin/bash"

data/Gemfile

@@ -0,0 +1,6 @@
+source :rubygems
+gem "capistrano", "2.5.21"
+gem "capistrano_colors"
+gem "capistrano-log_with_awesome"
+gem "foreman"
+gem "grit"

data/Gemfile.lock

@@ -0,0 +1,40 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    capistrano (2.5.21)
+      highline
+      net-scp (>= 1.0.0)
+      net-sftp (>= 2.0.0)
+      net-ssh (>= 2.0.14)
+      net-ssh-gateway (>= 1.0.0)
+    capistrano-log_with_awesome (0.0.2)
+      capistrano (>= 2.5.14)
+    capistrano_colors (0.5.4)
+    diff-lcs (1.1.2)
+    foreman (0.20.0)
+      term-ansicolor (~> 1.0.5)
+      thor (>= 0.13.6)
+    grit (2.4.1)
+      diff-lcs (~> 1.1)
+      mime-types (~> 1.15)
+    highline (1.6.2)
+    mime-types (1.16)
+    net-scp (1.0.4)
+      net-ssh (>= 1.99.1)
+    net-sftp (2.0.5)
+      net-ssh (>= 2.0.9)
+    net-ssh (2.2.0)
+    net-ssh-gateway (1.1.0)
+      net-ssh (>= 1.99.1)
+    term-ansicolor (1.0.6)
+    thor (0.14.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  capistrano (= 2.5.21)
+  capistrano-log_with_awesome
+  capistrano_colors
+  foreman
+  grit

data/LICENSE

@@ -0,0 +1,21 @@
+Licensed under the same terms and conditions as capistrano 2.5.21.
+
+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/Procfile

@@ -0,0 +1,5 @@
+git: git daemon --reuseaddr --base-path=. --export-all --verbose
+cap: bundle exec cap deploy
+rollback: bundle exec cap deploy:rollback
+stage: bundle exec cap deploy:update_code
+patch: bundle exec cap deploy

data/README.mkd

@@ -0,0 +1,46 @@
+History
+=======
+
+These capistrano deploy recipes came from capistrano 2.5.21.  Instead of
+forking capistrano itself, the recipes were copied to the alpha\_omega
+namespace and heavily altered to their present state.
+
+Getting Started
+===============
+
+figlet must be installed. Your local machine must let you ssh and run sudo
+without a password during the deploy.
+
+    bin/deploy
+    bin/deploy
+    bin/deploy
+    bin/deploy
+    bin/rollback
+    bin/stage
+    bin/deploy
+    bin/patch
+
+LICENSE
+-------
+
+Licensed under the same terms and conditions as capistrano 2.5.21.
+
+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/alpha_omega.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+#
+$:.push File.expand_path("../recipes", __FILE__)
+require "alpha_omega/version"
+
+Gem::Specification.new do |s|
+  s.name        = "alpha_omega"
+  s.version     = AlphaOmega::Version.to_s
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["David Nghiem", "Tom Bombadil"]
+  s.email       = ["nghidav@gmail.com", "amanibhavam@destructuring.org"]
+  s.homepage    = "https://github.com/HeSYINUvSBZfxqA/alpha_omega"
+  s.summary     = %q{alpha_omega capistrano recipes}
+  s.description = %q{Common reciples for persistent capistrano releases}
+  s.date        = %q{2011-08-31}
+  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 = ["recipes"]
+  s.extra_rdoc_files = [
+    "README.mkd"
+  ]
+
+  s.add_runtime_dependency(%q<capistrano>, ["2.5.21"])
+  s.add_runtime_dependency(%q<capistrano_colors>)
+  s.add_runtime_dependency(%q<capistrano-log_with_awesome>)
+  s.add_runtime_dependency(%q<foreman>)
+  s.add_runtime_dependency(%q<grit>)
+end

data/bin/deploy

@@ -0,0 +1,6 @@
+#!/bin/bash -e
+
+which figlet 2>&- > /dev/null
+bundle check || bundle --local --path vendor/bundle
+exec bundle exec foreman start -c git=1,cap=1,rollback=0,stage=0,patch=0
+

data/bin/patch

@@ -0,0 +1,5 @@
+#!/bin/bash -e
+
+which figlet 2>&- > /dev/null
+bundle check || bundle --local --path vendor/bundle
+exec bundle exec foreman start -c git=1,patch=1,cap=0,rollback=0,stage=0

data/bin/rollback

@@ -0,0 +1,5 @@
+#!/bin/bash -e
+
+which figlet 2>&- > /dev/null
+bundle check || bundle --local --path vendor/bundle
+exec bundle exec foreman start -c git=1,rollback=1,cap=0,stage=0,patch=0

data/bin/stage

@@ -0,0 +1,5 @@
+#!/bin/bash -e
+
+which figlet 2>&- > /dev/null
+bundle check || bundle --local --path vendor/bundle
+exec bundle exec foreman start -c git=1,stage=1,cap=0,rollback=0,patch=0

data/recipes/alpha_omega/deploy.rb

@@ -0,0 +1,409 @@
+$:.unshift File.expand_path(File.join(File.dirname(__FILE__),'..','..','recipes'))
+
+require 'benchmark'
+require 'yaml'
+require 'alpha_omega/deploy/scm'
+require 'alpha_omega/deploy/strategy'
+require 'capistrano_colors'
+require 'capistrano/log_with_awesome'
+
+Capistrano::Configuration.instance(:must_exist).load do |config|
+
+  def _cset(name, *args, &block)
+    unless exists?(name)
+      set(name, *args, &block)
+    end
+  end
+
+  # =========================================================================
+  # These variables MUST be set in the client capfiles. If they are not set,
+  # the deploy will fail with an error.
+  # =========================================================================
+
+  _cset(:application) { abort "Please specify the name of your application, set :application, 'foo'" }
+  _cset(:repository)  { abort "Please specify the repository that houses your application's code, set :repository, 'foo'" }
+
+  # =========================================================================
+  # These variables may be set in the client capfile if their default values
+  # are not sufficient.
+  # =========================================================================
+
+  _cset :scm, :git
+  _cset :deploy_via, :checkout
+  _cset :default_shell, "/bin/bash"
+
+  _cset(:deploy_to) { "/u/apps/#{application}" }
+  _cset(:revision)  { source.head }
+
+  # =========================================================================
+  # These variables should NOT be changed unless you are very confident in
+  # what you are doing. Make sure you understand all the implications of your
+  # changes if you do decide to muck with these!
+  # =========================================================================
+
+  _cset(:source)            { Capistrano::Deploy::SCM.new(scm, self) }
+  _cset(:real_revision)     { source.local.query_revision(revision) { |cmd| with_env("LC_ALL", "C") { run_locally(cmd) } } }
+
+  _cset(:strategy)          { Capistrano::Deploy::Strategy.new(deploy_via, self) }
+
+  _cset :version_dir,       "releases"
+  _cset :current_dir,       "current"
+  _cset :releases,          %w(alpha omega)
+
+  _cset(:releases_path)     { File.join(deploy_to, version_dir) }
+  _cset(:current_path)      { File.join(deploy_to, current_dir) }
+  _cset(:release_path)      { File.join(releases_path, release_name) }
+
+  _cset(:current_release)   { release_path }
+  _cset(:current_workarea)  { capture("readlink #{current_path} || true").strip.split("/")[-1] }
+  _cset(:previous_release)  { w = current_workarea
+                              releases.index(w) && releases[(releases.index(w)-1)%releases.length] || nil
+                            }
+  _cset(:release_name)      { w = current_workarea
+                              stage = releases[((releases.index(w)?releases.index(w):-1)+1)%releases.length]
+                              system "figlet -w 200 on #{stage}"
+                              stage
+                            }
+
+  _cset(:current_revision)  { capture("cat #{current_path}/REVISION",     :except => { :no_release => true }).chomp }
+  _cset(:latest_revision)   { capture("cat #{current_release}/REVISION",  :except => { :no_release => true }).chomp }
+  _cset(:previous_revision) { capture("cat #{previous_release}/REVISION", :except => { :no_release => true }).chomp if previous_release }
+
+  _cset(:run_method)        { fetch(:use_sudo, true) ? :sudo : :run }
+
+  # formerly:
+  #
+  # some tasks, like symlink, need to always point at the latest release, but
+  # they can also (occassionally) be called standalone. In the standalone case,
+  # the timestamped release_path will be inaccurate, since the directory won't
+  # actually exist. This variable lets tasks like symlink work either in the
+  # standalone case, or during deployment.
+  #
+  # with persistent releases, the latest release is always the current release
+  _cset(:latest_release) { current_release }
+
+  # =========================================================================
+  # These are helper methods that will be available to your recipes.
+  # =========================================================================
+
+  # Auxiliary helper method for the `deploy:check' task. Lets you set up your
+  # own dependencies.
+  def depend(location, type, *args)
+    deps = fetch(:dependencies, {})
+    deps[location] ||= {}
+    deps[location][type] ||= []
+    deps[location][type] << args
+    set :dependencies, deps
+  end
+
+  # Temporarily sets an environment variable, yields to a block, and restores
+  # the value when it is done.
+  def with_env(name, value)
+    saved, ENV[name] = ENV[name], value
+    yield
+  ensure
+    ENV[name] = saved
+  end
+
+  # logs the command then executes it locally.
+  # returns the command output as a string
+  def run_locally(cmd)
+    logger.trace "executing locally: #{cmd.inspect}" if logger
+    output_on_stdout = nil
+    elapsed = Benchmark.realtime do
+      output_on_stdout = `#{cmd}`
+    end
+    if $?.to_i > 0 # $? is command exit code (posix style)
+      raise Capistrano::LocalArgumentError, "Command #{cmd} returned status code #{$?}"
+    end
+    logger.trace "command finished in #{(elapsed * 1000).round}ms" if logger
+    output_on_stdout
+  end
+
+
+  # If a command is given, this will try to execute the given command, as
+  # described below. Otherwise, it will return a string for use in embedding in
+  # another command, for executing that command as described below.
+  #
+  # If :run_method is :sudo (or :use_sudo is true), this executes the given command
+  # via +sudo+. Otherwise is uses +run+. If :as is given as a key, it will be
+  # passed as the user to sudo as, if using sudo. If the :as key is not given,
+  # it will default to whatever the value of the :admin_runner variable is,
+  # which (by default) is unset.
+  #
+  # THUS, if you want to try to run something via sudo, and what to use the
+  # root user, you'd just to try_sudo('something'). If you wanted to try_sudo as
+  # someone else, you'd just do try_sudo('something', :as => "bob"). If you
+  # always wanted sudo to run as a particular user, you could do
+  # set(:admin_runner, "bob").
+  def try_sudo(*args)
+    options = args.last.is_a?(Hash) ? args.pop : {}
+    command = args.shift
+    raise ArgumentError, "too many arguments" if args.any?
+
+    as = options.fetch(:as, fetch(:admin_runner, nil))
+    via = fetch(:run_method, :sudo)
+    if command
+      invoke_command(command, :via => via, :as => as)
+    elsif via == :sudo
+      sudo(:as => as)
+    else
+      ""
+    end
+  end
+
+  # Same as sudo, but tries sudo with :as set to the value of the :runner
+  # variable (which defaults to "app").
+  def try_runner(*args)
+    options = args.last.is_a?(Hash) ? args.pop : {}
+    args << options.merge(:as => fetch(:runner, "app"))
+    try_sudo(*args)
+  end
+
+  # =========================================================================
+  # These are the tasks that are available to help with deploying web apps.
+  # You can have cap give you a summary of them with `cap -T'.
+  # =========================================================================
+
+  namespace :deploy do
+    desc <<-DESC
+      Deploys your project. This calls both `update' and `restart'. Note that \
+      this will generally only work for applications that have already been deployed \
+      once.
+    DESC
+    task :default do
+      update
+      restart
+    end
+
+    desc <<-DESC
+      Copies your project and updates the symlink. It does this in a \
+      transaction, so that if either `update_code' or `symlink' fail, all \
+      changes made to the remote servers will be rolled back, leaving your \
+      system in the same state it was in before `update' was invoked. Usually, \
+      you will want to call `deploy' instead of `update', but `update' can be \
+      handy if you want to deploy, but not immediately restart your application.
+    DESC
+    task :update do
+      transaction do
+        update_code
+        symlink
+      end
+    end
+
+    desc <<-DESC
+      Copies your project to the remote servers. This is the first stage \
+      of any deployment; moving your updated code and assets to the deployment \
+      servers. You will rarely call this task directly, however; instead, you \
+      should call the `deploy' task (to do a complete deploy) or the `update' \
+      task (if you want to perform the `restart' task separately).
+    DESC
+    task :update_code, :except => { :no_release => true } do
+      dirs = [ releases_path, "#{deploy_to}/log" ]
+      dir_args = dirs.map {|d| d.sub("#{deploy_to}/", "") }.join(' ')
+      run "#{try_sudo} install -d -m 0775 -o #{user} -g #{group} #{deploy_to}"
+      run "cd #{deploy_to} && install -d -m 0775 #{dir_args}"
+      strategy.deploy!
+    end
+
+    desc <<-DESC
+      Updates the symlink to the most recently deployed version. Capistrano works \
+      by putting each new release of your application in its own directory. When \
+      you deploy a new version, this task's job is to update the `current' symlink \
+      to point at the new version. You will rarely need to call this task \
+      directly; instead, use the `deploy' task (which performs a complete \
+      deploy, including `restart') or the 'update' task (which does everything \
+      except `restart').
+    DESC
+    task :symlink, :except => { :no_release => true } do
+      on_rollback do
+        if previous_release
+          run "ln -snf #{previous_release} #{current_path}; true"
+        else
+          logger.important "no previous release to rollback to, rollback of symlink skipped"
+        end
+      end
+
+      run "ln -snf #{latest_release} #{current_path}"
+
+      system "figlet -w 200 #{release_name} activated"
+    end
+
+    desc <<-DESC
+      Copy files to the currently deployed version. This is useful for updating \
+      files piecemeal, such as when you need to quickly deploy only a single \
+      file. Some files, such as updated templates, images, or stylesheets, \
+      might not require a full deploy, and especially in emergency situations \
+      it can be handy to just push the updates to production, quickly.
+
+      To use this task, specify the files and directories you want to copy as a \
+      comma-delimited list in the FILES environment variable. All directories \
+      will be processed recursively, with all files being pushed to the \
+      deployment servers.
+
+        $ cap deploy:upload FILES=templates,controller.rb
+
+      Dir globs are also supported:
+
+        $ cap deploy:upload FILES='config/apache/*.conf'
+    DESC
+    task :upload, :except => { :no_release => true } do
+      files = (ENV["FILES"] || "").split(",").map { |f| Dir[f.strip] }.flatten
+      abort "Please specify at least one file or directory to update (via the FILES environment variable)" if files.empty?
+
+      files.each { |file| top.upload(file, File.join(current_path, file)) }
+    end
+
+    desc <<-DESC
+      Restarts your application.
+    DESC
+    task :restart, :roles => :app, :except => { :no_release => true } do
+    end
+
+    namespace :rollback do
+      desc <<-DESC
+        [internal] Points the current symlink at the previous revision.
+        This is called by the rollback sequence, and should rarely (if
+        ever) need to be called directly.
+      DESC
+      task :revision, :except => { :no_release => true } do
+        if previous_release
+          system "figlet -w 200 on #{previous_release}"
+          run "ln -snf #{previous_release} #{current_path}"
+        else
+          abort "could not rollback the code because there is no prior release"
+        end
+      end
+
+      desc <<-DESC
+        [internal] Removes the most recently deployed release.
+        This is called by the rollback sequence, and should rarely
+        (if ever) need to be called directly.
+      DESC
+      task :cleanup, :except => { :no_release => true } do
+      end
+
+      desc <<-DESC
+        Rolls back to the previously deployed version. The `current' symlink will \
+        be updated to point at the previously deployed version, and then the \
+        current release will be removed from the servers. You'll generally want \
+        to call `rollback' instead, as it performs a `restart' as well.
+      DESC
+      task :code, :except => { :no_release => true } do
+        revision
+        cleanup
+      end
+
+      desc <<-DESC
+        Rolls back to a previous version and restarts. This is handy if you ever \
+        discover that you've deployed a lemon; `cap rollback' and you're right \
+        back where you were, on the previously deployed version.
+      DESC
+      task :default do
+        revision
+        restart
+        cleanup
+      end
+    end
+
+    desc <<-DESC
+      Override in deploy recipes.  Formerly a railsy rake db:migrate.
+    DESC
+    task :migrate, :roles => :db, :only => { :primary => true } do
+    end
+
+    desc <<-DESC
+      Deploy and run pending migrations. This will work similarly to the \
+      `deploy' task, but will also run any pending migrations (via the \
+      `deploy:migrate' task) prior to updating the symlink. Note that the \
+      update in this case it is not atomic, and transactions are not used, \
+      because migrations are not guaranteed to be reversible.
+    DESC
+    task :migrations do
+      set :migrate_target, :latest
+      update_code
+      migrate
+      symlink
+      restart
+    end
+
+    desc <<-DESC
+      Test deployment dependencies. Checks things like directory permissions, \
+      necessary utilities, and so forth, reporting on the things that appear to \
+      be incorrect or missing. This is good for making sure a deploy has a \
+      chance of working before you actually run `cap deploy'.
+
+      You can define your own dependencies, as well, using the `depend' method:
+
+        depend :remote, :gem, "tzinfo", ">=0.3.3"
+        depend :local, :command, "svn"
+        depend :remote, :directory, "/u/depot/files"
+    DESC
+    task :check, :except => { :no_release => true } do
+      dependencies = strategy.check!
+
+      other = fetch(:dependencies, {})
+      other.each do |location, types|
+        types.each do |type, calls|
+          if type == :gem
+            dependencies.send(location).command(fetch(:gem_command, "gem")).or("`gem' command could not be found. Try setting :gem_command")
+          end
+
+          calls.each do |args|
+            dependencies.send(location).send(type, *args)
+          end
+        end
+      end
+
+      if dependencies.pass?
+        puts "You appear to have all necessary dependencies installed"
+      else
+        puts "The following dependencies failed. Please check them and try again:"
+        dependencies.reject { |d| d.pass? }.each do |d|
+          puts "--> #{d.message}"
+        end
+        abort
+      end
+    end
+
+    desc <<-DESC
+      Start the application servers.
+    DESC
+    task :start, :roles => :app do
+    end
+
+    desc <<-DESC
+      Stop the application servers.
+    DESC
+    task :stop, :roles => :app do
+    end
+
+    namespace :pending do
+      desc <<-DESC
+        Displays the `diff' since your last deploy. This is useful if you want \
+        to examine what changes are about to be deployed. Note that this might \
+        not be supported on all SCM's.
+      DESC
+      task :diff, :except => { :no_release => true } do
+        system(source.local.diff(current_revision))
+      end
+
+      desc <<-DESC
+        Displays the commits since your last deploy. This is good for a summary \
+        of the changes that have occurred since the last deploy. Note that this \
+        might not be supported on all SCM's.
+      DESC
+      task :default, :except => { :no_release => true } do
+        from = source.next_revision(current_revision)
+        system(source.local.log(from))
+      end
+    end
+
+  end
+
+  on :exit do
+    put full_log, "#{deploy_to}/log/last_deploy.log-#{Time.now.strftime('%Y%m%d-%H%M')}"
+  end
+
+end # Capistrano::Configuration
+