lono 5.1.1 → 5.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a36f1ee3d7076e1e93fa9a395c984978510b9961657de60b026cd4a666b46ab6
-  data.tar.gz: 9d4104ceab9f1673057374aa86d31800d75ebe89652348a400b6bd481ccac444
+  metadata.gz: d79eafbad66de9522347e12c16fa2909ea03994986141858fee5e80e070bb7d5
+  data.tar.gz: be34b26768651c90b7a4435839d2850ba03473dae6c7a1bdb8a2eecd4158954f
 SHA512:
-  metadata.gz: 40ad69f3970916114081b028085f5a55c65511793571466db2a7fa0229c804491742a5394106838204495432303090ae40b5476232bdcee8fdd7689d5282a180
-  data.tar.gz: 34e2fd774d94f30b594d7ba602d1d6f0597bedb1127f0821f223f383109c85f38ee332cc05f196ab5834fafb9e01fd2134b9d008c5f7c9e32074c6f69f18b68b
+  metadata.gz: ce9534510931f8b2cf8ca93d8cd803b862ba8910f573efe373f2c0fed043a3fe1e11316351b23d664d75e8c90f42942abf4adb904a71bbf72b6e43f8d89b9ed0
+  data.tar.gz: e94c2080921f2dc4211fb14d7f35f9c30189fbd0a2310b7b5a8fc925cd0d1f4934dfc669787d0462e27acd15a8ec46e28b355a86b5a269da128f1660ba5e9c46

data/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project will be documented in this file.
 This project *tries* to adhere to [Semantic Versioning](http://semver.org/), even before v1.0.
 
+## [5.2.0]
+- #5 lono seed command: Lono::Seed::Configs class interface
+- add lono cfn cancel command
+- content helper
+- gracefully handle edge cases with lono s3 bucket
+- cleanup classes and modules
+
 ## [5.1.1]
 - use cfn_camelizer as gem
 

data/lib/lono/app_file/base.rb

@@ -4,7 +4,7 @@ module Lono::AppFile
     include Lono::Blueprint::Root
     extend Memoist
 
-    def initialize(blueprint, options = {})
+    def initialize(blueprint, options={})
       @blueprint, @options = blueprint, options
       @template = @options[:template] || @blueprint
       Lono::ProjectChecker.check

data/lib/lono/aws_services/util.rb

@@ -39,7 +39,7 @@ module Lono::AwsServices
     end
 
     def rollback_complete?(stack)
-      stack.stack_status == 'ROLLBACK_COMPLETE'
+      stack&.stack_status == 'ROLLBACK_COMPLETE'
     end
 
     def testing_update?

data/lib/lono/blueprint/root.rb

@@ -13,9 +13,11 @@ class Lono::Blueprint
       if blueprint_root
         Lono.blueprint_root = blueprint_root
       else
-        puts "ERROR: Unable to find the blueprint #{blueprint}.  " \
-            "Are you sure it's in your Gemfile or in the blueprints folder "\
-            "with the correct blueprint_name in .lono/config.yml?".color(:red)
+        puts <<~EOL.color(:red)
+          ERROR: Unable to find the blueprint #{blueprint}.
+          Are you sure its in your Gemfile or in the blueprints folder
+          with the correct blueprint_name in .meta/config.yml?
+        EOL
         List.available
         exit 1
       end

data/lib/lono/cfn/base.rb

@@ -27,10 +27,6 @@ class Lono::Cfn
       @template_path = "#{Lono.config.output_path}/#{@blueprint}/templates/#{@template}.yml"
     end
 
-    def switch_current(stack_name)
-      Current.name!(stack_name)
-    end
-
     def starting_message
       action = self.class.to_s.split('::').last
       puts "#{action} #{@stack_name.color(:green)} stack..."
@@ -170,7 +166,7 @@ class Lono::Cfn
     def ensure_s3_bucket_exist
       bucket = Lono::S3::Bucket.new
       return if bucket.exist?
-      bucket.create
+      bucket.deploy
     end
 
     def build_scripts

data/lib/lono/cfn/cancel.rb

@@ -0,0 +1,36 @@
+class Lono::Cfn
+  class Cancel
+    include Lono::AwsServices
+    include Util
+
+    def initialize(stack_name, options={})
+      @stack_name = switch_current(stack_name)
+      @options = options
+    end
+
+    def run
+      stack = find_stack(@stack_name)
+      unless stack
+        puts "The '#{@stack_name}' stack does not exist. Unable to cancel"
+        exit 1
+      end
+
+      puts "Canceling updates to #{@stack_name}."
+      puts "Current stack status: #{stack.stack_status}"
+      if stack.stack_status == "CREATE_IN_PROGRESS"
+        cfn.delete_stack(stack_name: @stack_name)
+        puts "Canceling stack creation."
+      elsif stack.stack_status == "UPDATE_IN_PROGRESS"
+        cfn.cancel_update_stack(stack_name: @stack_name)
+        puts "Canceling stack update."
+        status.wait if @options[:wait]
+      else
+        puts "The stack is not in a state to that is cancelable: #{stack.stack_status}"
+      end
+    end
+
+    def status
+      @status ||= Status.new(@stack_name)
+    end
+  end
+end

data/lib/lono/cfn/delete.rb

@@ -1,39 +1,37 @@
-class Lono::Cfn::Delete
-  include Lono::AwsServices
-  include Lono::Cfn::Util
+class Lono::Cfn
+  class Delete
+    include Lono::AwsServices
+    include Util
 
-  def initialize(stack_name, options={})
-    @stack_name = switch_current(stack_name)
-    @options = options
-  end
-
-  def run
-    message = "Deleted #{@stack_name} stack."
-    if @options[:noop]
-      puts "NOOP #{message}"
-    else
-      are_you_sure?(@stack_name, :delete)
+    def initialize(stack_name, options={})
+      @stack_name = switch_current(stack_name)
+      @options = options
+    end
 
-      if stack_exists?(@stack_name)
-        cfn.delete_stack(stack_name: @stack_name)
-        puts message
+    def run
+      message = "Deleted #{@stack_name} stack."
+      if @options[:noop]
+        puts "NOOP #{message}"
       else
-        puts "#{@stack_name.inspect} stack does not exist".color(:red)
-      end
-    end
+        are_you_sure?(@stack_name, :delete)
 
-    return unless @options[:wait]
-    start_time = Time.now
-    status.wait unless @options[:noop]
-    took = Time.now - start_time
-    puts "Time took for stack deletion: #{status.pretty_time(took).color(:green)}."
-  end
+        if stack_exists?(@stack_name)
+          cfn.delete_stack(stack_name: @stack_name)
+          puts message
+        else
+          puts "#{@stack_name.inspect} stack does not exist".color(:red)
+        end
+      end
 
-  def status
-    @status ||= Cfn::Status.new(@stack_name)
-  end
+      return unless @options[:wait]
+      start_time = Time.now
+      status.wait unless @options[:noop]
+      took = Time.now - start_time
+      puts "Time took for stack deletion: #{status.pretty_time(took).color(:green)}."
+    end
 
-  def switch_current(stack_name)
-    Lono::Cfn::Current.name!(stack_name)
+    def status
+      @status ||= Status.new(@stack_name)
+    end
   end
-end
+end

data/lib/lono/cfn/diff.rb

@@ -1,48 +1,50 @@
-class Lono::Cfn::Diff < Lono::Cfn::Base
-  include Lono::AwsServices
+class Lono::Cfn
+  class Diff < Base
+    include Lono::AwsServices
 
-  def run
-    unless stack_exists?(@stack_name)
-      puts "WARN: Cannot create a diff for the stack because the #{@stack_name} does not exists.".color(:yellow)
-      return
-    end
+    def run
+      unless stack_exists?(@stack_name)
+        puts "WARN: Cannot create a diff for the stack because the #{@stack_name} does not exists.".color(:yellow)
+        return
+      end
 
-    if @options[:noop]
-      puts "NOOP Generating CloudFormation source code diff..."
-    else
-      generate_all # from Base superclass. Generates the output lono teplates
-      puts "Generating CloudFormation source code diff..."
-      download_existing_cfn_template
-      show_changes
+      if @options[:noop]
+        puts "NOOP Generating CloudFormation source code diff..."
+      else
+        generate_all # from Base superclass. Generates the output lono teplates
+        puts "Generating CloudFormation source code diff..."
+        download_existing_cfn_template
+        show_changes
+      end
     end
-  end
 
-  def download_existing_cfn_template
-    resp = cfn.get_template(
-      stack_name: @stack_name,
-      template_stage: "Original"
-    )
-    resp.template_body
-    IO.write(existing_template_path, resp.template_body)
-  end
+    def download_existing_cfn_template
+      resp = cfn.get_template(
+        stack_name: @stack_name,
+        template_stage: "Original"
+      )
+      resp.template_body
+      IO.write(existing_template_path, resp.template_body)
+    end
 
-  def show_changes
-    command = "#{diff_viewer} #{existing_template_path} #{new_cfn_template}"
-    puts "Running: #{command}"
-    system(command)
-  end
+    def show_changes
+      command = "#{diff_viewer} #{existing_template_path} #{new_cfn_template}"
+      puts "Running: #{command}"
+      system(command)
+    end
 
-  # for clarity
-  def new_cfn_template
-    @template_path
-  end
+    # for clarity
+    def new_cfn_template
+      @template_path
+    end
 
-  def diff_viewer
-    return ENV['LONO_DIFF'] if ENV['LONO_DIFF']
-    system("type colordiff > /dev/null") ? "colordiff" : "diff"
-  end
+    def diff_viewer
+      return ENV['LONO_DIFF'] if ENV['LONO_DIFF']
+      system("type colordiff > /dev/null") ? "colordiff" : "diff"
+    end
 
-  def existing_template_path
-    "/tmp/existing_cfn_template.yml"
+    def existing_template_path
+      "/tmp/existing_cfn_template.yml"
+    end
   end
 end

data/lib/lono/cfn/download.rb

@@ -1,31 +1,33 @@
 require 'json'
 
-class Lono::Cfn::Download < Lono::Cfn::Base
-  def run
-    puts "Download existing template to: #{download_path}"
-    return if @options[:noop]
-    download_template
-  end
+class Lono::Cfn
+  class Download < Base
+    def run
+      puts "Download existing template to: #{download_path}"
+      return if @options[:noop]
+      download_template
+    end
 
-  def download_template
-    resp = cfn.get_template(
-      stack_name: @stack_name,
-      template_stage: "Original"
-    )
-    body = convert_to_yaml(resp.template_body)
-    IO.write(download_path, body)
-  end
+    def download_template
+      resp = cfn.get_template(
+        stack_name: @stack_name,
+        template_stage: "Original"
+      )
+      body = convert_to_yaml(resp.template_body)
+      IO.write(download_path, body)
+    end
 
-  def convert_to_yaml(body)
-    json?(body) ? YAML.dump(JSON.parse(body)) : body
-  end
+    def convert_to_yaml(body)
+      json?(body) ? YAML.dump(JSON.parse(body)) : body
+    end
 
-  def json?(body)
-    !!JSON.parse(body) rescue false
-  end
+    def json?(body)
+      !!JSON.parse(body) rescue false
+    end
 
-  def download_path
-    name = @options[:name] || @stack_name
-    "/tmp/#{name}.yml"
+    def download_path
+      name = @options[:name] || @stack_name
+      "/tmp/#{name}.yml"
+    end
   end
 end

data/lib/lono/cfn/preview.rb

@@ -1,149 +1,151 @@
-class Lono::Cfn::Preview < Lono::Cfn::Base
-  # Override run from Base superclass, the run method is different enough with Preview
-  def run
-    if @options[:noop]
-      puts "NOOP CloudFormation preview for #{@stack_name} update"
-    else
-      params = generate_all
-      success = preview_change_set(params)
-      delete_change_set if success && !@options[:keep] # Clean up and delete the change set
+class Lono::Cfn
+  class Preview < Base
+    # Override run from Base superclass, the run method is different enough with Preview
+    def run
+      if @options[:noop]
+        puts "NOOP CloudFormation preview for #{@stack_name} update"
+      else
+        params = generate_all
+        success = preview_change_set(params)
+        delete_change_set if success && !@options[:keep] # Clean up and delete the change set
+      end
     end
-  end
-
-  def preview_change_set(params)
-    success = create_change_set(params)
-    display_change_set if success
-  end
 
-  def create_change_set(params)
-    unless stack_exists?(@stack_name)
-      puts "WARN: Cannot create a change set for the stack because the #{@stack_name} does not exists.".color(:yellow)
-      return false
+    def preview_change_set(params)
+      success = create_change_set(params)
+      display_change_set if success
     end
-    exit_unless_updatable!(stack_status(@stack_name))
 
-    params = {
-      change_set_name: change_set_name,
-      stack_name: @stack_name,
-      parameters: params,
-      capabilities: capabilities, # ["CAPABILITY_IAM", "CAPABILITY_NAMED_IAM"],
-    }
-    params[:tags] = tags unless tags.empty?
-    set_template_body!(params)
-    show_parameters(params, "cfn.create_change_set")
-    begin
-      cfn.create_change_set(params)
-    rescue Aws::CloudFormation::Errors::ValidationError => e
-      handle_error(e)
+    def create_change_set(params)
+      unless stack_exists?(@stack_name)
+        puts "WARN: Cannot create a change set for the stack because the #{@stack_name} does not exists.".color(:yellow)
+        return false
+      end
+      exit_unless_updatable!(stack_status(@stack_name))
+
+      params = {
+        change_set_name: change_set_name,
+        stack_name: @stack_name,
+        parameters: params,
+        capabilities: capabilities, # ["CAPABILITY_IAM", "CAPABILITY_NAMED_IAM"],
+      }
+      params[:tags] = tags unless tags.empty?
+      set_template_body!(params)
+      show_parameters(params, "cfn.create_change_set")
+      begin
+        cfn.create_change_set(params)
+      rescue Aws::CloudFormation::Errors::ValidationError => e
+        handle_error(e)
+      end
+      true
     end
-    true
-  end
 
-  # Example errors:
-  # "Template error: variable names in Fn::Sub syntax must contain only alphanumeric characters, underscores, periods, and colons"
-  def handle_error(e)
-    raise if ENV['FULL_BACKTRACE']
+    # Example errors:
+    # "Template error: variable names in Fn::Sub syntax must contain only alphanumeric characters, underscores, periods, and colons"
+    def handle_error(e)
+      raise if ENV['FULL_BACKTRACE']
 
-    if e.message =~ /^Parameters: / || e.message =~ /^Template error: /
-      puts "Error creating CloudFormation preview because invalid CloudFormation parameters. Full error message:".color(:red)
-      puts e.message
-      puts "For full backtrace run command again with FULL_BACKTRACE=1"
-      quit(1)
-    else
-      raise
+      if e.message =~ /^Parameters: / || e.message =~ /^Template error: /
+        puts "Error creating CloudFormation preview because invalid CloudFormation parameters. Full error message:".color(:red)
+        puts e.message
+        puts "For full backtrace run command again with FULL_BACKTRACE=1"
+        quit(1)
+      else
+        raise
+      end
     end
-  end
 
-  def display_change_set
-    print "Generating CloudFormation Change Set for preview.."
-    change_set = describe_change_set
-    until change_set_finished?(change_set) do
+    def display_change_set
+      print "Generating CloudFormation Change Set for preview.."
       change_set = describe_change_set
-      sleep 1
-      print '.'
-    end
-    puts
-
-    case change_set.status
-    when "CREATE_COMPLETE"
-      puts "CloudFormation preview for '#{@stack_name}' stack update. Changes:"
-      changes = change_set.changes.sort_by do |change|
-        change["resource_change"]["action"]
+      until change_set_finished?(change_set) do
+        change_set = describe_change_set
+        sleep 1
+        print '.'
       end
-      changes.each do |change|
-        display_change(change)
+      puts
+
+      case change_set.status
+      when "CREATE_COMPLETE"
+        puts "CloudFormation preview for '#{@stack_name}' stack update. Changes:"
+        changes = change_set.changes.sort_by do |change|
+          change["resource_change"]["action"]
+        end
+        changes.each do |change|
+          display_change(change)
+        end
+      when "FAILED"
+        puts "WARN: Fail to create a CloudFormation preview for '#{@stack_name}' stack update. Reason:".color(:yellow)
+        puts change_set.status_reason
+        quit(0)
+      else
+        raise "hell: never come here"
       end
-    when "FAILED"
-      puts "WARN: Fail to create a CloudFormation preview for '#{@stack_name}' stack update. Reason:".color(:yellow)
-      puts change_set.status_reason
-      quit(0)
-    else
-      raise "hell: never come here"
     end
-  end
 
-  def delete_change_set
-    cfn.delete_change_set(
-      change_set_name: change_set_name,
-      stack_name: @stack_name
-    )
-  end
-
-  def execute_change_set
-    cfn.execute_change_set(
-      change_set_name: change_set_name,
-      stack_name: @stack_name
-    )
-  end
+    def delete_change_set
+      cfn.delete_change_set(
+        change_set_name: change_set_name,
+        stack_name: @stack_name
+      )
+    end
 
-  # generates a change set name
-  def change_set_name
-    @change_set_name ||= "changeset-#{Time.now.strftime("%Y%d%m%H%M%S")}"
-  end
+    def execute_change_set
+      cfn.execute_change_set(
+        change_set_name: change_set_name,
+        stack_name: @stack_name
+      )
+    end
 
-private
-  # Private: formats a Aws::CloudFormation::Types::Change in pretty human readable form
-  #
-  # change  - Aws::CloudFormation::Types::Change
-  #
-  # Examples
-  #
-  #   display_change(change)
-  #   => Remove AWS::Route53::RecordSet: DnsRecord testsubdomain.sub.tongueroo.com
-  #
-  # Returns nil
-  #
-  # change.to_h
-  # {:type=>"Resource",
-  #  :resource_change=>
-  #   {:action=>"Remove",
-  #    :logical_resource_id=>"DnsRecord",
-  #    :physical_resource_id=>"testsubdomain.sub.tongueroo.com",
-  #    :resource_type=>"AWS::Route53::RecordSet",
-  #    :scope=>[],
-  #    :details=>[]}}
-  def display_change(change)
-    message = if change.type == "Resource"
-      c = change.resource_change
-      "#{c.action} #{c.resource_type}: #{c.logical_resource_id} #{c.physical_resource_id}"
-    else
-      change.to_h
+    # generates a change set name
+    def change_set_name
+      @change_set_name ||= "changeset-#{Time.now.strftime("%Y%d%m%H%M%S")}"
     end
 
-    colors = { Remove: :red, Add: :green, Modify: :yellow }
-    action = change.resource_change.action.to_sym
-    message = message.color(colors[action]) if colors.has_key?(action)
-    puts message
-  end
+  private
+    # Private: formats a Aws::CloudFormation::Types::Change in pretty human readable form
+    #
+    # change  - Aws::CloudFormation::Types::Change
+    #
+    # Examples
+    #
+    #   display_change(change)
+    #   => Remove AWS::Route53::RecordSet: DnsRecord testsubdomain.sub.tongueroo.com
+    #
+    # Returns nil
+    #
+    # change.to_h
+    # {:type=>"Resource",
+    #  :resource_change=>
+    #   {:action=>"Remove",
+    #    :logical_resource_id=>"DnsRecord",
+    #    :physical_resource_id=>"testsubdomain.sub.tongueroo.com",
+    #    :resource_type=>"AWS::Route53::RecordSet",
+    #    :scope=>[],
+    #    :details=>[]}}
+    def display_change(change)
+      message = if change.type == "Resource"
+        c = change.resource_change
+        "#{c.action} #{c.resource_type}: #{c.logical_resource_id} #{c.physical_resource_id}"
+      else
+        change.to_h
+      end
 
-  def change_set_finished?(change_set)
-    change_set.status =~ /_COMPLETE/ || change_set.status == "FAILED"
-  end
+      colors = { Remove: :red, Add: :green, Modify: :yellow }
+      action = change.resource_change.action.to_sym
+      message = message.color(colors[action]) if colors.has_key?(action)
+      puts message
+    end
 
-  def describe_change_set
-    cfn.describe_change_set(
-      change_set_name: change_set_name,
-      stack_name: @stack_name
-    )
+    def change_set_finished?(change_set)
+      change_set.status =~ /_COMPLETE/ || change_set.status == "FAILED"
+    end
+
+    def describe_change_set
+      cfn.describe_change_set(
+        change_set_name: change_set_name,
+        stack_name: @stack_name
+      )
+    end
   end
 end

data/lib/lono/cfn/status.rb

@@ -1,5 +1,7 @@
 class Lono::Cfn
   class Status < ::Cfn::Status
+    include Util
+
     def initialize(stack_name, options={})
       super
       @stack_name = switch_current(stack_name)