fpauser-vlad 2.2.0

data/.autotest

@@ -0,0 +1,25 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+require 'autotest/rcov'
+
+Autotest.add_hook :initialize do |at|
+  at.testlib = "minitest/autorun"
+#   at.extra_files << "../some/external/dependency.rb"
+#
+  at.libs << ":../../rake-remote_task/dev/lib"
+#
+#   at.add_exception 'vendor'
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/Gemfile

@@ -0,0 +1 @@
+gemspec

data/Gemfile.lock

@@ -0,0 +1,21 @@
+PATH
+  remote: .
+  specs:
+    fpauser-vlad (2.2.0)
+      fpauser-rake-remote_task (>= 2.0.3)
+      open4 (>= 0.9.0)
+      rake (>= 0.8.0)
+
+GEM
+  specs:
+    fpauser-rake-remote_task (2.0.3)
+      open4 (>= 0.9.0)
+      rake (>= 0.8.0)
+    open4 (0.9.6)
+    rake (0.9.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  fpauser-vlad!

data/History.txt

@@ -0,0 +1,206 @@
+=== 2.2.0 / 2011-02-18
+
+* 5 minor enhancements:
+
+  * Added support for setting owner and group of deploy. (RichGuk)
+  * Allow shared_paths, mkdirs, and symlinks to be excluded (RichGuk/zaius)
+  * Cleaned up update task to correspond to rake-remote-task changes. (RichGuk)
+  * Do not run symlink commands if there are no operations to run. (jsmecham)
+  * Obey the umask across the board. (RichGuk)
+
+* 2 bug fixes:
+
+  * Fixed migrate task shell cmd. (cheba)
+  * Fixed passenger touch file location. (richinsr)
+
+=== 2.1.0 / 2010-07-15
+
+* 1 major enhancement:
+
+  * Split out rake_remote_task.rb and vlad_test_case.rb (in rake-remote_task gem).
+
+* 4 minor enhancements:
+
+  * Added :type config option, defaulting to rails
+  * Moved VladTestCase to Rake::TestCase (in rake-remote_task gem).
+  * Moved all Vlad exceptions to Rake (in rake-remote_task gem).
+  * Refactored rails specific values out of core. (raggi)
+
+* 2 bug fixes:
+
+  * Clarified Rake.clear_tasks in faq
+  * Fixed output from vlad:invoke (pnc)
+
+=== 2.0.0 / 2009-08-18
+
+* 1 major enhancement:
+
+  * Removed all extra modules that we don't support in core anymore.
+
+* 2 minor enhancements:
+
+  * Added test to show that false is a valid variable value.
+  * Moved vlad_test_case from test to lib to support 3rd party vlad modules.
+
+=== 1.4.0 / 2009-06-23
+
+* 1 major enhancement:
+
+  * Switched to passenger as default app server.
+
+* 11 minor enhancements:
+
+  * #rsync now takes ANY number of arguments and expects to you add "host:".
+  * Added Rake::RemoteTask#get.
+  * Added doco for why we don't ship a deploy task
+  * Added links to example maintenance recipes
+  * Added multi-env doco to getting_started.txt
+  * Added svn-over-ssh faq item. gah.
+  * Flipped tests to minitest
+  * Merged global #role and Rake::RemoteTask::role.
+  * Moved all global methods to Rake::RemoteTask and wrote #external to clean up.
+  * Moved rake extensions to hoe so everyone can enjoy the fun.
+  * put names the tempfile based on the remote path to ease debugging
+
+* 2 bug fixes:
+
+  * passenger:start_app wasn't using the latest_release path
+  * set/fetch wasn't dealing with a default of false well. (Seth Falcon)
+
+=== 1.3.2 / 2009-03-16
+
+* 3 minor enhancements:
+
+  * Added 'Deploying Merb with Vlad' by Graham Ashton.
+  * Added 'Deploying Sinatra with Vlad' by Graham Ashton.
+  * Core update task calls update with the actual revision once again
+
+* 1 bug fix:
+
+  * Fix Git checkout/export methods. (Wilson)
+
+=== 1.3.1 / 2009-03-06
+
+* 4 minor enhancements:
+
+  * Added faq on how to clear/replace tasks. (mikehale)
+  * Added sudo_prompt variable.
+  * Added top level sudo method to compliment run. (woahdae)
+  * Set sudo_flags to default to ['-p Password:']. (mly)
+
+* 3 bug fixes:
+
+  * Fixed prompts during rollback. (goodieboy)
+  * deploy_via went AWOL in subversion module.
+  * vlad:migrate ignored migrate_target directory. (tomklaasen)
+
+=== 1.3.0 / 2009-03-04
+
+* 9 major enhancements:
+
+  * Added darcs support. (Brian Palmer)
+  * Added git support. (Garry Dolley)
+  * Added lighttpd support.
+  * Added merb support. (Jamie Macey)
+  * Added passenger support. (Alan Harper)
+  * Added/merged god, nginx, thin, and maintenance tasks. (github clusterfuck)
+  * Allow set to specify that a proc value is :per_thread.
+  * Apply Mercurial SCM support patch. Closes ticket 13475
+  * remote_task now supports args and supplies task (by Daniel P. Kionka).
+
+* 19 minor enhancements:
+
+  * Add role toplevel method similar to namespace.
+  * Added #put method that wraps up Tempfile/rsync pattern.
+  * Added #role toplevel method, similar to #namespace.
+  * Added FAQ for using vlad through a gateway.
+  * Added Phil Hagelburg's one-line multi-stage deployment patch
+  * Added rake tracing for rsync command.
+  * Added umask variable.
+  * Adds specific order to loading. Should fix a number of bugs.
+  * Extended vladdemo.sh to allow for N simulated hosts (mostly for testing)
+  * Fixed tempfile dependency in #put if you don't load lighttpd or perforce (yipstar)
+  * Mercurial now automatically initializes the repository. (Jamie Macey)
+  * Moved everything over to put.
+  * Now requires rake 0.8.1+.
+  * Parameterized 'head' into 'revision' variable (with head as default).
+  * Split shared symlink creation to a separate task. (Steve Purcell)
+  * Support rake 0.8.
+  * Switched to ThreadGroup for Action#execute
+  * Updated rakefile for new hoe abilities
+  * remote_task :role now allows an empty list of hosts.
+
+* 11 bug fixes:
+
+	* Fixed vladdemo.rb, now uses my checkout for further stress testing.
+	* Moved core recipe to front. Was breaking mongrel setup.
+  * Added automatic client setup for perforce.
+  * Fix mercurial support.
+  * Fixed 'too many files' error.
+  * Fixed a lame warning in the tests.
+  * Fixed cleanup to actually properly clean up.
+  * Fixed rake var doco
+  * Moved generic app setup to core from mongrel.
+  * SSH flags are now an Array for proper inclusion in the command. (Guillaume Pierronnet)
+  * git archive now specifically specifies tar format. (knaveofdiamonds)
+
+=== 1.1.1 / 2008-01-14
+
+* 5 major enhancements:
+
+  * Support for Rake 0.8. Should still work for Rake 0.7.
+  * Added git support (contributed by Garry Dolley).
+    * Reviewed for accuracy by Evan Phoenix.
+  * Added lighttpd.rb
+  * Added automatic client setup for perforce.
+  * Added mercurial SCM support patch. Closes ticket 13475.
+
+* 6 minor enhancements:
+
+  * Added #put method that wraps up Tempfile/rsync pattern.
+  * Added automatic p4 client setup for perforce.
+  * Added vladdemo.sh
+  * Moved everything over to put.
+  * Moved generic app setup to core from mongrel.
+  * Parameterized 'head' into 'revision' variable (with head as default).
+
+* 1 bug fix
+
+  * Fixed cleanup to actually properly clean up.
+
+=== 1.1.0 / 2007-09-12
+
+* 3 major enhancements:
+
+  * Vlad.load now takes a hash of recipe overrides, eg: Vlad.load :web => :nginx.
+    See rdoc for defaults.
+  * Removed vlad_tasks.rb and split into vlad/apache.rb, vlad/mongrel.rb,
+    and vlad/core.rb.
+  * The flog ratio between capistrano+deps / vlad+deps is pi (or, damn close)!
+
+* 12 minor enhancements:
+
+  * Added $TRACE to make it more available and cleaner to read.
+  * Added :svn_cmd variable.
+  * Added Rake.clear_tasks *str_or_regexp
+  * Added debug and mana_from_heaven tasks to Rakefile.
+  * Added more documentation.
+  * Added :rsync_cmd and :rsync_flags.
+  * Added :ssh_cmd and :ssh_flags.
+  * Added variable expansion to vlad:debug task.
+  * Removed :scm variable. Now a Vlad.load component/flavor/need-a-word-here.
+  * Removed :application var. Use it if you want it. We don't require it.
+  * Renamed :p4cmd to :p4_cmd.
+  * Renamed :rake var to :rake_cmd.
+
+* 2 (important) bug fixes:
+
+  * HUGE: Fixed sudo hang bug #13072. Fix suggested by Chris Van Pelt.
+  * HUGE: Vlad.load calls user config last, allowing variable overrides.
+    ACK! Sorry!
+
+=== 1.0.0 / 2007-08-04
+
+* 1 major enhancement
+
+  * Birthday!

data/Manifest.txt

@@ -0,0 +1,23 @@
+.autotest
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+considerations.txt
+doco/deploying-merb-with-vlad.txt
+doco/deploying-sinatra-with-vlad.txt
+doco/faq.txt
+doco/getting_started.txt
+doco/migration.txt
+doco/perforce.txt
+doco/variables.txt
+lib/vlad.rb
+lib/vlad/apache.rb
+lib/vlad/core.rb
+lib/vlad/maintenance.rb
+lib/vlad/passenger.rb
+lib/vlad/rails.rb
+lib/vlad/subversion.rb
+test/test_vlad.rb
+test/test_vlad_subversion.rb
+vladdemo.sh

data/README.txt

@@ -0,0 +1,78 @@
+= Vlad the Deployer by the Ruby Hit Squad
+
+* http://rubyhitsquad.com/
+* http://rubyforge.org/projects/hitsquad/
+
+== DESCRIPTION
+
+Vlad the Deployer is pragmatic application deployment automation,
+without mercy. Much like Capistrano, but with 1/10th the
+complexity. Vlad integrates seamlessly with Rake, and uses familiar
+and standard tools like ssh and rsync.
+
+Impale your application on the heartless spike of the Deployer.
+
+== FEATURES/PROBLEMS
+
+* Full deployment automation stack.
+* Turnkey deployment for mongrel+apache+svn.
+* Supports single server deployment with just 3 variables defined.
+* Built on rake. Easy. Engine is small.
+* Very few dependencies. All simple.
+* Uses ssh with your ssh settings already in place.
+* Uses rsync for efficient transfers.
+* Run remote commands on one or more servers.
+* Mix and match local and remote tasks.
+* Compatible with all of your tab completion shell script rake-tastic goodness.
+* Ships with tests that actually pass in 0.028 seconds!
+* Does NOT support Windows right now (we think). Coming soon in 1.2.
+
+== SYNOPSIS
+
+    % rake vlad:setup   # first time only
+    % rake vlad:update
+    % rake vlad:migrate # optional
+    % rake vlad:start
+
+== REQUIREMENTS
+
+* Rake
+* Hoe
+* Rubyforge
+* open4
+
+== INSTALL
+
+* sudo gem install vlad
+
+== SPECIAL THANKS
+
+* First, of course, to Capistrano. For coming up with the idea and
+  providing a lot of meat for the recipes.
+* Scott Baron for coming up with one of the best project names evar.
+* Bradley Taylor for giving us permission to use RailsMachine recipes sans-LGPL.
+
+== LICENSE
+
+(The MIT License)
+
+Copyright (c) 2007-2009 Ryan Davis and the rest of the Ruby Hit Squad
+
+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/Rakefile

@@ -0,0 +1,37 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.plugin :seattlerb
+
+Hoe.add_include_dirs "../../rake-remote_task/dev/lib"
+
+Hoe.spec 'vlad' do
+  self.rubyforge_name = 'hitsquad'
+
+  developer 'Ryan Davis',       'ryand-ruby@zenspider.com'
+  developer 'Eric Hodel',       'drbrain@segment7.net'
+  developer 'Wilson Bilkovich', 'wilson@supremetyrant.com'
+
+  extra_deps << ['rake',  '~> 0.8.0']
+  extra_deps << ['rake-remote_task',  '~> 2.0']
+  extra_deps << ['open4', '~> 0.9.0']
+
+  # TODO: remove 1.9
+  multiruby_skip << "1.9" << "rubinius"
+end
+
+desc "quick little hack to see what the state of the nation looks like"
+task :debug do
+  $: << 'lib'
+  require 'vlad'
+  Vlad.load :config => "lib/vlad/subversion.rb"
+  set :repository, "repository path"
+  set :deploy_to,  "deploy path"
+  set :domain,     "server domain"
+
+  Rake::Task['vlad:debug'].invoke
+end
+
+# vim: syntax=ruby

data/considerations.txt

@@ -0,0 +1,91 @@
+* might we want per connection values?
+
+* :except => {:no_release => true}
+
+  It is common to configure tasks to 'announce' deployments in IRC, Campfire,
+  etc.  If you have 6 app servers, you don't want to see 6 announcements.  In
+  Capistrano, this is handled via the :no_release => true flag.  Various tasks
+  only execute on the 'release' servers.
+
+  An easier way to meet this would be to introduce a :release role in the
+  default setup
+
+    role :release, "app1.example.com"
+    
+    remote_task :announce_in_irc, :roles => :release ...
+
+  Drawback: Yet another thing to change when you migrate a project from cap to
+  vlad
+
+* 'dynamic deployments'
+
+    role :app, "app1.example.com"
+    role :app, "app2.example.com"
+
+  Let's say that app1 and app2 need slightly different monit configurations.
+
+  In Capistrano, you might approach this by making two additional roles, and 
+  splitting your 'push a monit config' task into two. This sucks.
+
+  Vlad makes the 'execution context' of a task available. In Vlad, you would:
+
+    remote_task :update_monit, :roles => :app
+      rsync "templates/#{target_host}.monitrc", "/etc/monitrc"
+    end
+
+* fine-grained tasks
+
+    remote_task :update
+    remote_task :symlink
+    remote_task :migrate
+    remote_task :deploy => [:update, :symlink, :migrate, :restart]
+
+  Let's assume that this is a multi-server config with shared deploy path.
+  The user wants to do only a single checkout. If we make "update" be one big
+  task body that includes the update, symlink, and migrate steps,
+  it is difficult for the user to override the roles for the particular steps
+  they need to change.
+
+  If we break these into separate tasks, they can say:
+
+    Rake::Task["migrate"].options[:roles] = :master_db
+
+  and the migrations will only run on the master db
+
+* sudo / via how? and if we call it via I will stab ppl. "user" is sufficient.
+
+* handling 'use_sudo'
+
+  1. Check for this inside the 'run' command, and preface the command
+     with 'sudo' if necessary
+
+  2. Default this to 'false' in the reset method, and check for it
+     in the default tasks that we provide:
+       if use_sudo then
+         sudo "blah"
+       else
+         run "blah"
+       end
+
+  Option 2 has fewer moving parts, but clutters up the tasks that care about
+  this.
+
+* Dependencies
+
+  Task dependencies aren't settable when creating a Rake::RemoteTask.
+
+* Apache configuration
+
+  Pull in railsmachine/rails/recipes/apache.rb's apache configuration.  Needs
+  erb to work.
+
+* I really like tasks with naming <cmd>_<role> (eg setup_app,
+  start_web). We could easily make the front end remote_task command
+  look for such a convention and apply the :role => x automatically.
+
+* from bousquet: get a couple of server environment recipes that prepare your
+  machine that would be the golden ticket:
+
+    rake vlad:prepare TYPE=accelerator | ubuntu | osx | osxserver | site5 | ...
+
+  and have people maintaining those setups who depend on them