cap3-elb 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f0cbf43b4f3d4cc5e1cda8080a3d504c94f77ec8
+  data.tar.gz: 35c7785fd21fd5f67ccb3eb1a91abab7e7389830
+SHA512:
+  metadata.gz: 72960d53bcc040f8fbbdbab0dfe188fdb2aacb787d89be6bb113f0c06016a3f2a3797604b3f803dfbc8b5337969855a69f3dcb5ff835ceef48a37691b6444552
+  data.tar.gz: c207cd3ea003bc83674a2d5a58c5795584dd27394b784d9b2b008c885e309ea368c33cc71e231c5bacd78ca1424dcb2005bd3abe488de02bdddb818d762f4b87

data/README.md

@@ -0,0 +1,68 @@
+This gem adds capistrano3 tasks for adding and removing nodes from
+Amazon's Elastic Load Balancer.
+
+## Installation
+
+1. Add `cap3-elb` to your Gemfile
+
+```
+# Gemfile
+gem 'cap3-elb'
+```
+
+2. Use `upload` scm in Capistrano
+```
+# Capfile
+require 'cap3-elb'
+```
+
+3. Configure the name of the load balancer and your AWS credentials. I suggest
+   storing the credentials in something like
+   [dotgpg](https://github.com/ConradIrwin/dotgpg) and using environment
+   variables to avoid storing these keys alongside your code.
+
+```
+# config/deploy.rb
+
+set :load_balancer, "website"
+
+set :aws_secret_access_key, ENV.fetch("AWS_SECRET_ACCESS_KEY")
+set :aws_access_key_id, ENV.fetch("AWS_ACCESS_KEY_ID")
+```
+
+## Usage
+
+### cap elb:status
+
+This shows you a list of all your hosts along with their load-balancer status.
+
+```
+bundle exec cap elb:status
+```
+
+### cap elb:add
+
+The `elb:add` task adds hosts to the load balancer. By default it will add
+all hosts, but you can filter things to only add one specific host using
+capistrano's `--host` flag:
+
+```
+bundle exec cap elb:add --host web1.example.com
+```
+
+### cap elb:remove
+
+The `elb:remove` task removes hosts from the load balancer. It will abort
+if you try and remove more than one node at a time, and also if removing
+the node would result in no healthy instances.
+
+```
+bundle exec cap elb:remove --host web1.example.com
+```
+
+## Meta-fu
+
+`cap3-elb` is released under the MIT license, see LICENSE.MIT for
+details. Bug reports and feature requests are welcome.
+
+

data/cap-scm-upload.gemspec

@@ -0,0 +1,17 @@
+Gem::Specification.new do |gem|
+  gem.name = 'cap3-elb'
+  gem.version = '0.1.0'
+
+  gem.summary = 'Capistrano tasks to maintain a load balancer'
+  gem.description = "Provides new commands to manage your ELB load balancer from capistrano."
+
+  gem.authors = ['Conrad Irwin']
+  gem.email = %w(conrad@bugsnag.com)
+  gem.homepage = 'http://github.com/ConradIrwin/cap3-elb'
+
+  gem.license = 'MIT'
+
+  gem.add_dependency 'capistrano', '~> 3.0'
+
+  gem.files = `git ls-files`.split("\n")
+end

data/lib/cap3-elb.rb

@@ -0,0 +1 @@
+load File.expand_path("../tasks/elb.cap", __FILE__)

data/lib/tasks/elb.cap

@@ -0,0 +1,72 @@
+require 'aws'
+require 'resolv'
+
+namespace :elb do
+  task :configure do
+    $load_balancer = AWS::ELB.new(
+      access_key_id: fetch(:aws_access_key_id),
+      secret_access_key: fetch(:aws_secret_access_key)
+    ).load_balancers[fetch(:load_balancer)]
+  end
+
+  desc "List the servers in the load balancer"
+  task :status => :configure do
+    in_balancer = $load_balancer.instances.each_with_object({}) { |i, result| result[i.ip_address] = i.elb_health }
+    roles(:app).each do |host|
+      ip = Resolv::DNS.new.getaddress(host.hostname).to_s
+      puts "#{host.hostname}: #{in_balancer.include?(ip) ? in_balancer[ip][:state] : "DOWN"}"
+    end
+  end
+
+  desc "Remove server from the load balancer"
+  task :remove => :configure  do
+    raise "don't remove more than one machine" if roles(:app).length > 1
+
+    on roles(:app), in: :sequence do |host|
+      instances = $load_balancer.instances.to_a
+      name = host.hostname[/^[^.]*/]
+
+
+      to_remove = instances.detect{ |instance| instance.tags[:Name] == name }
+      if to_remove
+
+
+        to_keep = instances - [to_remove]
+        unless to_keep.any?{ |instance| instance.elb_health[:state] == 'InService' }
+          raise "Refusing to take #{host} out of rotation as there are no other machines up"
+        end
+
+        puts "Removing #{host.hostname} from the #{fetch(:load_balancer).inspect} load balancer"
+
+        to_remove.remove_from_load_balancer
+        until to_remove.elb_health[:state] == "OutOfService"
+          print "."
+          sleep 1
+        end
+        puts "\n#{host.hostname} #{to_remove.elb_health[:state]}"
+      else
+        puts "#{host.hostname} is not in the #{fetch(:load_balancer).inspect} load balancer"
+      end
+    end
+  end
+
+  desc "Add server to the load balancer"
+  task :add => :configure do
+    on roles(:app), in: :sequence do |host|
+      puts "Adding #{host.hostname} to the #{fetch(:load_balancer).inspect} load balancer."
+
+      instance      = AWS::EC2.new.instances.filter('ip-address', Resolv::DNS.new.getaddress(host.hostname).to_s).first
+
+      $load_balancer.instances.register instance
+
+      puts "Waiting for #{host.hostname} to become active..."
+
+      instance = $load_balancer.instances[instance.id]
+      until instance.elb_health[:state] == "InService"
+        print "."
+        sleep 1
+      end
+      puts "\n#{host.hostname} #{instance.elb_health[:state]}"
+    end
+  end
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: cap3-elb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Conrad Irwin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Provides new commands to manage your ELB load balancer from capistrano.
+email:
+- conrad@bugsnag.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- cap-scm-upload.gemspec
+- lib/cap3-elb.rb
+- lib/tasks/elb.cap
+homepage: http://github.com/ConradIrwin/cap3-elb
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Capistrano tasks to maintain a load balancer
+test_files: []
+has_rdoc: