formatron 0.1.11 → 0.1.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e2901f1a146d9b969d04f487d57f0ff26a85db1b
-  data.tar.gz: 154a154b9e9f920fcccb41add3563dddbb6f4b18
+  metadata.gz: 2c47341bd39e30cd27955cba1ae8bab5a79135e6
+  data.tar.gz: 69129c0a0edd68e080e37af928954c4a0ecaae34
 SHA512:
-  metadata.gz: 0a120f2f78037c737316853b5aedf94baed0d0e6dadc90ed55a636e3a165c94e6992f5b37fa68f12408d61f9fe7b69c23d6a0e295d924888a86a47deb47988d0
-  data.tar.gz: 8389d7122ed58e0ba66408c674da5e9a6123fbb1c255a78502ea2b706741039f99e9e491f687612e8a80620ba8203377daf78b15dda79411b33b04a0aa38119b
+  metadata.gz: a6f0aeebee3996040189a535ddf6144a62f8eb6f6930e2167b7bfabff77cf00e46a8858a2061ffc7ca106586a5c67d303d2ffa2ce53ea5e1096296cbc40e7e8d
+  data.tar.gz: a2dac2aa24c3d8587c654b4d0556f0a60476a47acd36be9c60f82545531f297a1324709ce5b02aeaa4f311c40085eca4840b47e1208b5f7a46a7918ccec8c607

data/README.md

@@ -1,8 +1,8 @@
 # Formatron
 
 [![Build Status](https://travis-ci.org/formatron/formatron.svg?branch=master)](https://travis-ci.org/formatron/formatron?branch=master)
-[![Coverage Status](https://coveralls.io/repos/pghalliday/formatron/badge.svg?branch=master&service=github)](https://coveralls.io/github/pghalliday/formatron?branch=master)
-[![Dependency Status](https://gemnasium.com/pghalliday/formatron.svg)](https://gemnasium.com/pghalliday/formatron)
+[![Coverage Status](https://coveralls.io/repos/formatron/formatron/badge.svg?branch=master&service=github)](https://coveralls.io/github/formatron/formatron?branch=master)
+[![Dependency Status](https://gemnasium.com/formatron/formatron.svg)](https://gemnasium.com/formatron/formatron)
 
 Simple AWS CloudFormation configuration with Chef Server
 

data/formatron.gemspec

@@ -49,4 +49,5 @@ EOH
   spec.add_runtime_dependency 'deep_merge', '~> 1.0'
   spec.add_runtime_dependency 'berkshelf', '~> 4.0'
   spec.add_runtime_dependency 'chef', '~> 12.5'
+  spec.add_runtime_dependency 'net-ssh', '~> 2.9'
 end

data/lib/formatron/aws.rb

@@ -1,4 +1,5 @@
 require 'aws-sdk'
+require_relative 'aws/cloud_formation_stack'
 
 class Formatron
   # shared AWS clients
@@ -102,19 +103,21 @@ class Formatron
           use_previous_value: false
         }
       end
-      @cloudformation_client.create_stack(
+      cloud_formation_stack = Formatron::AWS::CloudFormationStack.new(
         stack_name: stack_name,
-        template_url: template_url,
-        capabilities: CAPABILITIES,
-        on_failure: 'DO_NOTHING',
-        parameters: aws_parameters
-      )
-    rescue Aws::CloudFormation::Errors::AlreadyExistsException
-      _update_stack(
-        stack_name: stack_name,
-        template_url: template_url,
-        parameters: aws_parameters
+        client: @cloudformation_client
       )
+      if !cloud_formation_stack.exists?
+        cloud_formation_stack.create(
+          template_url: template_url,
+          parameters: aws_parameters
+        )
+      else
+        cloud_formation_stack.update(
+          template_url: template_url,
+          parameters: aws_parameters
+        )
+      end
     end
     # rubocop:enable Metrics/MethodLength
 
@@ -124,23 +127,12 @@ class Formatron
       ).hosted_zone.name.chomp '.'
     end
 
-    def _update_stack(stack_name:, template_url:, parameters:)
-      @cloudformation_client.update_stack(
-        stack_name: stack_name,
-        template_url: template_url,
-        capabilities: CAPABILITIES,
-        parameters: parameters
-      )
-    rescue Aws::CloudFormation::Errors::ValidationError => error
-      raise error unless error.message.eql?(
-        'No updates are to be performed.'
-      )
-    end
-
     def delete_stack(stack_name:)
-      @cloudformation_client.delete_stack(
-        stack_name: stack_name
+      cloud_formation_stack = Formatron::AWS::CloudFormationStack.new(
+        stack_name: stack_name,
+        client: @cloudformation_client
       )
+      cloud_formation_stack.delete if cloud_formation_stack.exists?
     end
 
     def stack_outputs(stack_name:)
@@ -196,8 +188,7 @@ class Formatron
       :_create_aws_credentials,
       :_create_s3_client,
       :_create_cloudformation_client,
-      :_create_route53_client,
-      :_update_stack
+      :_create_route53_client
     )
   end
   # rubocop:enable Metrics/ClassLength

data/lib/formatron/aws/cloud_formation_stack.rb

@@ -0,0 +1,144 @@
+require 'aws-sdk'
+
+class Formatron
+  class AWS
+    # utilities for monitoring CloudFormation stack activities
+    # rubocop:disable Metrics/ClassLength
+    class CloudFormationStack
+      CAPABILITIES = %w(CAPABILITY_IAM)
+
+      CREATE_COMPLETE_STATUS = 'CREATE_COMPLETE'
+      CREATE_FINAL_STATUSES = %W(
+        #{CREATE_COMPLETE_STATUS}
+        CREATE_FAILED
+        ROLLBACK_COMPLETE
+        ROLLBACK_FAILED
+      )
+
+      UPDATE_COMPLETE_STATUS = 'UPDATE_COMPLETE'
+      UPDATE_FINAL_STATUSES = %W(
+        #{UPDATE_COMPLETE_STATUS}
+        UPDATE_ROLLBACK_COMPLETE
+        UPDATE_ROLLBACK_FAILED
+      )
+
+      DELETE_COMPLETE_STATUS = 'DELETE_COMPLETE'
+      DELETE_FINAL_STATUSES = %W(
+        #{DELETE_COMPLETE_STATUS}
+        DELETE_FAILED
+      )
+
+      def initialize(stack_name:, client:)
+        @stack_name = stack_name
+        @client = client
+        @stack = Aws::CloudFormation::Stack.new(
+          stack_name,
+          client: @client
+        )
+      end
+
+      def exists?
+        @stack.exists?
+      end
+
+      def create(template_url:, parameters:)
+        @client.create_stack(
+          stack_name: @stack_name,
+          template_url: template_url,
+          capabilities: CAPABILITIES,
+          on_failure: 'DO_NOTHING',
+          parameters: parameters
+        )
+        @stack.wait_until_exists
+        status = _wait_for_status statuses: CREATE_FINAL_STATUSES
+        fail status unless status.eql? CREATE_COMPLETE_STATUS
+      end
+
+      def update(template_url:, parameters:)
+        last_event_id = _last_event_id
+        return unless _update_unless_no_changes(
+          template_url: template_url,
+          parameters: parameters
+        )
+        status = _wait_for_status(
+          statuses: UPDATE_FINAL_STATUSES,
+          last_event_id: last_event_id
+        )
+        fail status unless status.eql? UPDATE_COMPLETE_STATUS
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def _update_unless_no_changes(template_url:, parameters:)
+        @stack.update(
+          template_url: template_url,
+          parameters: parameters,
+          capabilities: CAPABILITIES
+        )
+        true
+      rescue Aws::CloudFormation::Errors::ValidationError => error
+        raise error unless error.message.eql?(
+          'No updates are to be performed.'
+        )
+        Formatron::LOG.info do
+          'No updates are to be performed for CloudFormation stack'
+        end
+        false
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def delete
+        last_event_id = _last_event_id
+        @stack.delete
+        status = _wait_for_status(
+          statuses: DELETE_FINAL_STATUSES,
+          last_event_id: last_event_id
+        )
+        fail status unless status.eql? DELETE_COMPLETE_STATUS
+      end
+
+      def _last_event_id
+        @stack.events.each do |event|
+          return event.event_id
+        end
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      # rubocop:disable Metrics/AbcSize
+      def _wait_for_status(statuses:, last_event_id: nil)
+        loop do
+          events = []
+          @stack.events.each do |event|
+            break if event.event_id.eql? last_event_id
+            events.push event
+          end
+          events.reverse!
+          events.each do |event|
+            status = event.resource_status
+            timestamp = event.timestamp
+            type = event.resource_type
+            logical_id = event.logical_resource_id
+            reason = event.resource_status_reason
+            Formatron::LOG.info do
+              "#{timestamp} - #{status} - #{type} - #{logical_id} - #{reason}"
+            end
+            return status if
+              statuses.include?(status) &&
+              logical_id.eql?(@stack_name) &&
+              type.eql?('AWS::CloudFormation::Stack')
+            last_event_id = event.event_id
+          end
+          sleep 1
+        end
+      end
+      # rubocop:enable Metrics/AbcSize
+      # rubocop:enable Metrics/MethodLength
+
+      private(
+        :_update_unless_no_changes,
+        :_last_event_id,
+        :_wait_for_status
+      )
+    end
+    # rubocop:enable Metrics/ClassLength
+  end
+end

data/lib/formatron/version.rb

@@ -1,4 +1,4 @@
 # add version to class
 class Formatron
-  VERSION = '0.1.11'
+  VERSION = '0.1.12'
 end

data/support/cloudformation_stack_events_responses.rb

@@ -0,0 +1,67 @@
+require 'aws-sdk'
+
+class Formatron
+  module Support
+    # Stub CloudFormation describe_stacks response class
+    class CloudformationStackEventsResponses
+      include RSpec::Mocks::ExampleMethods
+
+      attr_reader :responses
+
+      # rubocop:disable Metrics/MethodLength
+      def initialize(stack_name:, final_status:)
+        @next_event_id = 0
+        first_response = [
+          event,
+          event,
+          event
+        ]
+        second_response = [
+          event,
+          event,
+          event,
+          *first_response
+        ]
+        third_response = [
+          event(
+            logical_resource_id: stack_name,
+            resource_status: final_status,
+            resource_type: 'AWS::CloudFormation::Stack'
+          ),
+          event,
+          event,
+          *second_response
+        ]
+        @responses = [
+          first_response,
+          second_response,
+          third_response
+        ]
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      # rubocop:disable Metrics/MethodLength
+      # rubocop:disable Metrics/AbcSize
+      def event(
+        logical_resource_id: 'logical_resource_id',
+        resource_status: 'resource_status',
+        resource_type: 'resource_type'
+      )
+        event = instance_double(Aws::CloudFormation::Event)
+        allow(event).to receive(:logical_resource_id) { logical_resource_id }
+        allow(event).to receive(:resource_status) { resource_status }
+        allow(event).to receive(:resource_type) { resource_type }
+        allow(event).to receive(:timestamp) { 'timestamp' }
+        allow(event).to receive(
+          :resource_status_reason
+        ) { 'resource_status_reason' }
+        allow(event).to receive(:event_id) do
+          @next_event_id += 1
+        end
+        event
+      end
+      # rubocop:enable Metrics/AbcSize
+      # rubocop:enable Metrics/MethodLength
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: formatron
 version: !ruby/object:Gem::Version
-  version: 0.1.11
+  version: 0.1.12
 platform: ruby
 authors:
 - Peter Halliday
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-01-07 00:00:00.000000000 Z
+date: 2016-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -276,6 +276,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '12.5'
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
 description: |
   AWS/Chef deployment tool based around Chef Server and AWS CloudFormation
 email:
@@ -303,6 +317,7 @@ files:
 - formatron.gemspec
 - lib/formatron.rb
 - lib/formatron/aws.rb
+- lib/formatron/aws/cloud_formation_stack.rb
 - lib/formatron/chef.rb
 - lib/formatron/chef/berkshelf.rb
 - lib/formatron/chef/keys.rb
@@ -390,6 +405,7 @@ files:
 - lib/formatron/util/vpc.rb
 - lib/formatron/version.rb
 - support/cloudformation_describe_stacks_response.rb
+- support/cloudformation_stack_events_responses.rb
 - support/dsl_test.rb
 - support/route53_get_hosted_zone_response.rb
 - support/s3_get_object_response.rb