aws_blue_green_deploy 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a6c06739e02e7d9e900d8392d5f2ed55dceeddd3
+  data.tar.gz: fd9758012fb8623eec630cc4a605d22939184665
+SHA512:
+  metadata.gz: 905bae91e4dd00c3941702f46632f39c68849e7ad277e56b9e7f7c04d62212d0001e567880f02d0031ae678d8468870cb0a3789d271c4808b1dd83213b6fe77d
+  data.tar.gz: 5bdb8c3dbcd8c0490104e56acf15e3b3870fedbeea7d24fcbc5dc95bfc58203323989772ceaacdcc50c7babbb4e014ea6efa6bf09c12350e273108d1da738d5d

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rvmrc

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+
+# This is an RVM Project .rvmrc file, used to automatically load the ruby
+# development environment upon cd'ing into the directory
+
+# First we specify our desired <ruby>[@<gemset>], the @gemset name is optional,
+# Only full ruby name is supported here, for short names use:
+#     echo "rvm use 2.1.3@aws_blue_green_deploy" > .rvmrc
+environment_id="ruby-2.1.3@aws_blue_green_deploy"
+
+# Uncomment the following lines if you want to verify rvm version per project
+# rvmrc_rvm_version="1.25.33 (stable)" # 1.10.1 seems like a safe start
+# eval "$(echo ${rvm_version}.${rvmrc_rvm_version} | __rvm_awk -F. '{print "[[ "$1*65536+$2*256+$3" -ge "$4*65536+$5*256+$6" ]]"}' )" || {
+#   echo "This .rvmrc file requires at least RVM ${rvmrc_rvm_version}, aborting loading."
+#   return 1
+# }
+
+# First we attempt to load the desired environment directly from the environment
+# file. This is very fast and efficient compared to running through the entire
+# CLI and selector. If you want feedback on which environment was used then
+# insert the word 'use' after --create as this triggers verbose mode.
+if [[ -d "${rvm_path:-$HOME/.rvm}/environments"
+  && -s "${rvm_path:-$HOME/.rvm}/environments/$environment_id" ]]
+then
+  \. "${rvm_path:-$HOME/.rvm}/environments/$environment_id"
+  for __hook in "${rvm_path:-$HOME/.rvm}/hooks/after_use"*
+  do
+    if [[ -f "${__hook}" && -x "${__hook}" && -s "${__hook}" ]]
+    then \. "${__hook}" || true
+    fi
+  done
+  unset __hook
+  if (( ${rvm_use_flag:=1} >= 2 )) # display only when forced
+  then
+    if [[ $- == *i* ]] # check for interactive shells
+    then printf "%b" "Using: $(tput setaf 2 2>/dev/null)$GEM_HOME$(tput sgr0 2>/dev/null)
+" # show the user the ruby and gemset they are using in green
+    else printf "%b" "Using: $GEM_HOME
+" # don't use colors in non-interactive shells
+    fi
+  fi
+else
+  # If the environment file has not yet been created, use the RVM CLI to select.
+  rvm --create  "$environment_id" || {
+    echo "Failed to create RVM environment '${environment_id}'."
+    return 1
+  }
+fi
+
+# If you use bundler, this might be useful to you:
+# if [[ -s Gemfile ]] && {
+#   ! builtin command -v bundle >/dev/null ||
+#   builtin command -v bundle | GREP_OPTIONS="" 

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - "2.1.1"
+
+script: rake spec

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in aws_blue_green_deploy.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Jon Parten
+
+MIT License
+
+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/README.md

@@ -0,0 +1,77 @@
+# AwsBlueGreenDeploy
+
+## Summary
+
+This gem automates a "Blue/Green" style of web server farm deployments, in which one set of servers is active, in load balancer rotation, while the other set is out of rotation. Out of rotation servers are deployed to, validated and then put into rotation. The the formerly active servers are pulled out. 
+
+This gem automates this process with AutoScaling groups, and actually eliminates the need to have a pool of inactive servers. These servers are created at deploy time.
+
+This gem assumes you have 2 static autoscaling groups asscociated to the load balancer the deploy will be run against. 
+This gem manipulates the launch configuration and asg size of any auto scaling group that does not have instances in load balancer rotation in order to create new instances with a new version of code.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'aws_blue_green_deploy'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install aws_blue_green_deploy
+
+## Usage
+
+https://travis-ci.org/jparten/aws_blue_green_deploy.svg?branch=master
+
+To use:
+
+This gem assumes you have 2 static autoscaling groups asscociated to the load balancer the deploy will be run against. 
+This gem manipulates the launch configuration and asg size of any auto scaling group that does not have instances in load balancer rotation in order to create new instances with
+a new version of code. s
+
+
+Build a hash or a json config with the following parameters:
+
+* "elb_name" - Name of ELB to be manipulated by deploy action, the automation will identify which associated ASG's need to be manipulated.
+* "asg_size" - Number of instances to scale load balancer during deployment
+* "lc_name" - Name of launch configuration to be created by deployment process
+* "lc_image" - Ami ID to be used by new launch configuration
+* "lc_instance_type" - Instance size to be used by new new launch config
+* "lc_key_pair" - Authentication keypair to be used by new launch config
+* "lc_security_groups" - Array of security groups to be used by new launch config
+* "lc_user_data" - User data to be passed in to each instance created by the new launch config
+* "region" - AWS region where operation should is begin performed
+* "access_key_id" - Key with access to perform EC2 operations
+* "secret_access_key" - Secret key with access to perform EC2 operations
+
+Once the parameters above are in a json file, a A/B style release can be enacted by:
+
+```ruby
+AwsBlueGreenDeploy.configure_with("path to json config")
+AwsBlueGreenDeploy.enact_deployment
+```
+
+Alternatively you can configure by passing in a hash with the values above, overriding any values passed in via json:
+
+```ruby
+options = {:elb_name => "Test"}
+AwsBlueGreenDeploy.configure(options)
+AwsBlueGreenDeploy.enact_deployment
+```
+
+The module methods drive the DeployController class. This class can be used independently of the module to better control timing/validation neccessary for a production release. 
+
+
+## Contributing
+
+1. Fork it ( https://github.com/jparten/aws_blue_green_deploy/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new
+
+task :default => :spec
+task :test => :spec

data/aws_blue_green_deploy.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'aws_blue_green_deploy/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "aws_blue_green_deploy"
+  spec.version       = AwsBlueGreenDeploy::VERSION
+  spec.authors       = ["Jon Parten"]
+  spec.email         = ["jon.parten@gmail.com"]
+  spec.summary       = %q{Provide an interface for conducting Blue Green deployments.}
+  spec.description   = %q{Provide an interface for conducting Blue Green deployments in AWS EC2 using ASG's and ELB's.}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.1"
+
+  spec.add_runtime_dependency 'aws-sdk'
+end

data/lib/aws_blue_green_deploy.rb

@@ -0,0 +1,56 @@
+require "aws_blue_green_deploy/version"
+require "aws_blue_green_deploy/deploy_controller"
+require 'json'
+require 'aws-sdk'
+
+module AwsBlueGreenDeploy
+  # Configure through hash
+  @config = {}
+
+  def self.configure(opts = {})
+    opts.each {|k,v| @config[k.to_sym] = v}
+  end
+
+  # Configure through yaml file
+  def self.configure_with(path_to_json_file)
+    begin
+      config = JSON.parse(IO.read(path_to_json_file), {:symbolize_names => true})
+    rescue Errno::ENOENT
+      log(:warning, "JSON configuration file couldn't be found. Using defaults."); return
+    end
+
+    configure(config)
+    "Loaded Config Successfully"
+  end
+
+  def self.config
+    @config
+  end
+
+  def self.enact_deployment
+    auth_options = {:access_key_id => config[:access_key_id], :secret_access_key => config[:secret_access_key], :session_token => config[:session_token], :region => config[:region]}
+    as_controller = AWS::AutoScaling.new(auth_options)
+    lb_controller = AWS::ELB.new(auth_options)
+    dc = DeployController.new(as_controller, lb_controller)
+
+    elb_name = config[:elb_name]
+    asg_size = config[:asg_size].to_i
+    lc_name = config[:lc_name]
+    lc_image = config[:lc_image]
+    lc_instance_type = config[:lc_instance_type]
+    lc_key_pair = config[:lc_key_pair]
+    lc_security_groups = config[:lc_security_groups]
+    lc_user_data = config[:lc_user_data]
+
+    lc = dc.create_new_launch_config(lc_name, lc_image, lc_instance_type, lc_key_pair, lc_security_groups, lc_user_data)
+    puts "Created Launch Config: #{lc.name}"
+    oor_groups = dc.out_rotation_groups(elb_name)
+    puts "Out of rotation ASG: #{oor_groups.each{|group| group.name + " "}}"
+    ir_groups = dc.in_rotation_groups(elb_name)
+    puts "In rotation ASG: #{ir_groups.each{|group| group.name + " "}}"
+    dc.update_groups_lc_and_scale_up(oor_groups, lc, asg_size)
+    puts "Scaled up #{oor_groups.each{|group| group.name + " "}} to #{asg_size} instances with new launch config}"
+    dc.rotate_groups(ir_groups, elb_name)
+    puts "Removed #{ir_groups.each{|group| group.name + " "}}  instances from load balancer."
+  end
+end

data/lib/aws_blue_green_deploy/deploy_controller.rb

@@ -0,0 +1,61 @@
+module AwsBlueGreenDeploy
+  class DeployController
+    def initialize(as_controller, lb_controller)
+      @as_controller = as_controller
+      @lb_controller = lb_controller 
+    end
+
+    def create_new_launch_config(name, image, instance_type, key_pair, security_groups, user_data)
+      options = {:key_pair => key_pair, :security_groups => security_groups, :user_data => user_data}
+      launch_config = @as_controller.launch_configurations.create(name, image, instance_type, options)
+    end
+
+    def out_rotation_groups(elb_name)
+      target_groups = groups_associated_to_elb(elb_name)
+      in_rotation_groups = in_rotation_groups(elb_name)
+      out_rotation_groups = []
+      target_groups.each do |target_group|
+        in_rotation_groups.each do |ir_group|
+          out_rotation_groups.push(target_group) unless target_group.name == ir_group.name
+        end
+      end
+
+      out_rotation_groups.each{|group| puts group.name}
+    end
+
+    def in_rotation_groups(elb_name)
+      target_groups = groups_associated_to_elb(elb_name)
+      in_rotation_groups = []
+      in_rotation_instances = @lb_controller.load_balancers[elb_name].instances.map{|instance| instance.id}
+      target_groups.each do |group| 
+        group_instances = group.ec2_instances.map{|instance| instance.id}
+        if (in_rotation_instances & group_instances).count > 0
+          in_rotation_groups.push(group)
+        end
+      end
+      in_rotation_groups
+    end
+
+    def update_groups_lc_and_scale_up(autoscaling_groups, launch_config, asg_size)
+      autoscaling_groups.each{|group| replace_launch_config(group, launch_config, asg_size)}
+    end
+
+    def rotate_groups(groups, elb_name)
+      instance_ids = []
+      groups.each do |group|
+        group.ec2_instances.each{|instance| instance_ids.push(instance.instance_id)}
+      end
+      instance_ids.each{|instance_id| puts instance_id}
+      instance_ids.each{|instance_id| @lb_controller.load_balancers[elb_name].instances.deregister(instance_id)}
+    end
+
+    private
+    def replace_launch_config(group, launch_config, asg_size)
+        group.update(desired_capacity: asg_size, min_size: asg_size, max_size: asg_size, launch_configuration: launch_config)
+    end
+
+    def groups_associated_to_elb(elb_name)
+      @as_controller.groups.select{|group| group.load_balancer_names.include?(elb_name)}
+    end
+  end
+end

data/lib/aws_blue_green_deploy/version.rb

@@ -0,0 +1,3 @@
+module AwsBlueGreenDeploy
+  VERSION = "0.0.1"
+end

data/spec/lib/aws_blue_green_deploy_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe "DeployController" do
+  before do
+    @as_controller = AWS::AutoScaling.new(:stub_requests => true, :access_key_id => "faux_key", :secret_access_key => "faux_access_key")
+    @lb_controller = AWS::ELB.new(:stub_requests => true, :access_key_id => "faux_key", :secret_access_key => "faux_access_key")
+    @dc = AwsBlueGreenDeploy::DeployController.new(@as_controller, @lb_controller)
+  end
+
+  describe "#create_new_launch_config" do
+    before do
+      @lc_name = "test-launch-config"
+      @lc_image = "ami-000000a0"
+      @lc_instance_type = "m3.medium"
+      @lc_key_pair = "test-key-pair"
+      @lc_security_groups = ["sg-00a00000","sg-00b00000", "sg-00c00000"]
+      @lc_user_data = "test-user-data"
+      @lc = @dc.create_new_launch_config(@lc_name, @lc_image, @lc_instance_type, @lc_key_pair, @lc_security_groups, @lc_user_data)
+    end
+
+    it "return an aws launch config" do
+      expect(@lc).to be_a AWS::AutoScaling::LaunchConfiguration
+    end
+
+    it "should make a launch config in aws with the name specified" do
+      expect(@as_controller.launch_configurations["test-launch-config"].name).to eq(@lc_name)    
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'aws_blue_green_deploy'

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification
+name: aws_blue_green_deploy
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jon Parten
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  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: Provide an interface for conducting Blue Green deployments in AWS EC2
+  using ASG's and ELB's.
+email:
+- jon.parten@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rvmrc"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- aws_blue_green_deploy.gemspec
+- lib/aws_blue_green_deploy.rb
+- lib/aws_blue_green_deploy/deploy_controller.rb
+- lib/aws_blue_green_deploy/version.rb
+- spec/lib/aws_blue_green_deploy_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+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: Provide an interface for conducting Blue Green deployments.
+test_files:
+- spec/lib/aws_blue_green_deploy_spec.rb
+- spec/spec_helper.rb