ktheory-vlad 2.0.0

data/.autotest

@@ -0,0 +1,24 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+Autotest.add_hook :initialize do |at|
+  at.testlib = "minitest/autorun"
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   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/History.txt

@@ -0,0 +1,173 @@
+=== 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,25 @@
+.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/rake_remote_task.rb
+lib/vlad.rb
+lib/vlad/apache.rb
+lib/vlad/core.rb
+lib/vlad/maintenance.rb
+lib/vlad/passenger.rb
+lib/vlad/subversion.rb
+lib/vlad_test_case.rb
+test/test_rake_remote_task.rb
+test/test_vlad.rb
+test/test_vlad_subversion.rb
+vladdemo.sh

data/PATCHES.txt

@@ -0,0 +1,27 @@
+This file outlines how ktheory-vlad (http://github.com/ktheory/vlad) differs
+from seattlerb's vlad (http://hitsquad.rubyforge.org/vlad/) and vlad-git
+(http://github.com/jbarnette/vlad-git)
+
+Changes from vlad-2.0 (http://hitsquad.rubyforge.org/vlad/):
+
+* Include modules from vlad-1.4 that were removed in vlad-2.0.
+  In 2.0, seattlerb chose to remove modules for common web servers and SCMs
+  except apache, passenger, and subversion (vlad's defaults). The removed
+  modules must be installed seperately, but are difficult to find. See commit
+  a2b92b4ffdfb8748898289de96d8b84860122468
+
+* Fix vlad:start_app passenger task when run without a full deployment.
+  See http://rubyforge.org/tracker/index.php?func=detail&aid=26003&group_id=4213&atid=16258
+  and commit 82dccf88de1561369ef5089151a58345a236e2c9
+
+* Added the ability to prefix output with hostnames (or a custom string).
+  See http://rubyforge.org/tracker/index.php?func=detail&aid=20768&group_id=4213&atid=16261
+  and commit 7b6522df086f5e1c28d585483b9c74eb1fa660e5
+
+Changes from vlad-git-2.1.0 (http://github.com/jbarnette/vlad-git):
+
+* Use fast checkouts when possible insteading cloning the entire repo. (This
+  is an unreleased feature of vlad-git) See http://github.com/jbarnette/vlad-git/commit/749ab8f9bb7c24baafdd513a5b9d8246fc0a7f5a
+
+* Fixes submodule initializes for git version < 1.5.6. See commit
+  44ff0ef446560d4a8e193877d2b9f1c46c583b21

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,58 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'rake/testtask'
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/test*.rb']
+  t.verbose = true
+end
+task :default => :test
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "ktheory-vlad"
+    gemspec.summary = "Vlad the Deployer is pragmatic application deployment automation, without mercy [ktheory's fork]"
+    gemspec.description = %Q{
+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. This is a fork of vlad maintained by
+Aaron Suggs. See PATCHES.txt for more info""
+}
+    gemspec.homepage = "http://github.com/ktheory/vlad"
+    gemspec.authors = ['Ryan Davis','Eric Hodel', 'Wilson Bilkovich', 'Aaron Suggs']
+    gemspec.email = ['ryand-ruby@zenspider.com', 'drbrain@segment7.net', 'wilson@supremetyrant.com', 'aaron@ktheory.com']
+    gemspec.add_dependency 'rake',  '~> 0.8.0'
+    gemspec.add_dependency 'open4', '~> 0.9.0'
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install jeweler"
+end
+
+desc "quick little hack to see what the state of the nation looks like"
+task :debug do
+  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
+
+task :mana_from_heaven do
+  # vlad = vlad + rake + open4
+  # rake sans-contrib = 2035.98356718206
+  vlad  = `flog -s lib`.to_f + 2350.30744806517 + 502.363818023761
+  cap   = 11480.3919695285
+  ratio = cap / vlad
+  target = cap / Math::PI
+
+  puts "%14.8f = %s" % [vlad, "vlad"]
+  puts "%14.8f = %s" % [ratio, "ratio"]
+  puts "%14.8f = %s" % [target - vlad, "needed delta"]
+end
+
+# vim: syntax=ruby

data/VERSION

@@ -0,0 +1 @@
+2.0.0

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