capistrano-getservers 1.0.4 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6a43e144053d96a9f3d045ace5d3a4e29fc1cfdd
-  data.tar.gz: 753933a10d5f9ac3857bbd7a34cb7eaec6b39c72
+  metadata.gz: 98bfb2e0ed4ad96b91d3ffbb6eab02013a10695d
+  data.tar.gz: 28c489544f18837ed68066906f80b98764d50720
 SHA512:
-  metadata.gz: 06553d032f540b03c02b541398ba30b8c51dd66dfa81f91667a543800b37ad7b5a4480d37bb61d9195828c1e9df1d2152214e90ae8ff3ebd980f1bbca1ebcca6
-  data.tar.gz: cf98bab6a17634ff816af391b659ce162ba6beb58ffc7f319e2a6ae06c0df9c90dd3cd44b92c8a9e7bd932ebe71e9cd10fcfd52e2eb9dd275e21966ff5276258
+  metadata.gz: f41dbbad785d11a17c615d8ae7c4d268059cd402e0043e7a548d17fe9e89dbc2f17e5f1bd7756701d1173eeb51a7b1c4efe3b6bb7fd69a70a90723e09620633d
+  data.tar.gz: 5ff7dbe906a66e27cee5520973811c0ead11e6bb49018a5159a93dfb47f6984d4b765001e9d95fe6d493c30ee49a1e5348a055fe10854d2e2a706b16483acdeb

data/README.md

@@ -1,9 +1,9 @@
 # Capistrano::Getservers
 
-capistrano-getservers makes it easier for you to deploy to your EC2
-instances.  By supplying a Hash to the `get_servers` method,
-capistrano-getservers connects to EC2 and retrieves all instances with
-matching tags.
+capistrano-getservers makes it easier for you to deploy to your EC2 or
+Rackspace Cloud instances. By supplying a Hash or Array, respectively, to the `get_servers` method,
+capistrano-getservers connects to the appropriate service and retrieves all instances with
+matching criteria.
 
 
 ## Installation
@@ -25,21 +25,36 @@ Ruby Gems
 * `gem 'capistrano'`
 * `gem 'fog'`
 
-Environment variables
+Environment variables (AWS EC2)
 * `export AWS_SECRET_ACCESS_KEY=''`
 * `export AWS_ACCESS_KEY_ID=''`
 
+Environment variables (Rackspace)
+* `export RACKSPACE_API_KEY=''`
+* `export RACKSPACE_USERNAME=''`
+
 ## Usage
 
 ### Retrieving instances within Capistrano
 
+#### AWS EC2
 In your capistrano script:
 ```ruby
 get_servers(:db, 'us-east-1', {'app' => 'app_name', 'cluster' => 'cluster', 'environment' => 'environment' ... })
 ```
 
+#### Rackspace Cloud Servers
+In your capistrano script:
+```ruby
+get_servers(:app, :ord, ['server1','server2','server3'])
+```
+
 ### Retrieving instances from your CLI
 
+First, add support for CLI arguments. I haven't personally tested using
+both AWS and Rackspace, but if you need to, it should work just fine, really.
+
+#### AWS EC2
 In your capistrano script:
 ```ruby
 set :tags, ENV['TAGS'] || {}
@@ -47,11 +62,21 @@ cli_tags = parse(tags)
 get_servers(:role, region, cli_tags)
 ```
 
-Then, via the command line:
+#### Rackspace
+```ruby
+set :names, ENV['NAMES'].split(',') || []
+get_servers(:role, region, names)
+```
+
+Then, pass your tags/instance names via the command line:
 
+##### AWS
 `$ cap staging deploy TAGS=key1:value1,key2:value2,key3:value3...`
 
-### Instances behind Amazon's VPC
+##### Rackspace
+`$ cap staging deploy NAMES=web001,awesomeserver,blah...`
+
+### Instances behind Amazon's VPC or that require a proxy
 If you have instances located in a VPC with no public IP address,
 capistrano-getservers will return their private ip address. You will
 then need to use capistrano's gateway support to deploy to these
@@ -66,15 +91,20 @@ set :gateway, "gateway_address"
 ### Notes
 
 You can pass `nil` as the second parameter to have capistrano-getservers
-default to the `us-east-1` region.
+default to the `us-east-1` region for Amazon EC2 or `dfw` for Rackspace
+Cloud servers.
 
 All servers will receive the role 'web' unless you specify a different
 role using the `get_servers` method.
 
 Example: `get_servers(:role, 'us-east-1', {'deploy' => 'some value', 'app' => 'some_value'})`
+Example: `get_servers(:role, :ord, ['web001','dbserver'])`
 
 ## Changelog
 
+Version 2.0.0:
+* Added support for Rackspace Cloud Servers
+
 Version 1.0.3:
 * get_servers now returns private instance ip addresses if no public
   address is available. See VPC notes above for more info.

data/capistrano-getservers.gemspec

@@ -5,11 +5,11 @@ require 'capistrano-getservers/get_servers'
 
 Gem::Specification.new do |gem|
   gem.name          = "capistrano-getservers"
-  gem.version       = '1.0.4'
+  gem.version       = '2.0.0'
   gem.authors       = ["Alfred Moreno"]
   gem.email         = ["alfred.moreno@zumba.com"]
-  gem.description   = %q{A capistrano plugin for simplifying EC2 deployment processes}
-  gem.summary       = %q{A capistrano plugin for simplifying EC@ deployment processes}
+  gem.description   = %q{A capistrano plugin for simplifying deployment processes to rackspace or amazon ec2}
+  gem.summary       = %q{A capistrano plugin for simplifying dynamic deployment processes to rackspace or amazon ec2}
   gem.homepage      = ""
 
   gem.files         = `git ls-files`.split($/)

data/lib/capistrano-getservers/get_servers.rb

@@ -6,54 +6,87 @@ unless Capistrano::Configuration.respond_to?(:instance)
 end
 
 module Capistrano
-  class Configuration
-    module GetServers
-      #############################################################
-      # def get_servers
-      #
-      # Purpose: Retrieves a list of EC2 instances containing a tag
-      #          list which matches a supplied hash.
-      #
-      #          Matching instances are applied to the Cap server
-      #          list.
-      #
-      # Usage: get_servers {'app' => 'zumba', 'stack' => 'web'}
-      #
-      # Returns: Nothing
-      #############################################################
-      def get_servers(role=nil, region=nil, cli_tags)
-
-        ec2 = Fog::Compute::AWS.new(
-          aws_secret_access_key: ENV['AWS_SECRET_ACCESS_KEY'],
-          aws_access_key_id: ENV['AWS_ACCESS_KEY_ID'],
-          region: region
-        )
-
-        ec2.servers.all.each do |instance|
-          begin
-            instance_tags = instance.tags.reject { |k,v| cli_tags[k] != instance.tags[k] }
-            server (instance.public_ip_address || instance.private_ip_address), (role || :web) if instance_tags.eql?(cli_tags)
-          rescue => error
+  module GetServers
+
+    def self.extend(configuration)
+      configuration.load do
+        Capistrano::Configuration.instance.load do
+
+          _cset(:aws_secret_access_key, ENV['AWS_SECRET_ACCESS_KEY'])
+          _cset(:aws_access_key_id, ENV['AWS_ACCESS_KEY_ID'])
+          _cset(:rackspace_api_key, ENV['RACKSPACE_API_KEY'])
+          _cset(:rackspace_username, ENV['RACKSPACE_USERNAME'])
+          _cset(:default_role, :web)
+
+          #############################################################
+          # def get_servers
+          #
+          # Purpose: Retrieves a list of EC2 instances containing a tag
+          #          list which matches a supplied hash.
+          #
+          #          Matching instances are applied to the Cap server
+          #          list.
+          #
+          # Usage: get_servers {'app' => 'zumba', 'stack' => 'web'}
+          #
+          # Returns: Nothing
+          #############################################################
+          def get_servers(role=nil, region=nil, cli_tags)
+
+            # Rackspace regions are a 3 letter code (i.e. 'ord')
+            if region.size == 3
+              rackspace = Fog::Compute.new(
+                provider: 'Rackspace',
+                rackspace_api_key: fetch(:rackspace_api_key),
+                rackspace_username: fetch(:rackspace_username),
+                rackspace_region: region
+              )
+
+              rackspace.servers.select do |rackspace_server|
+                if cli_tags.include?(rackspace_server.name)
+                  server (rackspace_server.ipv4_address || rackspace_server.addresses['private']['addr']), (role || :web)
+                end
+              end
+
+            else
+              ec2 = Fog::Compute::AWS.new(
+                aws_secret_access_key: ENV['AWS_SECRET_ACCESS_KEY'],
+                aws_access_key_id: ENV['AWS_ACCESS_KEY_ID'],
+                region: region
+              )
+
+              ec2.servers.all.each do |instance|
+                begin
+                  instance_tags = instance.tags.reject { |k,v| cli_tags[k] != instance.tags[k] }
+                  server (instance.public_ip_address || instance.private_ip_address), (role || :web) if instance_tags.eql?(cli_tags)
+                rescue
+                end
+              end
+            end
+
           end
-        end
 
-      end
+          #############################################################
+          # def parse
+          #
+          # Purpose: Parses a string object and returns a hash.
+          #
+          # Usage: parse 'k1:v1,k2:v2,k3:v3'
+          #
+          # Returns: {'k1' => 'v1', 'k2' => 'v2', 'k3' => 'v3'}
+          #############################################################
+          def parse tags
+            return unless tags.class.eql? String
+            tags.split(',').inject({}) { |hash, pair| Hash[*pair.split(':')].merge(hash) }
+          end
 
-      #############################################################
-      # def parse
-      #
-      # Purpose: Parses a string object and returns a hash.
-      #
-      # Usage: parse 'k1:v1,k2:v2,k3:v3'
-      #
-      # Returns: {'k1' => 'v1', 'k2' => 'v2', 'k3' => 'v3'}
-      #############################################################
-      def parse tags
-        return unless tags.class.eql? String
-        tags.split(',').each.inject({}) { |hash, pair| hash.merge! Hash[*pair.split(':').flatten] }
+        end
       end
-
     end
-    include GetServers
+
   end
 end
+
+if Capistrano::Configuration.instance
+  Capistrano::GetServers.extend(Capistrano::Configuration.instance)
+end

metadata

@@ -1,65 +1,66 @@
 --- !ruby/object:Gem::Specification
 name: capistrano-getservers
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 2.0.0
 platform: ruby
 authors:
 - Alfred Moreno
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-08 00:00:00.000000000 Z
+date: 2013-11-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capistrano
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.1.0
 - !ruby/object:Gem::Dependency
   name: fog
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.5.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: A capistrano plugin for simplifying EC2 deployment processes
+description: A capistrano plugin for simplifying deployment processes to rackspace
+  or amazon ec2
 email:
 - alfred.moreno@zumba.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -78,12 +79,12 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
@@ -91,5 +92,7 @@ rubyforge_project:
 rubygems_version: 2.0.2
 signing_key: 
 specification_version: 4
-summary: A capistrano plugin for simplifying EC@ deployment processes
+summary: A capistrano plugin for simplifying dynamic deployment processes to rackspace
+  or amazon ec2
 test_files: []
+has_rdoc: