stackr 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4abaed24f2b631c6c606e42728638875f804faaa
-  data.tar.gz: fa06bb7dddea64f00578231469e1bb6f6d059a1d
+  metadata.gz: 5400276137168449771e71adbdd0c18da5c21e0f
+  data.tar.gz: 59e07af064f309b0b2940ea191514642e6ff71bb
 SHA512:
-  metadata.gz: 6d15801b97decfc17ff569b6a01b8f4d9cf30506e1a2ad4cc59ba0e8c93c632a3ae30a53853a4010b0e23716c41bd122aa14b2de0611316b01f6ac2e37fc9c2f
-  data.tar.gz: 7615c0e6e6af49058354fdb37829ced752809b5f6e540cec0f2c1ace49fcc55078f4f07742443bcc6f0f59a2875a72ecb08b4e865c41e5e6b11595c93fadf269
+  metadata.gz: db02fba0dbceca816d2ffda2b2ed7aa6ff366210f3737194a7b9a2d7d77b4b30f249ebe97c05d7e0d0a5dc988d308e6d3821c869d3382abac36452da8d1a52f2
+  data.tar.gz: c779134b35dff120b7237b59c431725f5eec360bf1431e02611aa63450e491495252ffec9eb8561c137f986a48a200893faa1fc35ed35e7b3b266dc4d2e457cc

data/lib/stackr/cli.rb

@@ -189,5 +189,121 @@ module Stackr
       print_table rows
     end
 
+    ## create-change-set
+    desc 'create-change-set TEMPLATE', 'create a change set'
+    option :change_set_name,
+      aliases: '-c',
+      desc: 'Change set name, defaults to "new-TEMPLATE"'
+
+    option :stack_name,
+      aliases: '-s',
+      desc: 'Stack name, defaults to TEMPLATE'
+
+    def create_change_set(template_name)
+      return if !validate_template(template_name)
+
+      template = load_template(template_name)
+      if !template
+        say "There is no template named \'#{template_name}\'."
+        return
+      end
+
+      change_set_name = options[:change_set_name] || "new-#{template.name}"
+      stack_name = options[:stack_name] || template.name
+      launcher = Stackr::CloudFormation.new
+      say "Creating CloudFormation stack change set #{change_set_name} from template #{template.name} for stack #{stack_name}\n"
+      begin
+        sets = launcher.create_change_set(stack_name, template, change_set_name, options)
+      rescue Stackr::StackMissingError => e
+        say e.message
+      rescue Stackr::StackUpdateNotRequiredError => e
+        say e.message
+      rescue Stackr::InsufficientCapabilitiesError => e
+        say e.message
+      end
+
+    end
+
+    desc 'list-change-sets STACK', 'list all change sets for STACK'
+    def list_change_sets(stack_name)
+      launcher = Stackr::CloudFormation.new
+      begin
+        sets = launcher.list_change_sets(stack_name)
+      rescue Stackr::StackMissingError => e
+        say e.message
+        return
+      end
+      rows = []
+      sets.each do |set|
+        rows << [
+          set.change_set_name,
+          set.creation_time,
+          set.execution_status,
+          set.status
+        ]
+      end
+      print_table rows
+    end
+
+    desc 'show-change-set CHANGESET', 'show json details of CHANGESET'
+    option :stack_name,
+      aliases: '-s',
+      desc: 'Stack name, required if CHANGESET is not an ARN'
+
+    def show_change_set(change_set_name)
+      launcher = Stackr::CloudFormation.new
+      stack_name = options[:stack_name]
+      begin
+        set = launcher.show_change_set(change_set_name, stack_name)
+      rescue Stackr::ChangeSetMissingError => e
+        say e.message
+        return
+      rescue Stackr::StackNameMissingError => e
+        say e.message
+        return
+      end
+      require 'json'
+      say JSON.pretty_generate(set)
+    end
+
+    desc 'delete-change-set CHANGESET', 'delete CHANGESET'
+    option :stack_name,
+      aliases: '-s',
+      desc: 'Stack name, required if CHANGESET is not an ARN'
+
+    def delete_change_set(change_set_name)
+      launcher = Stackr::CloudFormation.new
+      stack_name = options[:stack_name]
+      begin
+        launcher.delete_change_set(change_set_name, stack_name)
+      rescue Stackr::ChangeSetMissingError => e
+        say e.message
+        return
+      rescue Stackr::StackNameMissingError => e
+        say e.message
+        return
+      end
+      say "Change set #{change_set_name} deleted."
+    end
+
+    desc 'execute-change-set CHANGESET', 'execute CHANGESET'
+    option :stack_name,
+      aliases: '-s',
+      desc: 'Stack name, required if CHANGESET is not an ARN'
+
+    def execute_change_set(change_set_name)
+      launcher = Stackr::CloudFormation.new
+      stack_name = options[:stack_name]
+      begin
+        launcher.execute_change_set(change_set_name, stack_name)
+      rescue Stackr::ChangeSetMissingError => e
+        say e.message
+        return
+      rescue Stackr::StackNameMissingError => e
+        say e.message
+        return
+      end
+      say "Change set #{change_set_name} executed"
+    end
   end
 end

data/lib/stackr/cloudformation.rb

@@ -22,7 +22,7 @@ module Stackr
     def upload_to_s3(template_str, name)
       s3 = Aws::S3::Resource.new
       if ENV['TEMPLATE_BUCKET'].nil?
-        raise Stackr::MissingTemplateBucketError, 'Please set TEMPLATE_BUCKET environment variable before uploading templates to S3.'
+        raise Stackr::TemplateBucketMissingError, 'Please set TEMPLATE_BUCKET environment variable before uploading templates to S3.'
       end
       bucket = s3.bucket(ENV['TEMPLATE_BUCKET'])
       key = "#{name}.json"
@@ -81,7 +81,7 @@ module Stackr
         env_var    = template.parameter_map[param_name]
 
         if param[:default_value].nil? && ENV[env_var].nil?
-          raise Stackr::MissingParameterError, "Required parameter #{param_name} (#{env_var}) not specified."
+          raise Stackr::ParameterMissingError, "Required parameter #{param_name} (#{env_var}) not specified."
         end
       end
     end
@@ -156,5 +156,103 @@ module Stackr
       cfn = Aws::CloudFormation::Resource.new
       cfn.stacks
     end
+
+    # template is a Stackr::Template
+    def create_change_set(stack_name, template, change_set_name, options)
+      cfn = Aws::CloudFormation::Resource.new
+      stack = cfn.stack(stack_name)
+      if !stack
+        raise Stackr::StackMissingError, "Stack #{stack_name} does not exist."
+      end
+
+      opts = {
+        stack_name:      stack_name,
+        change_set_name: change_set_name,
+        parameters:      stack_parameters(template.parameter_map),
+        capabilities:    template.capabilities
+      }
+
+      # are we using template_body or template_url?
+      opts.merge!( template_argument(template) )
+
+      begin
+        # stack.update(opts)
+        resp = cfn.client.create_change_set(opts)
+      rescue Aws::CloudFormation::Errors::ValidationError => e
+        case e.message
+        when 'No updates are to be performed.'
+          raise Stackr::StackUpdateNotRequiredError, "Stack [#{stack_name}] requires no updates."
+        when "Stack [#{stack_name}] does not exist"
+          raise Stackr::StackMissingError, e.message
+        else
+          raise e
+        end
+      rescue Aws::CloudFormation::Errors::InsufficientCapabilitiesException => e
+        raise Stackr::InsufficientCapabilitiesError, "#{e.message}\nPlease add them to your template and run update again."
+      end
+      say "Change set #{change_set_name}, id: #{resp.id}"
+    end
+
+    def list_change_sets(stack_name)
+      cfn = Aws::CloudFormation::Resource.new
+      stack = cfn.stack(stack_name)
+      if !stack
+        raise Stackr::StackMissingError, "Stack #{stack_name} does not exist."
+      end
+      resp = cfn.client.list_change_sets({stack_name: stack_name})
+      return resp.summaries
+    end
+
+    def show_change_set(change_set_name, stack_name)
+      if stack_name.nil? && !change_set_name.start_with?('arn')
+        raise Stackr::StackNameMissingError, "If change_set_name is not an ARN, you must specify stack_name"
+      end
+
+      cfn = Aws::CloudFormation::Client.new
+      opts = {
+        change_set_name: change_set_name,
+        stack_name: stack_name
+      }
+      begin
+        resp = cfn.describe_change_set(opts)
+      rescue Aws::CloudFormation::Errors::ChangeSetNotFound => e
+        raise Stackr::ChangeSetMissingError, e.message
+      end
+      return resp.data
+    end
+
+    def delete_change_set(change_set_name, stack_name)
+      if stack_name.nil? && !change_set_name.start_with?('arn')
+        raise Stackr::StackNameMissingError, "If change_set_name is not an ARN, you must specify stack_name"
+      end
+
+      cfn = Aws::CloudFormation::Client.new
+      opts = {
+        change_set_name: change_set_name,
+        stack_name: stack_name
+      }
+      begin
+        resp = cfn.delete_change_set(opts)
+      rescue Aws::CloudFormation::Errors::ChangeSetNotFound => e
+        raise Stackr::ChangeSetMissingError, e.message
+      end
+    end
+
+    def execute_change_set(change_set_name, stack_name)
+      if stack_name.nil? && !change_set_name.start_with?('arn')
+        raise Stackr::StackNameMissingError, "If change_set_name is not an ARN, you must specify stack_name"
+      end
+
+      cfn = Aws::CloudFormation::Client.new
+      opts = {
+        change_set_name: change_set_name,
+        stack_name: stack_name
+      }
+      begin
+        cfn.execute_change_set(opts)
+      rescue Aws::CloudFormation::Errors::ChangeSetNotFound => e
+        raise Stackr::ChangeSetMissingError, e.message
+      end
+    end
   end
 end

data/lib/stackr/errors.rb

@@ -4,7 +4,9 @@ module Stackr
   class StackUpdateNotRequiredError < StandardError; end
   class InsufficientCapabilitiesError < StandardError; end
   class TemplateValidationError < StandardError; end
-  class MissingParameterError < StandardError; end
+  class ParameterMissingError < StandardError; end
   class TemplateTooBigError < StandardError; end
-  class MissingTemplateBucketError < StandardError; end
+  class TemplateMissingBucketError < StandardError; end
+  class StackNameMissingError < StandardError; end
+  class ChangeSetMissingError < StandardError; end
 end

data/lib/stackr/version.rb

@@ -1,3 +1,3 @@
 module Stackr
-  VERSION = "1.0.1"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stackr
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Chris Chalfant
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-08-01 00:00:00.000000000 Z
+date: 2016-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk