fpauser-vlad 2.2.0

data/lib/vlad/passenger.rb

@@ -0,0 +1,8 @@
+require 'vlad'
+
+namespace :vlad do
+  desc 'Restart Passenger'
+  remote_task :start_app, :roles => :app do
+    run "touch #{current_release}/tmp/restart.txt"
+  end
+end

data/lib/vlad/rails.rb

@@ -0,0 +1,34 @@
+namespace :vlad do
+  set :rails_env,      "production"
+  set :migrate_args,   ""
+  set :migrate_target, :latest
+  set :mkdirs,         %w(tmp db)
+  set :shared_paths, {
+    'log'    => 'log',
+    'system' => 'public/system',
+    'pids'   => 'tmp/pids',
+  }
+
+  desc "Run the migrate rake task for the the app. By default this is run in
+    the latest app directory.  You can run migrations for the current app
+    directory by setting :migrate_target to :current.  Additional environment
+    variables can be passed to rake via the migrate_env variable.".cleanup
+
+  # No application files are on the DB machine, also migrations should only be
+  # run once.
+  remote_task :migrate, :roles => :app do
+    break unless target_host == Rake::RemoteTask.hosts_for(:app).first
+
+    directory = case migrate_target.to_sym
+                when :current then current_path
+                when :latest  then current_release
+                else
+                  raise(ArgumentError,
+                        "unknown migration target #{migrate_target.inspect}")
+                end
+
+    run ["cd #{directory}",
+         "#{rake_cmd} RAILS_ENV=#{rails_env} db:migrate #{migrate_args}"
+        ].join(" && ")
+  end
+end

data/lib/vlad/subversion.rb

@@ -0,0 +1,35 @@
+class Vlad::Subversion
+
+  set :source, Vlad::Subversion.new
+  set :svn_cmd, "svn"
+
+  ##
+  # Returns the command that will check out +revision+ from the repository
+  # into directory +destination+
+
+  def checkout(revision, destination)
+    "#{svn_cmd} co -r #{revision} #{repository} #{destination}"
+  end
+
+  ##
+  # Returns the command that will export +revision+ from the repository into
+  # the directory +destination+.
+
+  def export(revision_or_source, destination)
+    "#{svn_cmd} #{deploy_via} " +
+      if revision_or_source =~ /^(\d+|head)$/i then
+        "-r #{revision_or_source} #{repository} #{destination}"
+      else
+        "#{revision_or_source} #{destination}"
+      end
+  end
+
+  ##
+  # Returns a command that maps human-friendly revision identifier +revision+
+  # into a subversion revision specification.
+
+  def revision(revision)
+    "`#{svn_cmd} info #{repository} | grep 'Revision:' | cut -f2 -d\\ `"
+  end
+end
+

data/test/test_vlad.rb

@@ -0,0 +1,209 @@
+require 'rake/test_case'
+
+$TESTING = true
+
+class TestVlad < Rake::TestCase
+  def test_all_hosts
+    util_set_hosts
+    assert_equal %w[app.example.com db.example.com], @rake.all_hosts
+  end
+
+  def test_fetch
+    set :foo, 5
+    assert_equal 5, @rake.fetch(:foo)
+  end
+
+  def test_fetch_with_default
+    assert_equal 5, @rake.fetch(:not_here, 5)
+  end
+
+  def test_host
+    @rake.host "test.example.com", :app, :db
+    expected = {"test.example.com" => {}}
+    assert_equal expected, @rake.roles[:app]
+    assert_equal expected, @rake.roles[:db]
+  end
+
+  def test_host_invalid
+    assert_raises(ArgumentError) { @rake.host nil, :web }
+  end
+
+  def test_host_multiple_hosts
+    @rake.host "test.example.com", :app, :db
+    @rake.host "yarr.example.com", :app, :db, :no_release => true
+
+    expected = {
+      "test.example.com" => {},
+      "yarr.example.com" => {:no_release => true}
+    }
+
+    assert_equal expected, @rake.roles[:app]
+    assert_equal expected, @rake.roles[:db]
+    refute_equal(@rake.roles[:db]["test.example.com"].object_id,
+                 @rake.roles[:app]["test.example.com"].object_id)
+  end
+
+  def test_hosts_for_array_of_roles
+    util_set_hosts
+    assert_equal %w[app.example.com db.example.com], @rake.hosts_for([:app, :db])
+  end
+
+  def test_hosts_for_one_role
+    util_set_hosts
+    @rake.host "app2.example.com", :app
+    assert_equal %w[app.example.com app2.example.com], @rake.hosts_for(:app)
+  end
+
+  def test_hosts_for_multiple_roles
+    util_set_hosts
+    assert_equal %w[app.example.com db.example.com], @rake.hosts_for(:app, :db)
+  end
+
+  def test_hosts_for_unique
+    util_set_hosts
+    @rake.host "app.example.com", :web
+    assert_equal %w[app.example.com db.example.com], @rake.hosts_for(:app, :db, :web)
+  end
+
+  def test_initialize
+    @rake.set_defaults # ensure these three are virginal
+    assert_raises(Rake::ConfigurationError) { @rake.repository }
+    assert_raises(Rake::ConfigurationError) { @rake.deploy_to }
+    assert_raises(Rake::ConfigurationError) { @rake.domain }
+  end
+
+  def test_role
+    @rake.role :app, "test.example.com"
+    expected = {"test.example.com" => {}}
+    assert_equal expected, @rake.roles[:app]
+  end
+
+  def test_role_multiple_hosts
+    @rake.role :app, "test.example.com"
+    @rake.role :app, "yarr.example.com", :no_release => true
+    expected = {
+      "test.example.com" => {},
+      "yarr.example.com" => {:no_release => true}
+    }
+    assert_equal expected, @rake.roles[:app]
+  end
+
+  def test_role_multiple_roles
+    @rake.role :app, "test.example.com", :primary => true
+    @rake.role :db, "yarr.example.com", :no_release => true
+    expected_db = { "yarr.example.com" => {:no_release => true} }
+    assert_equal expected_db, @rake.roles[:db]
+    expected_app = { "test.example.com" => {:primary => true} }
+    assert_equal expected_app, @rake.roles[:app]
+  end
+
+  def test_remote_task
+    t = @rake.remote_task(:test_task) { 5 }
+    assert_equal @task_count + 1, Rake.application.tasks.size
+    assert_equal({ :roles => [] }, t.options)
+  end
+
+  def test_remote_task_all_hosts_by_default
+    util_set_hosts
+    t = @rake.remote_task(:test_task) { 5 }
+    assert_equal %w[app.example.com db.example.com], t.target_hosts
+  end
+
+  def test_remote_task_environment_override
+    old_env_hosts = ENV["HOSTS"]
+    ENV["HOSTS"] = 'other1.example.com,   other2.example.com'
+    util_set_hosts
+    t = @rake.remote_task(:test_task) { 5 }
+    assert_equal %w[other1.example.com other2.example.com], t.target_hosts
+  ensure
+    ENV["HOSTS"] = old_env_hosts
+  end
+
+  def test_remote_task_body_set
+    set(:some_variable, 5)
+    @rake.host 'www.example.com', :app
+    @rake.remote_task(:some_task) do $some_task_result = some_variable end
+
+    Rake::Task['some_task'].execute nil
+    assert_equal @rake.fetch(:some_variable), $some_task_result
+  end
+
+  def test_remote_task_with_options
+    t = @rake.remote_task :test_task, :roles => [:app, :db] do
+      fail "should not run"
+    end
+    assert_equal({:roles => [:app, :db]}, t.options)
+  end
+
+  def test_remote_task_before_host_declaration
+    t = @rake.remote_task :test_task, :roles => :web do 5 end
+    @rake.host 'www.example.com', :web
+    assert_equal %w[www.example.com], t.target_hosts
+  end
+
+  def test_remote_task_role_override
+    host "db1", :db
+    host "db2", :db
+    host "db3", :db
+    host "master", :master_db
+
+    remote_task(:migrate_the_db, :roles => [:db]) { flunk "bad!" }
+    task = Rake::Task["migrate_the_db"]
+    assert_equal %w[db1 db2 db3], task.target_hosts
+
+    task.options[:roles] = :master_db
+    assert_equal %w[master], task.target_hosts
+
+    task.options[:roles] = [:master_db]
+    assert_equal %w[master], task.target_hosts
+  end
+
+  def test_set
+    set :win, 5
+    assert_equal 5, @rake.win
+  end
+
+  def test_set_lazy_block_evaluation
+    set(:lose) { raise "lose" }
+    assert_raises(RuntimeError) { @rake.lose }
+  end
+
+  def test_set_with_block
+    x = 1
+    set(:win) { x += 2 }
+
+    assert_equal 3, @rake.win
+    assert_equal 3, @rake.win
+  end
+
+  def test_set_with_reference
+    @rake.instance_eval do
+      set(:var_one) { var_two }
+      set(:var_two) { var_three }
+      set(:var_three) { 5 }
+    end
+
+    assert_equal 5, @rake.var_one
+  end
+
+  def test_set_with_block_and_value
+    e = assert_raises(ArgumentError) do
+      set(:loser, 5) { 6 }
+    end
+    assert_equal "cannot provide both a value and a block", e.message
+  end
+
+  def test_set_with_nil
+    set(:win, nil)
+    assert_equal nil, @rake.win
+  end
+
+  def test_set_with_reserved_name
+    $TESTING = false
+    e = assert_raises(ArgumentError) { set(:all_hosts, []) }
+    assert_equal "cannot set reserved name: 'all_hosts'", e.message
+  ensure
+    $TESTING = true
+  end
+end
+

data/test/test_vlad_subversion.rb

@@ -0,0 +1,26 @@
+require 'vlad'
+require 'vlad/subversion'
+
+class TestVladSubversion < MiniTest::Unit::TestCase
+  def setup
+    super
+    @scm = Vlad::Subversion.new
+    set :repository, "svn+ssh://repo/myproject"
+  end
+
+  def test_checkout
+    cmd = @scm.checkout 'HEAD', '/the/place'
+    assert_equal 'svn co -r HEAD svn+ssh://repo/myproject /the/place', cmd
+  end
+
+  def test_export
+    cmd = @scm.export 'HEAD', '/the/place'
+    assert_equal 'svn export -r HEAD svn+ssh://repo/myproject /the/place', cmd
+  end
+
+  def test_revision
+    cmd = @scm.revision('HEAD')
+    expected = "`svn info svn+ssh://repo/myproject | grep 'Revision:' | cut -f2 -d\\ `"
+    assert_equal expected, cmd
+  end
+end

data/vladdemo.sh

@@ -0,0 +1,97 @@
+#!/bin/bash
+
+N=$1; shift
+
+killall mongrel svnserve 2> /dev/null
+
+rm -rf ~/demo
+mkdir ~/demo
+cd ~/demo
+
+pause() {
+  echo -n "waiting... hit return... "
+  read
+  echo
+}
+
+echo "Starting demo from scratch"
+echo "  This step creates a subversion repository and imports a new rails app"
+echo "  It modifies the Rakefile to load Vlad and creates config/deploy.rb"
+echo
+pause
+
+svnadmin create svnrepo
+echo "anon-access = write" >> svnrepo/conf/svnserve.conf
+
+svnserve -d --foreground -r svnrepo --listen-host localhost &
+
+echo "cd ~/demo
+rm -rf website_*
+svnserve -d --foreground -r svnrepo --listen-host localhost &
+
+cd mydemoapp
+ruby -I ~/Work/p4/zss/src/vlad/dev/lib -S rake -t vlad:setup vlad:update
+
+kill %1" > go.sh
+chmod u+x go.sh
+
+rails mydemoapp
+
+cd mydemoapp
+
+echo "require 'rubygems'
+require 'vlad'
+Vlad.load" >> Rakefile
+
+echo "set :repository, 'svn://localhost/blah'
+set :domain, 'localhost'
+set :web_command, 'sudo apachectl'" > config/deploy.rb
+
+# TODO: add a knob
+if [ -n "$N" ]; then
+    echo "set(:deploy_to, :per_thread) {
+  File.expand_path(\"~/demo/website_#{target_host}\")
+}
+
+%w(current_path current_release latest_release
+   previous_release releases_path release_path
+   scm_path shared_path).each do |name|
+  Rake::RemoteTask.per_thread[name] = true
+end
+
+(1..$N).each do |n|
+  host 'localhost%02d' % n, :web, :app
+end" >> config/deploy.rb
+else
+    echo "set :deploy_to, File.expand_path('~/demo/website')" >> config/deploy.rb
+fi
+
+svn import -m Added . svn://localhost/blah
+
+echo
+echo "Here is your config:"
+cat config/deploy.rb
+echo
+echo "Here are the tasks available:"
+echo
+
+ruby -I ~/Work/p4/zss/src/vlad/dev/lib -S rake -T vlad
+
+echo
+echo "The next step deploys and fires up the application"
+echo
+pause
+
+ruby -I ~/Work/p4/zss/src/vlad/dev/lib -S rake -t vlad:setup vlad:update vlad:start
+
+open http://localhost:8000/
+
+echo
+echo "done! check it out"
+echo
+pause
+
+ruby -I ~/Work/p4/zss/src/vlad/dev/lib -S rake vlad:stop
+
+kill %1
+

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification
+name: fpauser-vlad
+version: !ruby/object:Gem::Version
+  version: 2.2.0
+  prerelease: 
+platform: ruby
+authors:
+- Ryan Davis
+- Eric Hodel
+- Wilson Bilkovich
+- Falk Pauser
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-06-22 00:00:00.000000000 +02:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &7940880 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *7940880
+- !ruby/object:Gem::Dependency
+  name: open4
+  requirement: &7940380 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *7940380
+- !ruby/object:Gem::Dependency
+  name: fpauser-rake-remote_task
+  requirement: &7939820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: *7939820
+description: ! "\n    Vlad the Deployer is pragmatic application deployment automation,
+  without mercy.\n    Much like Capistrano, but with 1/10th the complexity. Vlad integrates
+  seamlessly\n    with Rake, and uses familiar and standard tools like ssh and rsync.
+  Impale your\n    application on the heartless spike of the Deployer.\n  "
+email:
+- ryand-ruby@zenspider.com
+- drbrain@segment7.net
+- wilson@supremetyrant.com
+- falk.pauser@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.txt
+files:
+- .autotest
+- Gemfile
+- Gemfile.lock
+- 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
+has_rdoc: true
+homepage: http://github.com/fpauser/vlad
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Vlad the Deployer is pragmatic application deployment automation, without
+  mercy.
+test_files: []