capistrano 2.1.0 → 3.0.0

data/lib/capistrano/recipes/deploy/strategy/copy.rb

@@ -1,144 +0,0 @@
-require 'capistrano/recipes/deploy/strategy/base'
-require 'fileutils'
-require 'tempfile'  # Dir.tmpdir
-
-module Capistrano
-  module Deploy
-    module Strategy
-
-      # This class implements the strategy for deployments which work
-      # by preparing the source code locally, compressing it, copying the
-      # file to each target host, and uncompressing it to the deployment
-      # directory.
-      #
-      # By default, the SCM checkout command is used to obtain the local copy
-      # of the source code. If you would rather use the export operation,
-      # you can set the :copy_strategy variable to :export.
-      #
-      # This deployment strategy supports a special variable,
-      # :copy_compression, which must be one of :gzip, :bz2, or
-      # :zip, and which specifies how the source should be compressed for
-      # transmission to each host.
-      class Copy < Base
-        # Obtains a copy of the source code locally (via the #command method),
-        # compresses it to a single file, copies that file to all target
-        # servers, and uncompresses it on each of them into the deployment
-        # directory.
-        def deploy!
-          logger.debug "getting (via #{copy_strategy}) revision #{revision} to #{destination}"
-          system(command)
-          File.open(File.join(destination, "REVISION"), "w") { |f| f.puts(revision) }
-
-          logger.trace "compressing #{destination} to #{filename}"
-          Dir.chdir(tmpdir) { system(compress(File.basename(destination), File.basename(filename)).join(" ")) }
-
-          content = File.open(filename, "rb") { |f| f.read }
-          put content, remote_filename 
-          run "cd #{configuration[:releases_path]} && #{decompress(remote_filename).join(" ")} && rm #{remote_filename}"
-        ensure
-          FileUtils.rm filename rescue nil
-          FileUtils.rm_rf destination rescue nil
-        end
-
-        def check!
-          super.check do |d|
-            d.local.command(source.local.command)
-            d.local.command(compress(nil, nil).first)
-            d.remote.command(decompress(nil).first)
-          end
-        end
-
-        private
-
-          # Returns the basename of the release_path, which will be used to
-          # name the local copy and archive file.
-          def destination
-            @destination ||= File.join(tmpdir, File.basename(configuration[:release_path]))
-          end
-
-          # Returns the value of the :copy_strategy variable, defaulting to
-          # :checkout if it has not been set.
-          def copy_strategy
-            @copy_strategy ||= configuration.fetch(:copy_strategy, :checkout)
-          end
-
-          # Should return the command(s) necessary to obtain the source code
-          # locally.
-          def command
-            @command ||= case copy_strategy
-            when :checkout
-              source.checkout(revision, destination)
-            when :export
-              source.export(revision, destination)
-            end
-          end
-
-          # Returns the name of the file that the source code will be
-          # compressed to.
-          def filename
-            @filename ||= File.join(tmpdir, "#{File.basename(destination)}.#{compression_extension}")
-          end
-
-          # The directory to which the copy should be checked out
-          def tmpdir
-            @tmpdir ||= configuration[:copy_dir] || Dir.tmpdir
-          end
-
-          # The directory on the remote server to which the archive should be
-          # copied
-          def remote_dir
-            @remote_dir ||= configuration[:copy_remote_dir] || "/tmp"
-          end
-
-          # The location on the remote server where the file should be
-          # temporarily stored.
-          def remote_filename
-            @remote_filename ||= File.join(remote_dir, File.basename(filename))
-          end
-
-          # The compression method to use, defaults to :gzip.
-          def compression
-            configuration[:copy_compression] || :gzip
-          end
-
-          # Returns the file extension used for the compression method in
-          # question.
-          def compression_extension
-            case compression
-            when :gzip, :gz   then "tar.gz"
-            when :bzip2, :bz2 then "tar.bz2"
-            when :zip         then "zip"
-            else raise ArgumentError, "invalid compression type #{compression.inspect}"
-            end
-          end
-
-          # Returns the command necessary to compress the given directory
-          # into the given file. The command is returned as an array, where
-          # the first element is the utility to be used to perform the compression.
-          def compress(directory, file)
-            case compression
-            when :gzip, :gz   then ["tar", "czf", file, directory]
-            when :bzip2, :bz2 then ["tar", "cjf", file, directory]
-            when :zip         then ["zip", "-qr", file, directory]
-            else raise ArgumentError, "invalid compression type #{compression.inspect}"
-            end
-          end
-
-          # Returns the command necessary to decompress the given file,
-          # relative to the current working directory. It must also
-          # preserve the directory structure in the file. The command is returned
-          # as an array, where the first element is the utility to be used to
-          # perform the decompression.
-          def decompress(file)
-            case compression
-            when :gzip, :gz   then ["tar", "xzf", file]
-            when :bzip2, :bz2 then ["tar", "xjf", file]
-            when :zip         then ["unzip", "-q", file]
-            else raise ArgumentError, "invalid compression type #{compression.inspect}"
-            end
-          end
-      end
-
-    end
-  end
-end

data/lib/capistrano/recipes/deploy/strategy/export.rb

@@ -1,20 +0,0 @@
-require 'capistrano/recipes/deploy/strategy/remote'
-
-module Capistrano
-  module Deploy
-    module Strategy
-
-      # Implements the deployment strategy which does an SCM export on each
-      # target host.
-      class Export < Remote
-        protected
-
-          # Returns the SCM's export command for the revision to deploy.
-          def command
-            @command ||= source.export(revision, configuration[:release_path])
-          end
-      end
-
-    end
-  end
-end

data/lib/capistrano/recipes/deploy/strategy/remote.rb

@@ -1,52 +0,0 @@
-require 'capistrano/recipes/deploy/strategy/base'
-
-module Capistrano
-  module Deploy
-    module Strategy
-
-      # An abstract superclass, which forms the base for all deployment
-      # strategies which work by grabbing the code from the repository directly
-      # from remote host. This includes deploying by checkout (the default),
-      # and deploying by export.
-      class Remote < Base
-        # Executes the SCM command for this strategy and writes the REVISION
-        # mark file to each host.
-        def deploy!
-          scm_run "#{command} && #{mark}"
-        end
-
-        def check!
-          super.check do |d|
-            d.remote.command(source.command)
-          end
-        end
-
-        protected
-
-          # Runs the given command, filtering output back through the
-          # #handle_data filter of the SCM implementation.
-          def scm_run(command)
-            run(command) do |ch,stream,text|
-              ch[:state] ||= {}
-              output = source.handle_data(ch[:state], stream, text)
-              ch.send_data(output) if output
-            end
-          end
-
-          # An abstract method which must be overridden in subclasses, to
-          # return the actual SCM command(s) which must be executed on each
-          # target host in order to perform the deployment.
-          def command
-            raise NotImplementedError, "`command' is not implemented by #{self.class.name}"
-          end
-
-          # Returns the command which will write the identifier of the
-          # revision being deployed to the REVISION file on each host.
-          def mark
-            "(echo #{revision} > #{configuration[:release_path]}/REVISION)"
-          end
-      end
-
-    end
-  end
-end

data/lib/capistrano/recipes/deploy/strategy/remote_cache.rb

@@ -1,47 +0,0 @@
-require 'capistrano/recipes/deploy/strategy/remote'
-
-module Capistrano
-  module Deploy
-    module Strategy
-
-      # Implements the deployment strategy that keeps a cached checkout of
-      # the source code on each remote server. Each deploy simply updates the
-      # cached checkout, and then does a copy from the cached copy to the
-      # final deployment location.
-      class RemoteCache < Remote
-        # Executes the SCM command for this strategy and writes the REVISION
-        # mark file to each host.
-        def deploy!
-          update_repository_cache
-          copy_repository_cache
-        end
-
-        def check!
-          super.check do |d|
-            d.remote.writable(shared_path)
-          end
-        end
-
-        private
-
-          def repository_cache
-            File.join(shared_path, configuration[:repository_cache] || "cached-copy")
-          end
-
-          def update_repository_cache
-            logger.trace "updating the cached checkout on all servers"
-            command = "if [ -d #{repository_cache} ]; then " +
-              "#{source.sync(revision, repository_cache)}; " +
-              "else #{source.checkout(revision, repository_cache)}; fi"
-            scm_run(command)
-          end
-
-          def copy_repository_cache
-            logger.trace "copying the cached version to #{configuration[:release_path]}"
-            run "cp -RPp #{repository_cache} #{configuration[:release_path]} && #{mark}"
-          end
-      end
-
-    end
-  end
-end

data/lib/capistrano/recipes/deploy/strategy.rb

@@ -1,19 +0,0 @@
-module Capistrano
-  module Deploy
-    module Strategy
-      def self.new(strategy, config={})
-        strategy_file = "capistrano/recipes/deploy/strategy/#{strategy}"
-        require(strategy_file)
-
-        strategy_const = strategy.to_s.capitalize.gsub(/_(.)/) { $1.upcase }
-        if const_defined?(strategy_const)
-          const_get(strategy_const).new(config)
-        else
-          raise Capistrano::Error, "could not find `#{name}::#{strategy_const}' in `#{strategy_file}'"
-        end
-      rescue LoadError
-        raise Capistrano::Error, "could not find any strategy named `#{strategy}'"
-      end
-    end
-  end
-end

data/lib/capistrano/recipes/deploy/templates/maintenance.rhtml

@@ -1,53 +0,0 @@
-
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-
-<head>
-  <meta http-equiv="content-type" content="text/html;charset=UTF-8" />
-  <title>System down for maintenance</title>
-
-  <style type="text/css">
-    div.outer {
-      position: absolute;
-      left: 50%;
-      top: 50%;
-      width: 500px;
-      height: 300px;
-      margin-left: -260px; 
-      margin-top: -150px;
-    }
-
-    .DialogBody {
-      margin: 0;
-      padding: 10px;
-      text-align: left;
-      border: 1px solid #ccc;
-      border-right: 1px solid #999;
-      border-bottom: 1px solid #999;
-      background-color: #fff;
-    }
-
-    body { background-color: #fff; }
-  </style>
-</head>
-
-<body>
-
-  <div class="outer">
-     <div class="DialogBody" style="text-align: center;">
-       <div style="text-align: center; width: 200px; margin: 0 auto;">
-         <p style="color: red; font-size: 16px; line-height: 20px;">
-           The system is down for <%= reason ? reason : "maintenance" %>
-           as of <%= Time.now.strftime("%H:%M %Z") %>.
-         </p>
-         <p style="color: #666;">
-           It'll be back <%= deadline ? deadline : "shortly" %>.
-         </p>
-       </div>
-     </div>
-  </div>
-
-</body>
-</html>