capistrano-asg 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 65590a9ec7bb5ea9e7989900db32e3186d113dc1
+  data.tar.gz: 1de9dbe90e304d5bf31a46444fbd912d0445bbce
+SHA512:
+  metadata.gz: e7318766a16a55a0a8668e55fe0efaee988ea7e1ba7a6635fdcaf5b6b5158b01458d7617aa0dd13afc8995d891c65cae2011cb62c70177a68a3a67fa2c077f8d
+  data.tar.gz: d656273906059100458d400dd04ec9f539b3f5d62f4dfa2afa9e2c6250bd3482b076b4d94639fad5fbc68fad9ad8a327885ff3ff38c5269633c777cc16002b9d

data/.gitignore

@@ -0,0 +1,22 @@
+bin/
+*.gem
+*.rbc
+/Gemfile.lock
+.bundle
+.config
+.yardoc
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,15 @@
+language: ruby
+cache: bundler
+rvm:
+- 2.3.3
+- 2.4.1
+sudo: false
+env:
+  - AWS_REGION: us-west-2
+deploy:
+  provider: rubygems
+  gem:
+    master: capistrano-asg
+  on:
+    repo: sixfeetover/capistrano-asg
+    branch: master

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Logan Serman
+
+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,80 @@
+# capistrano-asg
+
+This is a fork of [lserman/capistrano-elbas](https://github.com/lserman/capistrano-elbas), updated with new features and Capistrano 3 conventions.
+
+capistrano-asg was written to ease the deployment of Rails applications to AWS AutoScale groups. capistrano-asg will:
+
+- Deploy your code to each running instance connected to a given AutoScale group
+- After deployment, create an AMI from one of the running instances
+- Attach the AMI with the new code to a new AWS Launch Configuration
+- Update your AutoScale group to use the new launch configuration
+- Delete any old AMIs created by capistrano-asg
+- Delete any old launch configurations created by capistrano-asg
+
+This ensures that your current and future servers will be running the newly deployed code.
+
+## Installation
+
+`gem 'capistrano-asg'`
+
+Add this statement to your Capfile:
+
+`require 'capistrano/asg'`
+
+## Configuration
+
+Below are the Capistrano configuration options with their defaults:
+
+```ruby
+set :aws_access_key_id,     ENV['AWS_ACCESS_KEY_ID']
+set :aws_secret_access_key, ENV['AWS_SECRET_ACCESS_KEY']
+set :aws_region,            ENV['AWS_REGION']
+
+set :aws_no_reboot_on_create_ami, true
+set :aws_autoscale_instance_size, 'm1.small'
+
+set :aws_launch_configuration_detailed_instance_monitoring, true
+set :aws_launch_configuration_associate_public_ip, true
+```
+
+## Usage
+
+Instead of using Capistrano's `server` method, use `autoscale` instead in `deploy/production.rb` (or
+whichever environment you're deploying to). Provide the name of your AutoScale group instead of a
+hostname:
+
+```ruby
+autoscale 'production', user: 'apps', roles: [:app, :web, :db]
+```
+
+If you have multiple autoscaling groups to deploy to, specify each of them:
+
+```ruby
+autoscale 'asg-app', user: 'apps', roles: [:app, :web]
+autoscale 'asg-db', user: 'apps', roles: [:db]
+```
+
+Similarly, if you are deploying to multiple regions:
+
+```ruby
+regions = %w(us-east-1 eu-west-1)
+
+regions.each do |region|
+  set :aws_region, region
+  autoscale 'production', user: 'apps', roles: [:app, :web, :db]
+end
+```
+
+That's it! Run `cap production deploy`. The following log statements are printed
+during deployment:
+
+```
+Autoscaling: Adding server: ec2-XX-XX-XX-XXX.compute-1.amazonaws.com
+Autoscaling: Creating EC2 AMI from i-123abcd
+Autoscaling: Created AMI: ami-123456
+Autoscaling: Creating an EC2 Launch Configuration for AMI: ami-123456
+Autoscaling: Created Launch Configuration: cap-asg-lc-ENVIRONMENT-UNIX_TIMESTAMP
+Autoscaling: Attaching Launch Configuration to AutoScale Group
+Autoscaling: Deleting old launch configuration: cap-asg-lc-production-123456
+Autoscaling: Deleting old image: ami-999999
+```

data/Rakefile

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

data/capistrano-asg.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'capistrano/asg/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'capistrano-asg'
+  spec.version       = Capistrano::Asg::VERSION
+  spec.authors       = ['Logan Serman', 'Jeff Fraser', 'Michael Martell']
+  spec.email         = ['logan.serman@metova.com', 'jeff.fraser@veracross.com', 'michael.martell@veracross.com']
+  spec.summary       = 'Capistrano plugin for deploying to AWS AutoScale Groups.'
+  spec.description   = "#{spec.summary} Deploys to all instances in a group, creates a fresh AMI post-deploy, and attaches the AMI to your AutoScale Group."
+  spec.homepage      = 'http://github.com/sixfeetover/capistrano-asg'
+  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.6'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'webmock'
+
+  spec.add_dependency 'aws-sdk', '~> 2'
+  spec.add_dependency 'capistrano', '> 3.0.0'
+  spec.add_dependency 'activesupport', '>= 4.0.0'
+end

data/lib/capistrano/asg/ami.rb

@@ -0,0 +1,60 @@
+module Capistrano
+  module Asg
+    # Extend AWS Resource class to include AMI methods
+    class AMI < AWSResource
+      include Taggable
+
+      def self.create(&_block)
+        ami = new
+        ami.cleanup do
+          ami.save
+          ami.tag 'deployed-with' => 'cap-asg'
+          ami.tag 'cap-asg-deploy-group' => ami.autoscaling_group_name
+          yield ami
+        end
+      end
+
+      def save
+        info "Creating EC2 AMI from EC2 Instance: #{base_ec2_instance.id}"
+        ec2_instance = ec2_resource.instance(base_ec2_instance.id)
+        @aws_counterpart = ec2_instance.create_image(
+          name: name,
+          no_reboot: fetch(:aws_no_reboot_on_create_ami, true)
+        )
+      end
+
+      def destroy(images = [])
+        images.each do |i|
+          info "Deleting old AMI: #{i.id}"
+          snapshots = snapshots_attached_to i
+          i.deregister
+          delete_snapshots snapshots
+        end
+      end
+
+      private
+
+      def name
+        timestamp "latest-#{environment}-AMI"
+      end
+
+      def trash
+        ec2_resource.images(owners: ['self']).to_a.select do |ami|
+          deployed_with_asg? ami
+        end
+      end
+
+      def snapshots_attached_to(image)
+        ids = image.block_device_mappings.map(&:ebs).compact.map(&:snapshot_id)
+        ec2_resource.snapshots(snapshot_ids: ids)
+      end
+
+      def delete_snapshots(snapshots)
+        snapshots.each do |snapshot|
+          info "Deleting snapshot: #{snapshot.id}"
+          snapshot.delete unless snapshot.nil?
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/asg/aws/autoscaling.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Capistrano
+  module Asg
+    module Aws
+      # Provide AutoScaling client, resource, and group information
+      module AutoScaling
+        extend ActiveSupport::Concern
+        include Credentials
+        include Capistrano::DSL
+
+        def autoscaling_client
+          @_autoscaling_client ||= ::Aws::AutoScaling::Client.new(credentials)
+        end
+
+        def autoscaling_resource
+          @_autoscaling_resource ||= ::Aws::AutoScaling::Resource.new(client: autoscaling_client)
+        end
+
+        def autoscaling_group
+          @_autoscaling_group ||= autoscaling_resource.group(autoscaling_group_name)
+        end
+
+        def autoscaling_group_name
+          fetch(:aws_autoscale_group)
+        end
+
+        def reset_autoscaling_objects
+          @_autoscaling_client = nil
+          @_autoscaling_resource = nil
+          @_autoscaling_group = nil
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/asg/aws/credentials.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Capistrano
+  module Asg
+    module Aws
+      module Credentials
+        extend ActiveSupport::Concern
+        include Capistrano::DSL
+
+        def credentials
+          {
+            access_key_id:     fetch(:aws_access_key_id,     ENV['AWS_ACCESS_KEY_ID']),
+            secret_access_key: fetch(:aws_secret_access_key, ENV['AWS_SECRET_ACCESS_KEY']),
+            region:            fetch(:aws_region,            ENV['AWS_REGION'])
+          }
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/asg/aws/ec2.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Capistrano
+  module Asg
+    module Aws
+      # Provide EC2 client and resource information
+      module EC2
+        extend ActiveSupport::Concern
+        include Credentials
+        include Capistrano::DSL
+
+        def ec2_resource
+          @_ec2_resource ||= ::Aws::EC2::Resource.new(client: ec2_client)
+        end
+
+        def reset_ec2_objects
+          @_ec2_resource = nil
+        end
+
+        private
+
+        def ec2_client
+          ::Aws::EC2::Client.new(credentials)
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/asg/aws_resource.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Capistrano
+  module Asg
+    # Provides basic AWS resource methods
+    class AWSResource
+      include Capistrano::DSL
+      include Capistrano::Asg::Aws::AutoScaling
+      include Capistrano::Asg::Aws::EC2
+      include Capistrano::Asg::Retryable
+      include Logger
+
+      attr_reader :aws_counterpart
+
+      def cleanup(&_block)
+        items = trash || []
+        yield
+        destroy items
+        self
+      end
+
+      private
+
+      def base_ec2_instance
+        autoscaling_group.instances[0]
+      end
+
+      def environment
+        fetch(:rails_env, 'production')
+      end
+
+      def timestamp(str)
+        "#{str}-#{Time.now.to_i}"
+      end
+
+      def deployed_with_asg?(resource)
+        return false if resource.tags.empty?
+        resource.tags.any? { |k| k.key == 'deployed-with' && k.value == 'cap-asg' } &&
+          resource.tags.any? { |k| k.key == 'cap-asg-deploy-group' && k.value == autoscaling_group_name }
+      end
+    end
+  end
+end

data/lib/capistrano/asg/launch_configuration.rb

@@ -0,0 +1,69 @@
+module Capistrano
+  module Asg
+    # Create launch configuration
+    class LaunchConfiguration < AWSResource
+      def self.create(ami, &_block)
+        lc = new
+        lc.cleanup do
+          lc.save(ami)
+          yield lc
+        end
+      end
+
+      def save(ami)
+        info "Creating an EC2 Launch Configuration for AMI: \
+             #{ami.aws_counterpart.id}"
+        ec2_instance = ec2_resource.instance(base_ec2_instance.id)
+        with_retry do
+          @aws_counterpart = autoscaling_resource.create_launch_configuration(
+            launch_configuration_name: name,
+            image_id: ami.aws_counterpart.id,
+            instance_type: instance_size,
+            security_groups: ec2_instance.security_groups.map(&:group_id),
+            associate_public_ip_address:
+              fetch(:aws_launch_configuration_associate_public_ip, true),
+            instance_monitoring: {
+              enabled: fetch(:aws_launch_configuration_detailed_instance_monitoring, true)
+            },
+            user_data: fetch(:aws_launch_configuration_user_data, nil)
+          )
+        end
+      end
+
+      def attach_to_autoscale_group!
+        info "Attaching Launch Configuration #{aws_counterpart.name} \
+          to AutoScaling Group #{autoscaling_group.name}"
+        autoscaling_group.update(
+          launch_configuration_name: aws_counterpart.name
+        )
+      end
+
+      def destroy(launch_configurations = [])
+        launch_configurations.each do |lc|
+          info "Deleting old Launch Configuration: #{lc.name}"
+          lc.delete
+        end
+      end
+
+      private
+
+      def name
+        timestamp "cap-asg-#{environment}-#{autoscaling_group_name}-lc"
+      end
+
+      def instance_size
+        fetch(:aws_autoscale_instance_size, 'm1.small')
+      end
+
+      def deployed_with_asg?(lc)
+        lc.name.include? "cap-asg-#{environment}-#{autoscaling_group_name}-lc"
+      end
+
+      def trash
+        autoscaling_resource.launch_configurations.to_a.select do |lc|
+          deployed_with_asg? lc
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/asg/logger.rb

@@ -0,0 +1,9 @@
+module Capistrano
+  module Asg
+    module Logger
+      def info(message)
+        puts "Autoscaling: #{message}"
+      end
+    end
+  end
+end

data/lib/capistrano/asg/retryable.rb

@@ -0,0 +1,18 @@
+module Capistrano
+  module Asg
+    module Retryable
+      def with_retry(max: fetch(:asg_retry_max, 3), delay: fetch(:asg_retry_delay, 5))
+        tries ||= 0
+        tries += 1
+        yield
+      rescue => e
+        puts "Rescued #{e.message}"
+        if tries < max
+          puts "Retrying in #{delay} seconds..."
+          sleep delay
+          retry
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/asg/taggable.rb

@@ -0,0 +1,12 @@
+module Capistrano
+  module Asg
+    # Adds tags to AWS resources
+    module Taggable
+      def tag(tags = {})
+        with_retry do
+          tags.each { |k, v| aws_counterpart.create_tags(tags: [{key: k, value: v}]) }
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/asg/tasks/asg.rake

@@ -0,0 +1,17 @@
+require 'capistrano/asg'
+
+namespace :asg do
+  task :scale do
+    set :aws_access_key_id,     fetch(:aws_access_key_id,     ENV['AWS_ACCESS_KEY_ID'])
+    set :aws_secret_access_key, fetch(:aws_secret_access_key, ENV['AWS_SECRET_ACCESS_KEY'])
+    set :aws_region,            fetch(:aws_region,            ENV['AWS_REGION'])
+
+    Capistrano::Asg::AMI.create do |ami|
+      puts "Autoscaling: Created AMI: #{ami.aws_counterpart.id}"
+      Capistrano::Asg::LaunchConfiguration.create(ami) do |lc|
+        puts "Autoscaling: Created Launch Configuration: #{lc.aws_counterpart.name}"
+        lc.attach_to_autoscale_group!
+      end
+    end
+  end
+end

data/lib/capistrano/asg/version.rb

@@ -0,0 +1,5 @@
+module Capistrano
+  module Asg
+    VERSION = '0.5.0'.freeze
+  end
+end

data/lib/capistrano/asg.rb

@@ -0,0 +1,56 @@
+require 'aws-sdk'
+require 'capistrano/all'
+require 'active_support/concern'
+
+require 'capistrano/asg/version'
+require 'capistrano/asg/retryable'
+require 'capistrano/asg/taggable'
+require 'capistrano/asg/logger'
+require 'capistrano/asg/aws/credentials'
+require 'capistrano/asg/aws/autoscaling'
+require 'capistrano/asg/aws/ec2'
+require 'capistrano/asg/aws_resource'
+require 'capistrano/asg/ami'
+require 'capistrano/asg/launch_configuration'
+
+module Capistrano
+  module Asg
+  end
+end
+
+require 'aws-sdk'
+require 'capistrano/dsl'
+
+load File.expand_path('../asg/tasks/asg.rake', __FILE__)
+
+def autoscale(groupname, *args)
+  include Capistrano::DSL
+  include Capistrano::Asg::Aws::AutoScaling
+  include Capistrano::Asg::Aws::EC2
+
+  autoscaling_group = autoscaling_resource.group(groupname)
+  asg_instances = autoscaling_group.instances
+
+  set :aws_autoscale_group, groupname
+
+  asg_instances.each do |asg_instance|
+    if asg_instance.health_status != 'Healthy'
+      puts "Autoscaling: Skipping unhealthy instance #{instance.id}"
+    else
+      ec2_instance = ec2_resource.instance(asg_instance.id)
+      hostname = ec2_instance.private_ip_address
+      puts "Autoscaling: Adding server #{hostname}"
+      server(hostname, *args)
+    end
+  end
+
+  if asg_instances.count > 0
+    after('deploy', 'asg:scale')
+  else
+    puts 'Autoscaling: AMI could not be created because no running instances were found.\
+      Is your autoscale group name correct?'
+  end
+
+  reset_autoscaling_objects
+  reset_ec2_objects
+end

data/spec/ami_spec.rb

@@ -0,0 +1,11 @@
+describe Capistrano::Asg::AMI do
+  describe '#tag' do
+    subject { Capistrano::Asg::AMI.new }
+
+    it 'retries the tag 3 times' do
+      skip
+      expect(subject).to receive(:aws_counterpart).exactly(3).times { raise RuntimeError }
+      subject.tag 'Test' => true
+    end
+  end
+end

data/spec/asg_spec.rb

@@ -0,0 +1,69 @@
+describe 'Capistrano::Asg' do
+  before do
+    allow_any_instance_of(Capistrano::Asg::AWSResource).to receive(:autoscaling_group_name) { 'production' }
+    webmock :get, /security-credentials/ => 'security-credentials.200.json'
+    webmock(:post, %r{autoscaling.(.*).amazonaws.com\/\z} => 'DescribeAutoScalingGroups.200.xml') { Hash[body: /Action=DescribeAutoScalingGroups/] }
+    webmock(:post, %r{ec2.(.*).amazonaws.com\/\z} => 'DescribeImages.200.xml') { Hash[body: /Action=DescribeImages/] }
+    webmock(:post, %r{ec2.(.*).amazonaws.com\/\z} => 'DescribeTags.200.xml') { Hash[body: /Action=DescribeTags/] }
+    webmock(:post, %r{ec2.(.*).amazonaws.com\/\z} => 'DescribeInstances.200.xml') { Hash[body: /Action=DescribeInstances/] }
+    webmock(:post, %r{ec2.(.*).amazonaws.com\/\z} => 'CreateImage.200.xml') { Hash[body: /Action=CreateImage/] }
+    webmock(:post, %r{ec2.(.*).amazonaws.com\/\z} => 'DeregisterImage.200.xml') { Hash[body: /Action=DeregisterImage/] }
+    webmock(:post, %r{ec2.(.*).amazonaws.com\/\z} => 'CreateTags.200.xml') { Hash[body: /Action=CreateTags/] }
+    webmock(:post, %r{ec2.(.*).amazonaws.com\/\z} => 'DescribeSnapshots.200.xml') { Hash[body: /Action=DescribeSnapshots/] }
+    webmock(:post, %r{ec2.(.*).amazonaws.com\/\z} => 'DeleteSnapshot.200.xml') { Hash[body: /Action=DeleteSnapshot/] }
+    webmock(:post, %r{autoscaling.(.*).amazonaws.com\/\z} => 'DescribeLaunchConfigurations.200.xml') { Hash[body: /Action=DescribeLaunchConfigurations/] }
+    webmock(:post, %r{autoscaling.(.*).amazonaws.com\/\z} => 'CreateLaunchConfiguration.200.xml') { Hash[body: /Action=CreateLaunchConfiguration/] }
+    webmock(:post, %r{autoscaling.(.*).amazonaws.com\/\z} => 'DeleteLaunchConfiguration.200.xml') { Hash[body: /Action=DeleteLaunchConfiguration/] }
+    webmock(:post, %r{autoscaling.(.*).amazonaws.com\/\z} => 'UpdateAutoScalingGroup.200.xml') { Hash[body: /Action=UpdateAutoScalingGroup/] }
+  end
+
+  let!(:ami) do
+    _ami = nil
+    Capistrano::Asg::AMI.create { |ami| _ami = ami }
+    _ami
+  end
+
+  describe 'AMI creation & cleanup' do
+    it 'creates a new AMI on Amazon' do
+      expect(ami.aws_counterpart.id).to eq 'ami-4fa54026'
+    end
+
+    it 'deletes any AMIs tagged with deployed-with=cap-asg' do
+      expect(WebMock).to have_requested(:post, /ec2.(.*).amazonaws.com\/\z/).with(body: /Action=DeregisterImage&ImageId=ami-1a2b3c4d/)
+    end
+
+    it 'deletes snapshots that are associated with the AMI' do
+      expect(WebMock).to have_requested(:post, /ec2.(.*).amazonaws.com\/\z/).with(body: /Action=DeleteSnapshot&SnapshotId=snap-1a2b3c4d/)
+    end
+
+    it 'tags the new AMI with deployed-with=cap-asg' do
+      expect(WebMock).to have_requested(:post, /ec2.(.*).amazonaws.com\/\z/).with(body: /Action=CreateTags&ResourceId.1=ami-4fa54026&Tag.1.Key=deployed-with&Tag.1.Value=cap-asg/)
+    end
+
+    it 'tags the new AMI with cap-asg-Deploy-group=<autoscale group name>' do
+      expect(WebMock).to have_requested(:post, /ec2.(.*).amazonaws.com\/\z/).with(body: /Action=CreateTags&ResourceId.1=ami-4fa54026&Tag.1.Key=cap-asg-deploy-group&Tag.1.Value=production/)
+    end
+  end
+
+  describe 'Launch configuration creation & cleanup' do
+    let!(:launch_configuration) do
+      _lc = nil
+      Capistrano::Asg::LaunchConfiguration.create(ami) { |lc| _lc = lc }
+      _lc
+    end
+
+    it 'creates a new Launch Configuration on AWS' do
+      expect(WebMock).to have_requested(:post, /autoscaling.(.*).amazonaws.com\/\z/).
+        with(body: /Action=CreateLaunchConfiguration&AssociatePublicIpAddress=true&ImageId=ami-4fa54026&InstanceMonitoring.Enabled=true&InstanceType=m1.small&LaunchConfigurationName=cap-asg-production/)
+    end
+
+    it 'deletes any LCs with name =~ cap-asg-production' do
+      expect(WebMock).to have_requested(:post, /autoscaling.(.*).amazonaws.com\/\z/).with(body: /Action=DeleteLaunchConfiguration&LaunchConfigurationName=cap-asg-production-production-lc-1234567890/)
+    end
+
+    it 'attaches the LC to the autoscale group' do
+      launch_configuration.attach_to_autoscale_group!
+      expect(WebMock).to have_requested(:post, /autoscaling.(.*).amazonaws.com\/\z/).with(body: /Action=UpdateAutoScalingGroup&AutoScalingGroupName=production&LaunchConfigurationName=cap-asg-production-production-lc-\d{10,}/)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,32 @@
+require 'webmock'
+require 'capistrano/all'
+require 'capistrano/asg'
+require 'webmock/rspec'
+
+WebMock.disable_net_connect!
+
+Dir[File.join(File.expand_path('../..', __FILE__), 'spec', 'support', '**', '*.rb')].each { |f| require f }
+
+module WebMock
+  module RSpec
+    module Helper
+
+      def webmock(method, mocks = {})
+        mocks.each do |regex, filename|
+          status = filename[/\.(\d+)\./, 1] || 200
+          body = File.read File.join(File.expand_path('../..', __FILE__), 'spec', 'support', 'stubs', filename)
+          if block_given? && with_options = yield
+            WebMock.stub_request(method, regex).with(with_options).to_return status: status.to_i, body: body
+          else
+            WebMock.stub_request(method, regex).to_return status: status.to_i, body: body
+          end
+        end
+      end
+
+    end
+  end
+end
+
+RSpec.configure do |config|
+  config.include WebMock::RSpec::Helper
+end

data/spec/support/stubs/CreateImage.200.xml

@@ -0,0 +1,4 @@
+<CreateImageResponse xmlns="http://ec2.amazonaws.com/doc/2014-10-01/">
+   <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
+   <imageId>ami-4fa54026</imageId>
+</CreateImageResponse>

data/spec/support/stubs/CreateLaunchConfiguration.200.xml

@@ -0,0 +1,5 @@
+<CreateLaunchConfigurationResponse xmlns="http://autoscaling.amazonaws.com/doc/2011-01-01/">
+<ResponseMetadata>
+   <RequestId>7c6e177f-f082-11e1-ac58-3714bEXAMPLE</RequestId>
+</ResponseMetadata>
+</CreateLaunchConfigurationResponse>

data/spec/support/stubs/CreateTags.200.xml

@@ -0,0 +1,4 @@
+<CreateTagsResponse xmlns="http://ec2.amazonaws.com/doc/2014-10-01/">
+  <requestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</requestId>
+  <return>true</return>
+</CreateTagsResponse>

data/spec/support/stubs/DeleteLaunchConfiguration.200.xml

@@ -0,0 +1,5 @@
+<DeleteLaunchConfigurationResponse xmlns="http://autoscaling.amazonaws.com/doc/2011-01-01/">
+  <ResponseMetadata>
+    <RequestId>7347261f-97df-11e2-8756-35eEXAMPLE</RequestId>
+  </ResponseMetadata>
+</DeleteLaunchConfigurationResponse>

data/spec/support/stubs/DeleteSnapshot.200.xml

@@ -0,0 +1,4 @@
+<DeleteSnapshotResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
+  <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
+  <return>true</return>
+</DeleteSnapshotResponse>

data/spec/support/stubs/DeregisterImage.200.xml

@@ -0,0 +1,4 @@
+<DeregisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2014-10-01/">
+  <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
+  <return>true</return>
+</DeregisterImageResponse>

data/spec/support/stubs/DescribeAutoScalingGroups.200.xml

@@ -0,0 +1,21 @@
+<DescribeAutoScalingGroupsResponse xmlns="http://autoscaling.amazonaws.com/doc/2011-01-01/">
+  <ResponseMetadata>
+    <RequestId>7c6e177f-f082-11e1-ac58-3714bEXAMPLE</RequestId>
+  </ResponseMetadata>
+  <DescribeAutoScalingGroupsResult>
+    <AutoScalingGroups>
+      <member>
+        <AutoScalingGroupName>production</AutoScalingGroupName>
+        <Instances>
+          <member>
+            <LaunchConfigurationName>cap-asg-production-production-lc-1234567890</LaunchConfigurationName>
+            <LifecycleState>InService</LifecycleState>
+            <InstanceId>i-1a2b3c4d</InstanceId>
+            <ProtectedFromScaleIn>false</ProtectedFromScaleIn>
+            <AvailabilityZone>us-west-2a</AvailabilityZone>
+          </member>
+        </Instances>
+      </member>
+    </AutoScalingGroups>
+  </DescribeAutoScalingGroupsResult>
+</DescribeAutoScalingGroupsResponse>

data/spec/support/stubs/DescribeImages.200.xml

@@ -0,0 +1,44 @@
+<DescribeImagesResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
+  <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
+  <imagesSet>
+    <item>
+      <imageId>ami-1a2b3c4d</imageId>
+      <imageLocation>amazon/getting-started</imageLocation>
+      <imageState>available</imageState>
+      <imageOwnerId>123456789012</imageOwnerId>
+      <isPublic>true</isPublic>
+      <architecture>i386</architecture>
+      <imageType>machine</imageType>
+      <kernelId>aki-1a2b3c4d</kernelId>
+      <ramdiskId>ari-1a2b3c4d</ramdiskId>
+      <imageOwnerAlias>self</imageOwnerAlias>
+      <name>getting-started</name>
+      <description>Image Description</description>
+      <rootDeviceType>ebs</rootDeviceType>
+      <rootDeviceName>/dev/sda</rootDeviceName>
+      <blockDeviceMapping>
+        <item>
+          <deviceName>/dev/sda1</deviceName>
+          <ebs>
+            <snapshotId>snap-1a2b3c4d</snapshotId>
+            <volumeSize>15</volumeSize>
+            <deleteOnTermination>false</deleteOnTermination>
+            <volumeType>standard</volumeType>
+          </ebs>
+        </item>
+      </blockDeviceMapping>
+      <virtualizationType>paravirtual</virtualizationType>
+      <tagSet>
+         <item>
+            <key>deployed-with</key>
+            <value>cap-asg</value>
+         </item>
+         <item>
+            <key>cap-asg-deploy-group</key>
+            <value>production</value>
+         </item>
+       </tagSet>
+      <hypervisor>xen</hypervisor>
+    </item>
+  </imagesSet>
+</DescribeImagesResponse>

data/spec/support/stubs/DescribeInstances.200.xml

@@ -0,0 +1,124 @@
+<DescribeInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2014-10-01/">
+  <requestId>fdcdcab1-ae5c-489e-9c33-4637c5dda355</requestId>
+    <reservationSet>
+      <item>
+        <reservationId>r-1a2b3c4d</reservationId>
+        <ownerId>123456789012</ownerId>
+        <groupSet>
+          <item>
+            <groupId>sg-1a2b3c4d</groupId>
+            <groupName>my-security-group</groupName>
+          </item>
+        </groupSet>
+        <instancesSet>
+          <item>
+            <instanceId>i-1a2b3c4d</instanceId>
+            <imageId>ami-1a2b3c4d</imageId>
+            <instanceState>
+              <code>16</code>
+              <name>running</name>
+            </instanceState>
+            <privateDnsName/>
+            <dnsName/>
+            <reason/>
+            <keyName>my-key-pair</keyName>
+            <amiLaunchIndex>0</amiLaunchIndex>
+            <productCodes/>
+            <instanceType>c1.medium</instanceType>
+            <launchTime>Y2035-02-09T23:17:13Z+0000</launchTime>
+            <placement>
+              <availabilityZone>us-west-2a</availabilityZone>
+              <groupName/>
+              <tenancy>default</tenancy>
+            </placement>
+            <platform>windows</platform>
+            <monitoring>
+              <state>disabled</state>
+            </monitoring>
+            <subnetId>subnet-1a2b3c4d</subnetId>
+            <vpcId>vpc-1a2b3c4d</vpcId>
+            <privateIpAddress>10.0.0.12</privateIpAddress>
+            <ipAddress>46.51.219.63</ipAddress>
+            <sourceDestCheck>true</sourceDestCheck>
+            <groupSet>
+              <item>
+                <groupId>sg-1a2b3c4d</groupId>
+                <groupName>my-security-group</groupName>
+              </item>
+            </groupSet>
+            <architecture>x86_64</architecture>
+            <rootDeviceType>ebs</rootDeviceType>
+            <rootDeviceName>/dev/sda1</rootDeviceName>
+            <blockDeviceMapping>
+              <item>
+                <deviceName>/dev/sda1</deviceName>
+                <ebs>
+                  <volumeId>vol-1a2b3c4d</volumeId>
+                  <status>attached</status>
+                  <attachTime>2035-02-09T23:17:13Z</attachTime>
+                  <deleteOnTermination>true</deleteOnTermination>
+                </ebs>
+              </item>
+            </blockDeviceMapping>
+            <virtualizationType>hvm</virtualizationType>
+            <clientToken>ABCDE1234567890123</clientToken>
+            <tagSet>
+              <item>
+                <key>Name</key>
+                <value>Windows Instance</value>
+              </item>
+            </tagSet>
+            <hypervisor>xen</hypervisor>
+            <networkInterfaceSet>
+              <item>
+                <networkInterfaceId>eni-1a2b3c4d</networkInterfaceId>
+                <subnetId>subnet-1a2b3c4d</subnetId>
+                <vpcId>vpc-1a2b3c4d</vpcId>
+                <description>Primary network interface</description>
+                <ownerId>123456789012</ownerId>
+                <status>in-use</status>
+                <macAddress>1b:2b:3c:4d:5e:6f</macAddress>
+                <privateIpAddress>10.0.0.12</privateIpAddress>
+                <sourceDestCheck>true</sourceDestCheck>
+                <groupSet>
+                  <item>
+                    <groupId>sg-1a2b3c4d</groupId>
+                    <groupName>my-security-group</groupName>
+                  </item>
+                </groupSet>
+                <attachment>
+                  <attachmentId>eni-attach-1a2b3c4d</attachmentId>
+                  <deviceIndex>0</deviceIndex>
+                  <status>attached</status>
+                  <attachTime>2035-02-09T23:17:13Z</attachTime>
+                  <deleteOnTermination>true</deleteOnTermination>
+                </attachment>
+                <association>
+                  <publicIp>198.51.100.63</publicIp>
+                  <ipOwnerId>123456789012</ipOwnerId>
+                </association>
+                <privateIpAddressesSet>
+                  <item>
+                    <privateIpAddress>10.0.0.12</privateIpAddress>
+                    <primary>true</primary>
+                    <association>
+                      <publicIp>198.51.100.63</publicIp>
+                      <ipOwnerId>123456789012</ipOwnerId>
+                    </association>
+                  </item>
+                  <item>
+                    <privateIpAddress>10.0.0.14</privateIpAddress>
+                    <primary>false</primary>
+                    <association>
+                      <publicIp>198.51.100.177</publicIp>
+                      <ipOwnerId>123456789012</ipOwnerId>
+                    </association>
+                  </item>
+                </privateIpAddressesSet>
+              </item>
+            </networkInterfaceSet>
+          </item>
+        </instancesSet>
+      </item>
+    </reservationSet>
+    </DescribeInstancesResponse>

data/spec/support/stubs/DescribeLaunchConfigurations.200.xml

@@ -0,0 +1,29 @@
+<DescribeLaunchConfigurationsResponse xmlns="http://autoscaling.amazonaws.com/doc/2011-01-01/">
+  <DescribeLaunchConfigurationsResult>
+    <LaunchConfigurations>
+      <member>
+        <AssociatePublicIpAddress>true</AssociatePublicIpAddress>
+        <SecurityGroups/>
+        <PlacementTenancy>dedicated</PlacementTenancy>
+        <CreatedTime>2013-01-21T23:04:42.200Z</CreatedTime>
+        <KernelId/>
+        <LaunchConfigurationName>cap-asg-production-production-lc-1234567890</LaunchConfigurationName>
+        <UserData/>
+        <InstanceType>m1.small</InstanceType>
+        <LaunchConfigurationARN>arn:aws:autoscaling:us-east-1:803981987763:launchConfiguration:
+        9dbbbf87-6141-428a-a409-0752edbe6cad:launchConfigurationName/my-test-lc</LaunchConfigurationARN>
+        <BlockDeviceMappings/>
+        <ImageId>ami-514ac838</ImageId>
+        <KeyName/>
+        <RamdiskId/>
+        <InstanceMonitoring>
+          <Enabled>true</Enabled>
+        </InstanceMonitoring>
+        <EbsOptimized>false</EbsOptimized>
+      </member>
+    </LaunchConfigurations>
+  </DescribeLaunchConfigurationsResult>
+  <ResponseMetadata>
+    <RequestId>d05a22f8-b690-11e2-bf8e-2113fEXAMPLE</RequestId>
+  </ResponseMetadata>
+</DescribeLaunchConfigurationsResponse>

data/spec/support/stubs/DescribeSnapshots.200.xml

@@ -0,0 +1,27 @@
+<DescribeSnapshotsResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
+   <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
+   <snapshotSet>
+      <item>
+         <snapshotId>snap-1a2b3c4d</snapshotId>
+         <volumeId>vol-1234567890abcdef0</volumeId>
+         <status>pending</status>
+         <startTime>2013-01-21T23:04:42.200Z</startTime>
+         <progress>80%</progress>
+         <ownerId>111122223333</ownerId>
+         <volumeSize>15</volumeSize>
+         <description>Daily Backup</description>
+         <encrypted>true</encrypted>
+         <kmsKeyId>arn:aws:kms:us-east-1:123456789012:key/6876fb1b-example</kmsKeyId>
+         <tagSet>
+            <item>
+               <key>deployed-with</key>
+               <value>cap-asg</value>
+            </item>
+            <item>
+               <key>cap-asg-deploy-group</key>
+               <value>production</value>
+            </item>
+          </tagSet>
+      </item>
+   </snapshotSet>
+</DescribeSnapshotsResponse>

data/spec/support/stubs/DescribeTags.200.xml

@@ -0,0 +1,17 @@
+<DescribeTagsResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
+   <requestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</requestId>
+   <tagSet>
+      <item>
+         <resourceId>ami-1a2b3c4d</resourceId>
+         <resourceType>image</resourceType>
+         <key>deployed-with</key>
+         <value>cap-asg</value>
+      </item>
+      <item>
+         <resourceId>ami-1a2b3c4d</resourceId>
+         <resourceType>image</resourceType>
+         <key>cap-asg-deploy-group</key>
+         <value>production</value>
+      </item>
+    </tagSet>
+</DescribeTagsResponse>

data/spec/support/stubs/UpdateAutoScalingGroup.200.xml

@@ -0,0 +1,5 @@
+<UpdateAutoScalingGroupResponse xmlns="http://autoscaling.amazonaws.com/doc/2011-01-01/">
+  <ResponseMetadata>
+    <RequestId>adafead0-ab8a-11e2-ba13-ab0ccEXAMPLE</RequestId>
+  </ResponseMetadata>
+</UpdateAutoScalingGroupResponse>

data/spec/support/stubs/security-credentials.200.json

@@ -0,0 +1,9 @@
+{
+  "Code" : "Success",
+  "LastUpdated" : "2013-11-22T20:03:48Z",
+  "Type" : "AWS-HMAC",
+  "AccessKeyId" : "akid",
+  "SecretAccessKey" : "secret",
+  "Token" : "token",
+  "Expiration" : "2035-02-09T21:53:57Z"
+}

metadata

@@ -0,0 +1,203 @@
+--- !ruby/object:Gem::Specification
+name: capistrano-asg
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Logan Serman
+- Jeff Fraser
+- Michael Martell
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-08-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+description: Capistrano plugin for deploying to AWS AutoScale Groups. Deploys to all
+  instances in a group, creates a fresh AMI post-deploy, and attaches the AMI to your
+  AutoScale Group.
+email:
+- logan.serman@metova.com
+- jeff.fraser@veracross.com
+- michael.martell@veracross.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- capistrano-asg.gemspec
+- lib/capistrano-asg.rb
+- lib/capistrano/asg.rb
+- lib/capistrano/asg/ami.rb
+- lib/capistrano/asg/aws/autoscaling.rb
+- lib/capistrano/asg/aws/credentials.rb
+- lib/capistrano/asg/aws/ec2.rb
+- lib/capistrano/asg/aws_resource.rb
+- lib/capistrano/asg/launch_configuration.rb
+- lib/capistrano/asg/logger.rb
+- lib/capistrano/asg/retryable.rb
+- lib/capistrano/asg/taggable.rb
+- lib/capistrano/asg/tasks/asg.rake
+- lib/capistrano/asg/version.rb
+- spec/ami_spec.rb
+- spec/asg_spec.rb
+- spec/spec_helper.rb
+- spec/support/stubs/CreateImage.200.xml
+- spec/support/stubs/CreateLaunchConfiguration.200.xml
+- spec/support/stubs/CreateTags.200.xml
+- spec/support/stubs/DeleteLaunchConfiguration.200.xml
+- spec/support/stubs/DeleteSnapshot.200.xml
+- spec/support/stubs/DeregisterImage.200.xml
+- spec/support/stubs/DescribeAutoScalingGroups.200.xml
+- spec/support/stubs/DescribeImages.200.xml
+- spec/support/stubs/DescribeInstances.200.xml
+- spec/support/stubs/DescribeLaunchConfigurations.200.xml
+- spec/support/stubs/DescribeSnapshots.200.xml
+- spec/support/stubs/DescribeTags.200.xml
+- spec/support/stubs/UpdateAutoScalingGroup.200.xml
+- spec/support/stubs/security-credentials.200.json
+homepage: http://github.com/sixfeetover/capistrano-asg
+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.6.11
+signing_key: 
+specification_version: 4
+summary: Capistrano plugin for deploying to AWS AutoScale Groups.
+test_files:
+- spec/ami_spec.rb
+- spec/asg_spec.rb
+- spec/spec_helper.rb
+- spec/support/stubs/CreateImage.200.xml
+- spec/support/stubs/CreateLaunchConfiguration.200.xml
+- spec/support/stubs/CreateTags.200.xml
+- spec/support/stubs/DeleteLaunchConfiguration.200.xml
+- spec/support/stubs/DeleteSnapshot.200.xml
+- spec/support/stubs/DeregisterImage.200.xml
+- spec/support/stubs/DescribeAutoScalingGroups.200.xml
+- spec/support/stubs/DescribeImages.200.xml
+- spec/support/stubs/DescribeInstances.200.xml
+- spec/support/stubs/DescribeLaunchConfigurations.200.xml
+- spec/support/stubs/DescribeSnapshots.200.xml
+- spec/support/stubs/DescribeTags.200.xml
+- spec/support/stubs/UpdateAutoScalingGroup.200.xml
+- spec/support/stubs/security-credentials.200.json