deployee 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 654aada1c37b70ee8685f7b8195b4e4afa575c65
+  data.tar.gz: 1c55894ad2160eca2c34cc2bb0ff4681473e4cbb
+SHA512:
+  metadata.gz: ce5df9a66009289ff36c38dd53f6b693c64cf5f3e4e01b89fdef033c10487e04f89e5795a831a9e7d3ed5bddcf85c33a90c0279dcf65db1fb19413fed3b14ec9
+  data.tar.gz: 6319b2905e009353fea5606b1f3c6122d13d9bd801f5d802d2ef4fbeb05c84292421696f807a4fa9627d701bf908c54cdb3389317615829e4ea2a5c1754146ed

data/README.md

@@ -0,0 +1,62 @@
+# Deployee
+
+A tool to simplify deployments using AWS auto scaling engine.
+
+![MIT](https://octodex.github.com/images/constructocat2.jpg)
+
+## How it works?
+
+#### How deployments should work? 
+The autoscaling engine allows us a new concept of deployment. 
+Basically we promote a new version of an application. When a new instance of an AMI is created, during setup, the latest version of the promoted application is installed on this machine via script.
+In this model, the concept of deployment is only renew existing machines of a group of scalability.
+
+#### How the deployment is done (here the magic happens)
+We assume that the issue of promotion and setup is already solved in the setup of AMI.
+This tool helps you to renew all instances of a scale group.
+There are several ways to renew instances. We call these ways of strategies. Below is a list of the available strategies. Feel the urge to create your own strategy and send us a pull request.
+
+
+* [At Least One](https://github.com/robsonbittencourt/deployee/wiki/At-Least-One)
+* [Blackout](https://github.com/robsonbittencourt/deployee/wiki/Blackout)
+* [Computing Preserve](https://github.com/robsonbittencourt/deployee/wiki/Computing-Preserve)
+* [Double Capacity](https://github.com/robsonbittencourt/deployee/wiki/Double-Capacity)
+
+## Setup
+Install bundle `gem install bundle`
+
+Run `bundle install` command to install dependencies listed on `Gemfile`
+
+[Configure AWS credentials](http://docs.aws.amazon.com/AWSSdkDocsRuby/latest/DeveloperGuide/ruby-dg-setup.html#set-up-creds)
+
+## Running
+Execute deploy.rb passing as argument the name of the auto scaling group. 
+
+For example:
+`ruby deploy.rb -g my_group`
+
+## Resources
+[AWS Ruby SDK Documentation](http://docs.aws.amazon.com/AWSRubySDK/latest/_index.html)
+
+## License
+The MIT License (MIT)
+
+Copyright (c) 2014 uMov.me
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/bin/deployee

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require_relative '../lib/deployer/deploy_runner'
+
+#require all strategies
+Dir[File.join(File.dirname(__FILE__), '../lib/strategy', '**/*.rb')].sort.each {|file| require File.expand_path(file); }
+
+options = {}
+
+optparse = OptionParser.new do |opts|
+  opts.on('-g', '--group GROUP', 'Auto Scaling Group name') do |group|
+    options[:group] = group
+  end
+
+  opts.on('-h', '--help', 'Display this screen') do
+    puts opts
+    exit
+  end
+end
+
+begin
+  optparse.parse!
+  mandatory = [:group]
+  missing = mandatory.select{ |param| options[param].nil? }
+  if not missing.empty?
+    puts "Missing options: #{missing.join(', ')}"
+    puts optparse
+    exit
+  end
+rescue OptionParser::InvalidOption, OptionParser::MissingArgument
+  puts $!.to_s
+  puts optparse
+  exit
+end
+
+strategy = DoubleCapacityDeployment.new
+deploy = DeployRunner.new strategy
+deploy.run options[:group]

data/deployee.gemspec

@@ -0,0 +1,10 @@
+Gem::Specification.new do |s|
+  s.name		    = "deployee"
+  s.version      	= "0.0.1"
+  s.description		= "A tool to simplify deployments using AWS auto scaling engine."
+  s.summary   		= ""
+  s.author     		= "Eduardo Bohrer, Gabriel Prestes, Guilherme Elias, Robson Bittencourt"
+  s.files           = Dir["{lib/**/*,README.md,*.gemspec}"]
+  s.executables	    = "deployee"
+  s.add_runtime_dependency 'aws-sdk', '~> 1.52', '>= 1.52.0' 
+end

data/lib/aws/scale_group.rb

@@ -0,0 +1,44 @@
+require 'aws-sdk'
+require_relative 'scale_instance'
+require_relative 'scale_loadbalancer'
+
+class ScaleGroup
+
+  def initialize group_name
+    @delegate = AWS::AutoScaling::Group.new group_name
+  end
+
+  def instances
+    @delegate.auto_scaling_instances.map do |instance|
+      ScaleInstance.new instance.id, self
+    end
+  end
+
+  def min_size
+    @delegate.min_size
+  end  
+
+  def max_size
+    @delegate.max_size
+  end  
+
+  def desired_capacity 
+    @delegate.desired_capacity
+  end
+
+  def update_size new_min_size, new_max_size
+    options = {:min_size => new_min_size, :max_size => new_max_size}
+    @delegate.update options
+  end
+
+  def health_load_balancer_instances
+    load_balancers.map{|lb| lb.healthy_instances}.reduce{|a, b| a + b}
+  end
+
+  def load_balancers
+    @delegate.load_balancer_names.map do |lb_name|
+      ScaleLoadBalancer.new lb_name
+    end
+  end
+
+end

data/lib/aws/scale_instance.rb

@@ -0,0 +1,23 @@
+require 'aws-sdk'
+
+class ScaleInstance
+  attr_reader :group
+
+  def initialize instance_id, group
+    @delegate = AWS::EC2::Instance.new instance_id;
+    @group = group
+  end
+
+  def id
+    @delegate.id
+  end
+
+  def exists?
+    @delegate.exists?
+  end
+
+  def terminate
+    @delegate.terminate
+  end
+
+end

data/lib/aws/scale_loadbalancer.rb

@@ -0,0 +1,15 @@
+require 'aws-sdk'
+
+class ScaleLoadBalancer
+
+  def initialize lb_name
+    @delegate = AWS::ELB::LoadBalancer.new lb_name
+  end
+
+  def healthy_instances
+    @delegate.instances.health.count do |health|
+      health[:state] == 'InService'
+    end
+  end
+
+end

data/lib/deployer/deploy_runner.rb

@@ -0,0 +1,42 @@
+require_relative '../aws/scale_group'
+
+class DeployRunner
+
+  def initialize strategy
+    @strategy = strategy
+  end
+
+  def run group_name
+    group = ScaleGroup.new group_name
+    instances = group.instances
+    
+    @strategy.before_group(group) if @strategy.respond_to? :before_group
+    deploy instances
+    @strategy.after_group group  if @strategy.respond_to? :after_group
+  end
+
+  def deploy instances
+    instances.each_with_index do |instance, index|
+      puts "Starting deployment #{index + 1}. Instance #{instance.id}"
+      deploy_instance instance
+      puts "Finished deployment #{index + 1}. Instance #{instance.id}"
+    end
+  end
+
+  def deploy_instance instance
+    if instance.exists?
+      @strategy.before_instance instance if @strategy.respond_to? :before_instance
+      renew instance
+      @strategy.after_instance instance  if @strategy.respond_to? :after_instance
+    else 
+      puts "Instance out. Ignored during renew"
+    end
+  end
+
+  def renew instance
+    puts "Terminating instance #{instance.id}"
+    instance.terminate
+    puts "Instance #{instance.id} sucessfully terminated"
+  end
+
+end

data/lib/helper/wait_until.rb

@@ -0,0 +1,11 @@
+
+module WaitUntil
+  
+  def wait_until 
+    sleep(30)
+    begin
+      sleep(15)
+    end until yield
+  end
+
+end

data/lib/strategy/at_least_one.rb

@@ -0,0 +1,31 @@
+require_relative '../helper/wait_until'
+
+class AtLeastOneDeployment
+  include WaitUntil
+
+  def before_group group
+    @min_size = group.min_size
+    max_size = group.max_size
+    new_min_size = 1
+
+    new_min_size = 2 if group.desired_capacity == 1
+      
+    group.update_size new_min_size, max_size + 1
+  end
+
+  def before_instance instance
+    wait_until_instances_ok instance.group
+  end
+
+  def after_group group
+    max_size = group.max_size
+    group.update_size @min_size, max_size - 1
+  end
+
+  def wait_until_instances_ok group
+    wait_until do
+      group.health_load_balancer_instances >= 2
+    end
+  end
+
+end

data/lib/strategy/blackout.rb

@@ -0,0 +1,4 @@
+
+class BlackoutDeployment
+
+end

data/lib/strategy/computing_preserve.rb

@@ -0,0 +1,27 @@
+
+class ComputingPreserveDeployment
+  include WaitUntil
+  
+  def before_group group
+    group.update_size(group.min_size + 1, group.max_size + 1)
+  end
+
+  def before_instance instance
+    wait_until_instances_ok instance.group
+  end
+
+  def after_instance instance
+    wait_until_instances_ok instance.group
+  end
+
+  def after_group group
+    group.update_size(group.min_size - 1, group.max_size - 1)
+  end
+
+  def wait_until_instances_ok group
+    wait_until do
+      group.health_load_balancer_instances == group.desired_capacity
+    end
+  end
+
+end

data/lib/strategy/double_capacity.rb

@@ -0,0 +1,18 @@
+
+class DoubleCapacityDeployment
+  include WaitUntil
+
+  def before_group group
+    @min_size = group.min_size
+    group.update_size(group.instances.size * 2, group.max_size * 2)
+    wait_until_instances_ok group
+    group.update_size(@min_size, group.max_size / 2)
+  end
+
+  def wait_until_instances_ok group
+    wait_until do
+      group.health_load_balancer_instances == group.desired_capacity
+    end
+  end
+
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: deployee
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Eduardo Bohrer, Gabriel Prestes, Guilherme Elias, Robson Bittencourt
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-10-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.52'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.52.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.52'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.52.0
+description: A tool to simplify deployments using AWS auto scaling engine.
+email: 
+executables:
+- deployee
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/deployee
+- deployee.gemspec
+- lib/aws/scale_group.rb
+- lib/aws/scale_instance.rb
+- lib/aws/scale_loadbalancer.rb
+- lib/deployer/deploy_runner.rb
+- lib/helper/wait_until.rb
+- lib/strategy/at_least_one.rb
+- lib/strategy/blackout.rb
+- lib/strategy/computing_preserve.rb
+- lib/strategy/double_capacity.rb
+homepage: 
+licenses: []
+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.4.2
+signing_key: 
+specification_version: 4
+summary: ''
+test_files: []