elbow 0.0.1 → 0.0.2

data/README.md

@@ -1,6 +1,10 @@
 # Elbow
 
-TODO: Write a gem description
+Elbow is a Capistrano plugin for deploying to an AWS Elastic Load Balancer (ELB)
+
+In the cloud, your web instances are forever changing. This Gem allows you to define in
+your cap file that a host is using an ELB and it will detect the EC2 instances and deploy
+your app to each of them.
 
 ## Installation
 
@@ -18,7 +22,29 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+In your `deploy.rb`
+
+    require 'elbow/capistrano'
+
+`elbow` requires your aws credentials, set them in your `deploy.rb`
+
+    set :aws_access_key_id, 'YOUR_ACCESS_KEY_ID'
+    set :aws_secret_access_key, 'YOUR_SECRET_ACCESS_KEY'
+
+Tell `elbow` that a host is using an ELB by specifying the `elastic_load_balancer`
+configuration in in your `deploy.rb`. The first argument is the host name followed
+by a list of roles.
+
+    elastic_load_balancer example.com, :app, :web
+
+The host name is expected to be a CNAME for the ELB public DNS, as such a DNS looked is
+performed against the host name.
+
+By default the ELB is assumed to be in the AWS region `us-east-1`. You can use a
+different region by setting the following in your `deploy.rb`
+
+    set :aws_region, 'ap-southeast-2'
+
 
 ## Contributing
 

data/lib/elbow/capistrano.rb

@@ -9,11 +9,14 @@ Capistrano::Configuration.instance(:must_exist).load do
     all_cnames= packet.answer.reject { |p| !p.instance_of? Net::DNS::RR::CNAME }
     cname = all_cnames.find { |c| c.name == "#{name}."}.cname[0..-2]
 
-    elb = AWS::ELB.new(:access_key_id => fetch(:aws_access_key_id),
-                       :secret_access_key => fetch(:aws_secret_access_key))
-
-    load_balancer = elb.load_balancers.find { |elb| elb.dns_name == cname }
-    raise "EC2 Load Balancer not found for #{name}" if load_balancer.nil?
+    aws_region= fetch(:aws_region, 'us-east-1')
+    AWS.config(:access_key_id => fetch(:aws_access_key_id),
+               :secret_access_key => fetch(:aws_secret_access_key),
+               :ec2_endpoint => "ec2.#{aws_region}.amazonaws.com",
+               :elb_endpoint => "elasticloadbalancing.#{aws_region}.amazonaws.com")
+
+    load_balancer = AWS::ELB.new.load_balancers.find { |elb| elb.dns_name.downcase == cname.downcase }
+    raise "EC2 Load Balancer not found for #{name} in region #{aws_region}" if load_balancer.nil?
 
     load_balancer.instances.each do |instance|
       hostname = instance.dns_name

data/lib/elbow/version.rb

@@ -1,3 +1,3 @@
 module Elbow
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: elbow
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-11 00:00:00.000000000 Z
+date: 2013-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk
@@ -71,18 +71,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -3654321242792836432
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -3654321242792836432
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23