capistrano 1.4.2 → 2.0.0

data/lib/capistrano/generators/rails/deployment/deployment_generator.rb

@@ -1,25 +0,0 @@
-class DeploymentGenerator < Rails::Generator::NamedBase
-  attr_reader :recipe_file
-
-  def initialize(runtime_args, runtime_options = {})
-    super
-    @recipe_file = @args.shift || "deploy"
-  end
-
-  def manifest
-    record do |m|
-      m.directory "config"
-      m.template "deploy.rb", File.join("config", "#{recipe_file}.rb")
-      m.directory "lib/tasks"
-      m.template "capistrano.rake", File.join("lib", "tasks", "capistrano.rake")
-    end
-  end
-
-  protected
-
-    # Override with your own usage banner.
-    def banner
-      "Usage: #{$0} deployment ApplicationName [recipe-name]\n" +
-      "  (recipe-name defaults to \"deploy\")"
-    end
-end

data/lib/capistrano/generators/rails/deployment/templates/capistrano.rake

@@ -1,49 +0,0 @@
-# =============================================================================
-# A set of rake tasks for invoking the Capistrano automation utility.
-# =============================================================================
-
-# Invoke the given actions via Capistrano
-def cap(*parameters)
-  begin
-    require 'rubygems'
-  rescue LoadError
-    # no rubygems to load, so we fail silently
-  end
-
-  require 'capistrano/cli'
-
-  STDERR.puts "Capistrano/Rake integration is deprecated."
-  STDERR.puts "Please invoke the 'cap' command directly: `cap #{parameters.join(" ")}'"
-
-  Capistrano::CLI.new(parameters.map { |param| param.to_s }).execute!
-end
-
-namespace :remote do
-<%- config = Capistrano::Configuration.new
-    config.load "standard"
-    options = { :show_tasks => ", '-q'" }
-    config.actor.each_task do |info| -%>
-<%- unless info[:desc].empty? -%>
-  desc "<%= info[:desc].scan(/.*?(?:\. |$)/).first.strip.gsub(/"/, "\\\"") %>"
-<%- end -%>
-  task(<%= info[:task].inspect %>) { cap <%= info[:task].inspect %><%= options[info[:task]] %> }
-
-<%- end -%>
-  desc "Execute a specific action using capistrano"
-  task :exec do
-    unless ENV['ACTION']
-      raise "Please specify an action (or comma separated list of actions) via the ACTION environment variable"
-    end
-
-    actions = ENV['ACTION'].split(",")
-    actions.concat(ENV['PARAMS'].split(" ")) if ENV['PARAMS']
-
-    cap(*actions)
-  end
-end
-
-desc "Push the latest revision into production (delegates to remote:deploy)"
-task :deploy => "remote:deploy"
-
-desc "Rollback to the release before the current release in production (delegates to remote:rollback)"
-task :rollback => "remote:rollback"

data/lib/capistrano/generators/rails/deployment/templates/deploy.rb

@@ -1,122 +0,0 @@
-# This defines a deployment "recipe" that you can feed to capistrano
-# (http://manuals.rubyonrails.com/read/book/17). It allows you to automate
-# (among other things) the deployment of your application.
-
-# =============================================================================
-# REQUIRED VARIABLES
-# =============================================================================
-# You must always specify the application and repository for every recipe. The
-# repository must be the URL of the repository you want this recipe to
-# correspond to. The deploy_to path must be the path on each machine that will
-# form the root of the application path.
-
-set :application, "<%= singular_name %>"
-set :repository, "http://svn.yourhost.com/#{application}/trunk"
-
-# =============================================================================
-# ROLES
-# =============================================================================
-# You can define any number of roles, each of which contains any number of
-# machines. Roles might include such things as :web, or :app, or :db, defining
-# what the purpose of each machine is. You can also specify options that can
-# be used to single out a specific subset of boxes in a particular role, like
-# :primary => true.
-
-role :web, "www01.example.com", "www02.example.com"
-role :app, "app01.example.com", "app02.example.com", "app03.example.com"
-role :db,  "db01.example.com", :primary => true
-role :db,  "db02.example.com", "db03.example.com"
-
-# =============================================================================
-# OPTIONAL VARIABLES
-# =============================================================================
-# set :deploy_to, "/path/to/app" # defaults to "/u/apps/#{application}"
-# set :user, "flippy"            # defaults to the currently logged in user
-# set :scm, :darcs               # defaults to :subversion
-# set :svn, "/path/to/svn"       # defaults to searching the PATH
-# set :darcs, "/path/to/darcs"   # defaults to searching the PATH
-# set :cvs, "/path/to/cvs"       # defaults to searching the PATH
-# set :gateway, "gate.host.com"  # default to no gateway
-
-# =============================================================================
-# SSH OPTIONS
-# =============================================================================
-# ssh_options[:keys] = %w(/path/to/my/key /path/to/another/key)
-# ssh_options[:port] = 25
-
-# =============================================================================
-# TASKS
-# =============================================================================
-# Define tasks that run on all (or only some) of the machines. You can specify
-# a role (or set of roles) that each task should be executed on. You can also
-# narrow the set of servers to a subset of a role by specifying options, which
-# must match the options given for the servers to select (like :primary => true)
-
-desc <<DESC
-An imaginary backup task. (Execute the 'show_tasks' task to display all
-available tasks.)
-DESC
-task :backup, :roles => :db, :only => { :primary => true } do
-  # the on_rollback handler is only executed if this task is executed within
-  # a transaction (see below), AND it or a subsequent task fails.
-  on_rollback { delete "/tmp/dump.sql" }
-
-  run "mysqldump -u theuser -p thedatabase > /tmp/dump.sql" do |ch, stream, out|
-    ch.send_data "thepassword\n" if out =~ /^Enter password:/
-  end
-end
-
-# Tasks may take advantage of several different helper methods to interact
-# with the remote server(s). These are:
-#
-# * run(command, options={}, &block): execute the given command on all servers
-#   associated with the current task, in parallel. The block, if given, should
-#   accept three parameters: the communication channel, a symbol identifying the
-#   type of stream (:err or :out), and the data. The block is invoked for all
-#   output from the command, allowing you to inspect output and act
-#   accordingly.
-# * sudo(command, options={}, &block): same as run, but it executes the command
-#   via sudo.
-# * delete(path, options={}): deletes the given file or directory from all
-#   associated servers. If :recursive => true is given in the options, the
-#   delete uses "rm -rf" instead of "rm -f".
-# * put(buffer, path, options={}): creates or overwrites a file at "path" on
-#   all associated servers, populating it with the contents of "buffer". You
-#   can specify :mode as an integer value, which will be used to set the mode
-#   on the file.
-# * render(template, options={}) or render(options={}): renders the given
-#   template and returns a string. Alternatively, if the :template key is given,
-#   it will be treated as the contents of the template to render. Any other keys
-#   are treated as local variables, which are made available to the (ERb)
-#   template.
-
-desc "Demonstrates the various helper methods available to recipes."
-task :helper_demo do
-  # "setup" is a standard task which sets up the directory structure on the
-  # remote servers. It is a good idea to run the "setup" task at least once
-  # at the beginning of your app's lifetime (it is non-destructive).
-  setup
-
-  buffer = render("maintenance.rhtml", :deadline => ENV['UNTIL'])
-  put buffer, "#{shared_path}/system/maintenance.html", :mode => 0644
-  sudo "killall -USR1 dispatch.fcgi"
-  run "#{release_path}/script/spin"
-  delete "#{shared_path}/system/maintenance.html"
-end
-
-# You can use "transaction" to indicate that if any of the tasks within it fail,
-# all should be rolled back (for each task that specifies an on_rollback
-# handler).
-
-desc "A task demonstrating the use of transactions."
-task :long_deploy do
-  transaction do
-    update_code
-    disable_web
-    symlink
-    migrate
-  end
-
-  restart
-  enable_web
-end

data/lib/capistrano/generators/rails/loader.rb

@@ -1,20 +0,0 @@
-module Capistrano
-  module Generators
-    class RailsLoader
-      def self.load!(options)
-        require "#{options[:apply_to]}/config/environment"
-        require "rails_generator"
-        require "rails_generator/scripts/generate"
-
-        Rails::Generator::Base.sources << Rails::Generator::PathSource.new(
-          :capistrano, File.dirname(__FILE__))
-
-        args = ["deployment"]
-        args << (options[:application] || "Application")
-        args << (options[:recipe_file] || "deploy")
-
-        Rails::Generator::Scripts::Generate.new.run(args)
-      end
-    end
-  end
-end

data/lib/capistrano/scm/base.rb

@@ -1,61 +0,0 @@
-module Capistrano
-  module SCM
-
-    # The ancestor class of the various SCM module implementations.
-    class Base
-      attr_reader :configuration
-
-      def initialize(configuration) #:nodoc:
-        @configuration = configuration
-      end
-
-      def latest_revision
-        nil
-      end
-
-      def current_revision(actor)
-        raise "#{self.class} doesn't support querying the deployed revision"
-      end
-
-      def diff(actor, from=nil, to=nil)
-        raise "#{self.class} doesn't support diff(from, to)"
-      end
-
-      def update(actor)
-        raise "#{self.class} doesn't support update(actor)"
-      end
-
-      private
-
-        def run_checkout(actor, guts, &block)
-          directory = File.basename(configuration.release_path)
-
-          command = <<-STR
-            if [[ ! -d #{configuration.release_path} ]]; then
-              #{guts}
-              #{logging_commands(directory)}
-            fi
-          STR
-
-          actor.run(command, &block)
-        end
-        
-        def run_update(actor, guts, &block)
-          command = <<-STR
-            #{guts}
-            #{logging_commands}
-          STR
-
-          actor.run(command, &block)
-        end
-
-        def logging_commands(directory = nil)
-          log = "#{configuration.deploy_to}/revisions.log"
-
-          "(test -e #{log} || (touch #{log} && chmod 666 #{log})) && " +
-          "echo `date +\"%Y-%m-%d %H:%M:%S\"` $USER #{configuration.revision} #{directory} >> #{log};"
-        end
-    end
-
-  end
-end

data/lib/capistrano/scm/baz.rb

@@ -1,118 +0,0 @@
-require 'capistrano/scm/base'
-
-module Capistrano
-  module SCM
-
-    # An SCM module for using Bazaar as your source control tool. This
-    # module is used by default, but you can explicitly specify it by
-    # placing the following line in your configuration:
-    #
-    #   set :scm, :baz
-    #
-    # Also, this module accepts a <tt>:baz</tt> configuration variable,
-    # which (if specified) will be used as the full path to the svn
-    # executable on the remote machine:
-    #
-    #   set :baz, "/opt/local/bin/baz"
-    #
-    # Set the version you wish to deploy as the repository variable, 
-    # for example:
-    #
-    #   set :repository, "you@example.com--dev/yourstuff--trunk--1.0"
-    #
-    # Ensure that you have already registered the archive on the target
-    # machines.
-    #
-    # As bazaar keeps a great deal of extra information on a checkout,
-    # you will probably want to use export instead:
-    #
-    #   set :checkout, "export"
-    #
-    # TODO: provide setup recipe to register archive
-    class Baz < Base
-      # Return an integer identifying the last known revision in the baz
-      # repository. (This integer is currently the revision number.)
-      def latest_revision
-        `#{baz} revisions #{configuration.repository}`.split.last =~ /\-(\d+)$/
-        $1
-      end
-
-      # Return the number of the revision currently deployed.
-      def current_revision(actor)
-        latest = actor.releases.last
-        grep = %(grep " #{latest}$" #{configuration.deploy_to}/revisions.log)
-        result = ""
-        actor.run(grep, :once => true) do |ch, str, out|
-          result << out if str == :out
-          raise "could not determine current revision" if str == :err
-        end
-
-        date, time, user, rev, dir = result.split
-        raise "current revision not found in revisions.log" unless dir == latest
-        rev.to_i
-      end
-
-      # Return a string containing the diff between the two revisions. +from+
-      # and +to+ may be in any format that bzr recognizes as a valid revision
-      # identifier. If +from+ is +nil+, it defaults to the last deployed
-      # revision. If +to+ is +nil+, it defaults to the last developed revision.
-      def diff(actor, from=nil, to=nil)
-        from ||= current_revision(actor)
-        to ||= latest_revision
-        from = baz_revision_name(from)
-        to = baz_revision_name(to)
-        `#{baz} delta --diffs -A #{baz_archive} #{baz_version}--#{from} #{baz_version}--#{to}`
-      end
-
-      # Check out (on all servers associated with the current task) the latest
-      # revision. Uses the given actor instance to execute the command.
-      def checkout(actor)
-        op = configuration[:checkout] || "get"
-        from = baz_revision_name(configuration.revision)
-        command = "#{baz} #{op} #{configuration.repository}--#{from} #{actor.release_path} &&"
-        run_checkout(actor, command, &baz_stream_handler(actor)) 
-      end
-
-      def update(actor)
-        command = "cd #{actor.current_path} && #{baz} update &&"
-        run_update(actor, command, &baz_stream_handler(actor)) 
-      end
-
-      private
-        def baz
-          configuration[:baz] || "baz"
-        end
-
-        def baz_revision_name(number)
-          if number.to_i == 0 then
-            "base-0"
-          else
-            "patch-#{number}"
-          end
-        end
-
-        def baz_archive
-          configuration[:repository][/(.*)\//, 1]
-        end
-
-        def baz_version
-          configuration[:repository][/\/(.*)$/, 1]
-        end
-
-        def baz_stream_handler(actor)
-          Proc.new do |ch, stream, out|
-            prefix = "#{stream} :: #{ch[:host]}"
-            actor.logger.info out, prefix
-            if out =~ /\bpassword.*:/i
-              actor.logger.info "baz is asking for a password", prefix
-              ch.send_data "#{actor.password}\n"
-            elsif out =~ %r{passphrase}
-              message = "baz needs your key's passphrase, sending empty string"
-              actor.logger.info message, prefix
-              ch.send_data "\n"
-            end
-          end
-        end
-    end
-  end
-end

data/lib/capistrano/scm/bzr.rb

@@ -1,70 +0,0 @@
-require 'capistrano/scm/base'
-
-module Capistrano
-  module SCM
-
-    # An SCM module for using Bazaar-NG (bzr) as your source control tool.
-    # You can use it by placing the following line in your configuration:
-    #
-    #   set :scm, :bzr
-    #
-    # Also, this module accepts a <tt>:bzr</tt> configuration variable,
-    # which (if specified) will be used as the full path to the bzr
-    # executable on the remote machine:
-    #
-    #   set :bzr, "/opt/local/bin/bzr"
-    class Bzr < Base
-      # Return an integer identifying the last known revision in the bzr
-      # repository. (This integer is currently the revision number.) 
-      def latest_revision
-        `#{bzr} revno #{configuration.repository}`.to_i
-      end
-
-      # Return the number of the revision currently deployed.
-      def current_revision(actor)
-        command = "#{bzr} revno #{actor.release_path} &&"        
-        run_update(actor, command, &bzr_stream_handler(actor)) 
-      end
-
-      # Return a string containing the diff between the two revisions. +from+
-      # and +to+ may be in any format that bzr recognizes as a valid revision
-      # identifier. If +from+ is +nil+, it defaults to the last deployed
-      # revision. If +to+ is +nil+, it defaults to the last developed revision.
-      # Pay attention to the fact that as of now bzr does NOT support
-      # diff on remote locations.
-      def diff(actor, from=nil, to=nil)
-        from ||= current_revision(actor)
-        to ||= ""
-        `#{bzr} diff -r #{from}..#{to} #{configuration.repository}`
-      end
-
-      # Check out (on all servers associated with the current task) the latest
-      # revision. Uses the given actor instance to execute the command. If
-      # bzr asks for a password this will automatically provide it (assuming
-      # the requested password is the same as the password for logging into the
-      # remote server.)
-      def checkout(actor)
-        op = configuration[:checkout] || "branch"
-        command = "#{bzr} #{op} -r#{configuration.revision} #{configuration.repository} #{actor.release_path} &&"
-        run_checkout(actor, command, &bzr_stream_handler(actor)) 
-      end
-
-      def update(actor)
-        command = "cd #{actor.current_path} && #{bzr} pull -q &&"
-        run_update(actor, command, &bzr_stream_handler(actor)) 
-      end
-      
-      private
-        def bzr
-          configuration[:bzr] || "bzr"
-        end
-
-        def bzr_stream_handler(actor)
-          Proc.new do |ch, stream, out|
-            prefix = "#{stream} :: #{ch[:host]}"
-            actor.logger.info out, prefix
-          end
-        end
-    end
-  end
-end