rubber 1.11.0 → 1.12.0

data/CHANGELOG

@@ -1,3 +1,23 @@
+1.11.0
+-----
+
+Regenerate gemspec for version 1.11.0 <1358116> [Kevin Menard]
+We've been using RVM for a while now, so time to kill that warning message. <1d29137> [Kevin Menard]
+Make the generated Rakefile play nicer with bundler and rubber transformation. <90f6702> [Kevin Menard]
+Truly make the DBPASS field optional. <ba0aa56> [Kevin Menard]
+Allow creation of LVM volumes over ephemeral devices. <319e80b> [Kevin Menard]
+Bumped passenger version. <d4b4950> [Kevin Menard]
+add detach volume <9daa912> [Matt Conway]
+fix passing of passwd to mysqldump <143d467> [Matt Conway]
+Added new feature to lock down the version of RubyGems installed on a cluster by RVM. <652f908> [Kevin Menard]
+Bumped the version of RVM so we can get the latest security fix releases of Ruby. <9fb2383> [Kevin Menard]
+Merge branch 'master' of github.com:wr0ngway/rubber <58d3209> [Kevin Menard]
+Upgraded redis to 2.2.1. <aa0aa31> [Kevin Menard]
+Bumped Passenger to version 3.0.3. <cad658a> [Kevin Menard]
+sphinx default port has changed to 9312 <eee2bd0> [Nick Plante]
+Merge branch 'master' of https://github.com/wr0ngway/rubber <2ff0188> [Nick Plante]
+fix file write for db restoration <15fe2e0> [Nick Plante]
+
 1.10.2
 -----
 

data/VERSION

@@ -1 +1 @@
-1.11.0
+1.12.0

data/generators/vulcanize/templates/passenger/config/rubber/deploy-passenger.rb

@@ -9,8 +9,14 @@ namespace :rubber do
     
     task :custom_install, :roles => :passenger do
       rubber.sudo_script 'install_passenger', <<-ENDSCRIPT
-        if [[ -z `ls #{rubber_env.passenger_lib} 2> /dev/null` ]]; then
+        # can't use passenger_lib from rubber here as it only evaluates correctly
+        # when variable interpolation of rvm_gem_home is run remotely, and since we
+        # are in cap, we run the interpolation locally
+        #
+        passenger_lib=$(find /usr/local/rvm -path "*/passenger-#{rubber_env.passenger_version}/*/mod_passenger.so" 2> /dev/null)
+        if [[ -z $passenger_lib ]]; then
           echo -en "\n\n\n\n" | passenger-install-apache2-module
+          rvm #{rubber_env.rvm_ruby} --passenger
         fi
       ENDSCRIPT
     end

data/lib/generators/vulcanize/templates/passenger/config/rubber/deploy-passenger.rb

@@ -9,8 +9,14 @@ namespace :rubber do
     
     task :custom_install, :roles => :passenger do
       rubber.sudo_script 'install_passenger', <<-ENDSCRIPT
-        if [[ -z `ls #{rubber_env.passenger_lib} 2> /dev/null` ]]; then
+        # can't use passenger_lib from rubber here as it only evaluates correctly
+        # when variable interpolation of rvm_gem_home is run remotely, and since we
+        # are in cap, we run the interpolation locally
+        #
+        passenger_lib=$(find /usr/local/rvm -path "*/passenger-#{rubber_env.passenger_version}/*/mod_passenger.so" 2> /dev/null)
+        if [[ -z $passenger_lib ]]; then
           echo -en "\n\n\n\n" | passenger-install-apache2-module
+          rvm #{rubber_env.rvm_ruby} --passenger
         fi
       ENDSCRIPT
     end

data/lib/rubber.rb

@@ -61,6 +61,7 @@ module Rubber
 end
 
 
+require 'rubber/thread_safe_proxy'
 require 'rubber/configuration'
 require 'rubber/environment'
 require 'rubber/generator'

data/lib/rubber/instance.rb

@@ -1,4 +1,5 @@
 require 'yaml'
+require 'monitor'
 
 module Rubber
   module Configuration
@@ -8,18 +9,20 @@ module Rubber
     class Instance
       attr_reader :file, :artifacts
       include Enumerable
+      include MonitorMixin
 
       def initialize(file)
+        super
         Rubber.logger.debug{"Reading rubber instances from #{file}"}
         @file = file
         @items = {}
         @artifacts = {'volumes' => {}, 'static_ips' => {}}
 
-        @filters = ENV['FILTER'].split(/\s*,\s*/) rescue []
+        @filters = Rubber::Util::parse_aliases(ENV['FILTER'])
         @filters, @filters_negated = @filters.partition {|f| f !~ /^-/ }
         @filters_negated = @filters_negated.collect {|f| f[1..-1] }
 
-        @filter_roles = ENV['FILTER_ROLES'].split(/\s*,\s*/) rescue []
+        @filter_roles = Rubber::Util::parse_aliases(ENV['FILTER_ROLES'])
         @filter_roles, @filter_roles_negated = @filter_roles.partition {|f| f !~ /^-/ }
         @filter_roles_negated = @filter_roles_negated.collect {|f| f[1..-1] }
 
@@ -38,10 +41,12 @@ module Rubber
       end
 
       def save()
-        data = []
-        data.push(*@items.values)
-        data.push(@artifacts)
-        File.open(@file, "w") { |f| f.write(YAML.dump(data)) }
+        synchronize do
+          data = []
+          data.push(*@items.values)
+          data.push(@artifacts)
+          File.open(@file, "w") { |f| f.write(YAML.dump(data)) }
+        end
       end
 
       def [](name)
@@ -57,6 +62,8 @@ module Rubber
       def filtered()
         filtered_results = []
 
+        validate_filters()
+
         if @filters.size == 0 && @filter_roles.size == 0
           filtered_results.concat(@items.values)
         else
@@ -72,6 +79,18 @@ module Rubber
         return filtered_results
       end
 
+      def validate_filters()
+        aliases = @items.values.collect{|ic| ic.name}
+        [@filters, @filters_negated].flatten.each do |f|
+          raise "Filter doesn't match any hosts: #{f}" if ! aliases.include?(f)
+        end
+
+        roles = all_roles
+        [@filter_roles, @filter_roles_negated].flatten.each do |f|
+          raise "Filter doesn't match any roles: #{f}" if ! roles.include?(f)
+        end
+      end
+
       def all_roles()
         @items.collect {|n, i| i.role_names}.flatten.uniq
       end

data/lib/rubber/recipes/rubber.rb

@@ -53,9 +53,12 @@ namespace :rubber do
     # Disable connecting to any Windows instance.
     # pass -l to bash in :shell to that run also gets full env
     # use a pty so we don't get "stdin: is not a tty" error output
-    set :default_run_options, :pty => true, :shell => "/bin/bash -l", :except => { :platform => 'windows' }
+    default_run_options[:pty] = true
+    default_run_options[:shell] = "/bin/bash -l"
+    default_run_options[:except] = { :platform => 'windows' }
 
-    set :cloud, Rubber::Cloud::get_provider(rubber_env.cloud_provider || "aws", rubber_env, self)
+    # sharing a Net::HTTP instance across threads doesn't work, so create a new instance per thread
+    set :cloud, Rubber::ThreadSafeProxy.new { Rubber::Cloud::get_provider(rubber_env.cloud_provider || "aws", rubber_env, self) }
 
     load_roles() unless rubber_env.disable_auto_roles
     # NOTE: for some reason Capistrano requires you to have both the public and

data/lib/rubber/recipes/rubber/instances.rb

@@ -4,13 +4,21 @@ namespace :rubber do
     Create a new EC2 instance with the given ALIAS and ROLES
   DESC
   required_task :create do
-    instance_alias = get_env('ALIAS', "Instance alias (e.g. web01)", true)
+    instance_aliases = get_env('ALIAS', "Instance alias (e.g. web01 or web01~web05,web09)", true)
+
+    aliases = Rubber::Util::parse_aliases(instance_aliases)
 
-    env = rubber_cfg.environment.bind(nil, instance_alias)
-    default_roles = env.instance_roles
-    r = get_env("ROLES", "Instance roles (e.g. web,app,db:primary=true)", true, default_roles)
+    if aliases.size > 1
+      default_roles = "roles for instance in *.yml"
+      r = get_env("ROLES", "Instance roles (e.g. web,app,db:primary=true)", false, default_roles)
+      r = "" if r == default_roles
+    else
+      env = rubber_cfg.environment.bind(nil, aliases.first)
+      default_roles = env.instance_roles
+      r = get_env("ROLES", "Instance roles (e.g. web,app,db:primary=true)", true, default_roles)
+    end
 
-    create_spot_instance = ENV.delete("SPOT_INSTANCE") || env.cloud_providers[env.cloud_provider].spot_instance
+    create_spot_instance = ENV.delete("SPOT_INSTANCE")
 
     if r == '*'
       instance_roles = rubber_cfg.environment.known_roles
@@ -18,24 +26,8 @@ namespace :rubber do
     else
       instance_roles = r.split(",")
     end
-
-    ir = []
-    instance_roles.each do |r|
-      role = Rubber::Configuration::RoleItem.parse(r)
-
-      # If user doesn't setup a primary db, then be nice and do it
-      if role.name == "db" && role.options["primary"] == nil && rubber_instances.for_role("db").size == 0
-        value = Capistrano::CLI.ui.ask("You do not have a primary db role, should #{instance_alias} be it [y/n]?: ")
-        role.options["primary"] = true if value =~ /^y/
-      end
-
-      ir << role
-    end
-
-    # Add in roles that the given set of roles depends on
-    ir = Rubber::Configuration::RoleItem.expand_role_dependencies(ir, get_role_dependencies)
-
-    create_instance(instance_alias, ir, create_spot_instance)
+    
+    create_instances(aliases, instance_roles, create_spot_instance)
   end
 
   desc <<-DESC
@@ -43,18 +35,25 @@ namespace :rubber do
     This is useful to run when rubber:create fails after instance creation
   DESC
   required_task :refresh do
-    instance_alias = get_env('ALIAS', "Instance alias (e.g. web01)", true)
+    instance_aliases = get_env('ALIAS', "Instance alias (e.g. web01 or web01~web05,web09)", true)
+
+    aliases = Rubber::Util::parse_aliases(instance_aliases)
+
     ENV.delete('ROLES') # so we don't get an error if people leave ROLES in env from :create CLI
-    refresh_instance(instance_alias)
+    
+    refresh_instances(aliases)
   end
 
   desc <<-DESC
     Destroy the EC2 instance for the given ALIAS
   DESC
   required_task :destroy do
-    instance_alias = get_env('ALIAS', "Instance alias (e.g. web01)", true)
+    instance_aliases = get_env('ALIAS', "Instance alias (e.g. web01 or web01~web05,web09)", true)
+
+    aliases = Rubber::Util::parse_aliases(instance_aliases)
+
     ENV.delete('ROLES') # so we don't get an error if people leave ROLES in env from :create CLI
-    destroy_instance(instance_alias)
+    destroy_instances(aliases, ENV['FORCE'] == 'true')
   end
 
   desc <<-DESC
@@ -178,25 +177,88 @@ namespace :rubber do
     results.each {|r| logger.info r}
   end
 
-
   set :print_ip_command, "ifconfig eth0 | awk 'NR==2 {print $2}' | awk -F: '{print $2}'"
 
+  # Creates the set of new instancea after figuring out the roles for each
+  def create_instances(instance_aliases, instance_roles, create_spot_instance=false)
+    creation_threads = []
+    refresh_threads = []
+
+    instance_aliases.each do |instance_alias|
+      fatal "Instance already exists: #{instance_alias}" if rubber_instances[instance_alias]
+
+      ir = []
+
+      roles = instance_roles
+      if roles.size == 0
+        env = rubber_cfg.environment.bind(nil, instance_alias)
+        roles = env.instance_roles.split(",") rescue []
+      end
+
+      roles.each do |r|
+        role = Rubber::Configuration::RoleItem.parse(r)
+
+        # If user doesn't setup a primary db, then be nice and do it
+        if role.name == "db" && role.options["primary"] == nil && rubber_instances.for_role("db").size == 0
+          value = Capistrano::CLI.ui.ask("You do not have a primary db role, should #{instance_alias} be it [y/n]?: ")
+          role.options["primary"] = true if value =~ /^y/
+        end
+
+        ir << role
+      end
+
+      # Add in roles that the given set of roles depends on
+      ir = Rubber::Configuration::RoleItem.expand_role_dependencies(ir, get_role_dependencies)
+
+      creation_threads << Thread.new do
+        create_instance(instance_alias, ir, create_spot_instance)
+
+        refresh_threads << Thread.new do
+          while ! refresh_instance(instance_alias)
+            sleep 1
+          end
+        end
+      end
+
+      sleep 2
+    end
+    
+    creation_threads.each {|t| t.join }
+
+    print "Waiting for instances to start"
+
+    while true do
+      print "."
+      sleep 2
+
+      break if refresh_threads.all? {|t| ! t.alive? }
+    end
+
+    refresh_threads.each {|t| t.join }
+
+    post_refresh
+  end
+
+  set :mutex, Mutex.new
+
   # Creates a new ec2 instance with the given alias and roles
   # Configures aliases (/etc/hosts) on local and remote machines
-  def create_instance(instance_alias, instance_roles, create_spot_instance=false)
-    fatal "Instance already exists: #{instance_alias}" if rubber_instances[instance_alias]
-
+  def create_instance(instance_alias, instance_roles, create_spot_instance)
     role_names = instance_roles.collect{|x| x.name}
     env = rubber_cfg.environment.bind(role_names, instance_alias)
 
     # We need to use security_groups during create, so create them up front
-    setup_security_groups(instance_alias, role_names)
+    mutex.synchronize do
+      setup_security_groups(instance_alias, role_names)
+    end
     security_groups = get_assigned_security_groups(instance_alias, role_names)
 
     ami = env.cloud_providers[env.cloud_provider].image_id
     ami_type = env.cloud_providers[env.cloud_provider].image_type
     availability_zone = env.availability_zone
 
+    create_spot_instance ||= env.cloud_providers[env.cloud_provider].spot_instance
+
     if create_spot_instance
       spot_price = env.cloud_providers[env.cloud_provider].spot_price.to_s
 
@@ -231,7 +293,7 @@ namespace :rubber do
       instance_id = cloud.create_instance(ami, ami_type, security_groups, availability_zone)
     end
 
-    logger.info "Instance #{instance_id} created"
+    logger.info "Instance #{instance_alias} created: #{instance_id}"
 
     instance_item = Rubber::Configuration::InstanceItem.new(instance_alias, env.domain, instance_roles, instance_id, security_groups)
     instance_item.spot_instance_request_id = request_id if create_spot_instance
@@ -246,14 +308,22 @@ namespace :rubber do
       sleep 0.5
       retry
     end
+  end
 
-    print "Waiting for instance to start"
-    while true do
-      print "."
-      sleep 2
+  def refresh_instances(instance_aliases)
+    refresh_threads = []
 
-      break if refresh_instance(instance_alias)
+    instance_aliases.each do |instance_alias|
+      refresh_threads << Thread.new do
+        while ! refresh_instance(instance_alias)
+          sleep 1
+        end
+      end
     end
+
+    refresh_threads.each {|t| t.join }
+
+    post_refresh
   end
 
   # Refreshes a ec2 instance with the given alias
@@ -296,46 +366,57 @@ namespace :rubber do
         end
       end
 
-      # setup amazon elastic ips if configured to do so
-      setup_static_ips
+      return true
+    end
+    return false
+  end
 
-      # Need to setup aliases so ssh doesn't give us errors when we
-      # later try to connect to same ip but using alias
-      setup_local_aliases
+  def post_refresh
+    env = rubber_cfg.environment.bind(nil, nil)
 
-      # re-load the roles since we may have just defined new ones
-      load_roles() unless env.disable_auto_roles
+    # setup amazon elastic ips if configured to do so
+    setup_static_ips
 
-      rubber_instances.save()
+    # Need to setup aliases so ssh doesn't give us errors when we
+    # later try to connect to same ip but using alias
+    setup_local_aliases
 
-      # Add the aliases for this instance to all other hosts
-      setup_remote_aliases
-      setup_dns_aliases
+    # re-load the roles since we may have just defined new ones
+    load_roles() unless env.disable_auto_roles
+    
+    rubber_instances.save()
 
-      return true
-    end
-    return false
+    # Add the aliases for this instance to all other hosts
+    setup_remote_aliases
+    setup_dns_aliases
   end
 
+  def destroy_instances(instance_aliases, force=false)
+    instance_aliases.each do |instance_alias|
+      destroy_instance(instance_alias, force)
+    end
+
+    post_destroy
+  end
 
   # Destroys the given ec2 instance
-  def destroy_instance(instance_alias)
+  def destroy_instance(instance_alias, force=false)
     instance_item = rubber_instances[instance_alias]
     fatal "Instance does not exist: #{instance_alias}" if ! instance_item
 
     env = rubber_cfg.environment.bind(instance_item.role_names, instance_item.name)
 
-    value = Capistrano::CLI.ui.ask("About to DESTROY #{instance_alias} (#{instance_item.instance_id}) in mode #{RUBBER_ENV}.  Are you SURE [yes/NO]?: ")
-    fatal("Exiting", 0) if value != "yes"
+    value = Capistrano::CLI.ui.ask("About to DESTROY #{instance_alias} (#{instance_item.instance_id}) in mode #{RUBBER_ENV}.  Are you SURE [yes/NO]?: ") unless force
+    fatal("Exiting", 0) if value != "yes" && ! force
 
     if instance_item.static_ip
-      value = Capistrano::CLI.ui.ask("Instance has a static ip, do you want to release it? [y/N]?: ")
-      destroy_static_ip(instance_item.static_ip) if value =~ /^y/
+      value = Capistrano::CLI.ui.ask("Instance has a static ip, do you want to release it? [y/N]?: ") unless force
+      destroy_static_ip(instance_item.static_ip) if value =~ /^y/ || force
     end
 
     if instance_item.volumes
-      value = Capistrano::CLI.ui.ask("Instance has persistent volumes, do you want to destroy them? [y/N]?: ")
-      if value =~ /^y/
+      value = Capistrano::CLI.ui.ask("Instance has persistent volumes, do you want to destroy them? [y/N]?: ") unless force
+      if value =~ /^y/ || force
         instance_item.volumes.clone.each do |volume_id|
           destroy_volume(volume_id)
         end
@@ -349,15 +430,20 @@ namespace :rubber do
     rubber_instances.remove(instance_alias)
     rubber_instances.save()
 
+    destroy_dyndns(instance_item)
+    cleanup_known_hosts(instance_item) unless env.disable_known_hosts_cleanup
+  end
+
+  def post_destroy
+    env = rubber_cfg.environment.bind(nil, nil)
+    
     # re-load the roles since we just removed some and setup_remote_aliases
     # shouldn't hit removed ones
     load_roles() unless env.disable_auto_roles
 
     setup_aliases
-    destroy_dyndns(instance_item)
-    cleanup_known_hosts(instance_item) unless env.disable_known_hosts_cleanup
   end
-
+  
   # Reboots the given ec2 instance
   def reboot_instance(instance_alias)
     instance_item = rubber_instances[instance_alias]

data/lib/rubber/thread_safe_proxy.rb

@@ -0,0 +1,21 @@
+
+module Rubber
+  class ThreadSafeProxy
+    instance_methods.each { |m| undef_method m unless m =~ /(^__|^send$|^object_id$)/ }
+
+    def initialize(&block)
+      @target_block = block
+    end
+    
+    protected
+
+    def method_missing(name, *args, &block)
+      target.send(name, *args, &block)
+    end
+
+    def target
+      Thread.current["thread_safe_proxy_target_#{object_id}"] ||= @target_block.call
+    end
+
+  end
+end

data/lib/rubber/util.rb

@@ -24,6 +24,22 @@ module Rubber
       
     end
 
+    def self.parse_aliases(instance_aliases)
+      aliases = []
+      alias_patterns = instance_aliases.to_s.strip.split(/\s*,\s*/)
+      alias_patterns.each do |a|
+        if a =~ /~/
+          range = a.split(/~/)
+          range_items = (range.first..range.last).to_a
+          raise "Invalid range, '#{a}', sequence generated no items" if range_items.size == 0
+          aliases.concat(range_items)
+        else
+          aliases << a
+        end
+      end
+      return aliases
+    end
+
     # Opens the file for writing by root
     def self.sudo_open(path, perms, &block)
       open("|sudo tee #{path} > /dev/null", perms, &block)

data/test/instance_test.rb

@@ -51,6 +51,14 @@ class InstanceTest < Test::Unit::TestCase
     setup
     assert_equal [@i1], @instance.filtered(), 'should not have negated hosts'
 
+    ENV['FILTER'] = 'host1~host3'
+    setup
+    assert_equal [@i1, @i2, @i3], @instance.filtered(), 'should allow range in filter'
+
+    ENV['FILTER'] = '-host1~-host3'
+    setup
+    assert_equal [@i4], @instance.filtered(), 'should allow negative range in filter'
+
     ENV['FILTER'] = '-host1'
     ENV['FILTER_ROLES'] = 'role1'
     setup
@@ -70,6 +78,40 @@ class InstanceTest < Test::Unit::TestCase
     ENV['FILTER_ROLES'] = '-role1'
     setup
     assert_equal [@i3, @i4], @instance.filtered(), 'should not have negated roles'
+
+    ENV['FILTER_ROLES'] = 'role1~role2'
+    setup
+    assert_equal [@i1, @i2, @i3, @i4], @instance.filtered(), 'should allow range in filter'
+
+    ENV['FILTER_ROLES'] = '-role1~-role2'
+    setup
+    assert_equal [], @instance.filtered(), 'should allow negative range in filter'
+  end
+
+  def test_validate_filters
+    ENV['FILTER'] = "nohost"
+    setup
+    assert_raises do
+      @instance.filtered()
+    end
+
+    ENV['FILTER'] = "-nohost"
+    setup
+    assert_raises do
+      @instance.filtered()
+    end
+
+    ENV['FILTER_ROLES'] = "norole"
+    setup
+    assert_raises do
+      @instance.filtered()
+    end
+
+    ENV['FILTER_ROLES'] = "-norole"
+    setup
+    assert_raises do
+      @instance.filtered()
+    end
   end
 
   def test_equality

metadata

@@ -1,13 +1,8 @@
 --- !ruby/object:Gem::Specification 
 name: rubber
 version: !ruby/object:Gem::Version 
-  hash: 59
   prerelease: 
-  segments: 
-  - 1
-  - 11
-  - 0
-  version: 1.11.0
+  version: 1.12.0
 platform: ruby
 authors: 
 - Matt Conway
@@ -15,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-04 00:00:00 -05:00
+date: 2011-03-18 00:00:00 -04:00
 default_executable: vulcanize
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -26,11 +21,6 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 31
-        segments: 
-        - 2
-        - 4
-        - 0
         version: 2.4.0
   type: :runtime
   version_requirements: *id001
@@ -42,11 +32,6 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 25
-        segments: 
-        - 0
-        - 9
-        - 17
         version: 0.9.17
   type: :runtime
   version_requirements: *id002
@@ -58,9 +43,6 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
         version: "0"
   type: :runtime
   version_requirements: *id003
@@ -72,9 +54,6 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
         version: "0"
   type: :runtime
   version_requirements: *id004
@@ -474,6 +453,7 @@ files:
 - lib/rubber/recipes/rubber/volumes.rb
 - lib/rubber/tag.rb
 - lib/rubber/tasks/rubber.rb
+- lib/rubber/thread_safe_proxy.rb
 - lib/rubber/util.rb
 - rails/init.rb
 - test/environment_test.rb
@@ -496,23 +476,17 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
       version: "0"
 requirements: []
 
 rubyforge_project: rubber
-rubygems_version: 1.5.3
+rubygems_version: 1.6.1
 signing_key: 
 specification_version: 3
 summary: A capistrano plugin for managing multi-instance deployments to the cloud (ec2)