LICENSE README.rdoc @@ -1,3 +1,14 @@ +# --------------------------------------------------------------------------- +# This implements a specialization of the standard Capistrano RemoteCache +# deployment strategy. The most significant difference between this strategy +# and the RemoteCache is the way the cache is copied to the final release +# directory: it uses the bundled "copy.rb" script to use hard links to the +# files instead of actually copying, so the copy stage is much, much faster. +# --------------------------------------------------------------------------- +# This file is distributed under the terms of the MIT license by 37signals, +# LLC, and is copyright (c) 2008 by the same. See the LICENSE file distributed +# with this file for the complete text of the license. +# --------------------------------------------------------------------------- require 'capistrano/recipes/deploy/strategy/remote_cache' class Capistrano::Deploy::Strategy::FastRemoteCache < Capistrano::Deploy::Strategy::RemoteCache lib/capistrano/recipes/deploy/strategy/fast_remote_cache.rb @@ -1,7 +1,25 @@ +# --------------------------------------------------------------------------- +# A simple copy script for doing hard links and symbolic links instead of +# explicit copies. Some OS's will already have a utility to do this, but +# some won't; this file suffices in either case. +# +# Usage: ruby copy.rb <source> <target> <exclude> ... +# +# The <source> directory is recursively descended, and hard links to all of +# the files are created in corresponding locations under <target>. Symbolic +# links in <source> map to symbolic links in <target> that point to the same +# destination. +# +# All arguments after <target> are taken to be exclude patterns. Any file +# or directory in <source> that matches any of those patterns will be +# skipped, and will thus not be present in <target>. +# --------------------------------------------------------------------------- +# This file is distributed under the terms of the MIT license by 37signals, +# LLC, and is copyright (c) 2008 by the same. See the LICENSE file distributed +# with this file for the complete text of the license. +# --------------------------------------------------------------------------- require 'fileutils' -verbose = false - from = ARGV.shift or abort "need source directory" to = ARGV.shift or abort "need target directory" lib/capistrano/recipes/deploy/strategy/utilities/copy.rb @@ -1,3 +1,11 @@ +# --------------------------------------------------------------------------- +# This is a recipe definition file for Capistrano. The tasks are documented +# below. +# --------------------------------------------------------------------------- +# This file is distributed under the terms of the MIT license by 37signals, +# LLC, and is copyright (c) 2008 by the same. See the LICENSE file distributed +# with this file for the complete text of the license. +# --------------------------------------------------------------------------- $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), "..", "lib")) namespace :fast_remote_cache do recipes/fast_remote_cache.rb 27838e4e263b746ede3ca5ede0c950f4f4ab3baf Jamis Buck jamis@37signals.com http://github.com/37signals/fast_remote_cache/commit/6dc16b790ad3e5cc20b11e429f69b12e24e53cd1 6dc16b790ad3e5cc20b11e429f69b12e24e53cd1 2008-09-03T08:36:35-07:00 2008-09-03T08:36:35-07:00 documentation, prepping for publication to github 8bf6cb049239c2ae58255b0bc6c0419318d5cabd Jamis Buck jamis@37signals.com