lono 1.1.3 → 2.0.0

data/lib/lono/cfn/create.rb

@@ -0,0 +1,34 @@
+class Lono::Cfn::Create < Lono::Cfn::Base
+  # save_stack is the interface method
+  def save_stack(params)
+    create_stack(params)
+  end
+
+  # aws cloudformation create-stack --stack-name prod-hi-123456789 --parameters file://output/params/prod-hi-123456789.json --template-body file://output/prod-hi.json
+  def create_stack(params)
+    message = "Creating #{@stack_name} stack."
+    if @options[:noop]
+      puts "NOOP #{message}"
+      return
+    end
+
+    if stack_exists?(@stack_name)
+      puts "Cannot create '#{@stack_name}' stack because it already exists."
+      return
+    end
+
+    unless File.exist?(@template_path)
+      puts "Cannot create '#{@stack_name}' template not found: #{@template_path}."
+      return
+    end
+
+    template_body = IO.read(@template_path)
+    cfn.create_stack(
+      stack_name: @stack_name,
+      template_body: template_body,
+      parameters: params#,
+      # capabilities: ["CAPABILITY_IAM"]
+    )
+    puts message unless @options[:mute]
+  end
+end

data/lib/lono/cfn/delete.rb

@@ -0,0 +1,26 @@
+class Lono::Cfn::Delete
+  include Lono::Cfn::AwsServices
+  include Lono::Cfn::Util
+
+  def initialize(stack_name, options={})
+    @stack_name = stack_name
+    @options = options
+    @project_root = options[:project_root] || '.'
+  end
+
+  def run
+    message = "Deleted #{@stack_name} stack."
+    if @options[:noop]
+      puts "NOOP #{message}"
+    else
+      are_you_sure?(:delete)
+
+      if stack_exists?(@stack_name)
+        cfn.delete_stack(stack_name: @stack_name)
+        puts message
+      else
+        puts "#{@stack_name.inspect} stack does not exist".colorize(:red)
+      end
+    end
+  end
+end

data/lib/lono/cfn/diff.rb

@@ -0,0 +1,43 @@
+class Lono::Cfn::Diff < Lono::Cfn::Base
+  include Lono::Cfn::AwsServices
+
+  def run
+    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
+
+  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
+
+  # for clarity
+  def new_cfn_template
+    @template_path
+  end
+
+  def diff_viewer
+    return ENV['LONO_CFN_DIFF'] if ENV['LONO_CFN_DIFF']
+    system("type colordiff > /dev/null") ? "colordiff" : "diff"
+  end
+
+  def existing_template_path
+    "/tmp/existing_cfn_template.json"
+  end
+end

data/lib/lono/cfn/help.rb

@@ -0,0 +1,93 @@
+class Lono::Cfn::Help
+  class << self
+    def create
+<<-EOL
+Examples:
+
+Provided that you are in a lono project and have a `my-stack` lono template definition.  To create a stack you can simply run:
+
+$ lono cfn create my-stack
+
+The above command will generate and use the template in output/my-stack.json and parameters in params/my-stack.txt.  The template by convention defaults to the name of the stack.  In turn, the params by convention defaults to the name of the template.
+
+Here are examples of overriding the template and params name conventions.
+
+$ lono cfn create my-stack --template different-name1
+
+The template that will be use is output/different-name1.json and the parameters will use params/different-name1.json.
+
+$ lono cfn create my-stack --params different-name2
+
+The template that will be use is output/different-name2.json and the parameters will use params/different-name2.json.
+
+$ lono cfn create my-stack --template different-name3 --params different-name4
+
+The template that will be use is output/different-name3.json and the parameters will use params/different-name4.json.
+
+EOL
+    end
+
+    def update
+<<-EOL
+Examples:
+
+Provided that you are in a lono project and have a `my-stack` lono template definition.  To update a stack you can simply run:
+
+$ lono cfn update my-stack
+
+The above command will generate and use the template in output/my-stack.json and parameters in params/my-stack.txt.  The template by convention defaults to the name of the stack.  In turn, the params by convention defaults to the name of the template.
+
+Here are examples of overriding the template and params name conventions.
+
+$ lono cfn update my-stack --template different-name1
+
+The template that will be use is output/different-name1.json and the parameters will use params/different-name1.json.
+
+$ lono cfn update my-stack --params different-name2
+
+The template that will be use is output/different-name2.json and the parameters will use params/different-name2.json.
+
+$ lono cfn update my-stack --template different-name3 --params different-name4
+
+The template that will be use is output/different-name3.json and the parameters will use params/different-name4.json.
+
+EOL
+    end
+
+    def delete
+<<-EOL
+Examples:
+
+$ lono cfn delete my-stack
+
+The above command will delete my-stack.
+EOL
+    end
+
+    def preview
+<<-EOL
+Generates a CloudFormation preview.  This is similar to a `terraform plan` or puppet's dry-run mode.
+
+Example output:
+
+CloudFormation preview for 'example' stack update. Changes:
+
+Remove AWS::Route53::RecordSet: DnsRecord testsubdomain.sub.tongueroo.com
+
+Examples:
+
+$ lono cfn preview my-stack
+EOL
+    end
+
+    def diff
+<<-EOL
+Displays code diff of the generated CloudFormation template locally vs the existing template on AWS. You can set a desired diff viewer by setting the LONO_CFN_DIFF environment variable.
+
+Examples:
+
+$ lono cfn diff my-stack
+EOL
+    end
+  end
+end

data/lib/lono/cfn/preview.rb

@@ -0,0 +1,133 @@
+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
+      preview_change_set(params)
+      delete_change_set unless @options[:keep] # Clean up and delete the change set
+    end
+  end
+
+  def preview_change_set(params)
+    create_change_set(params)
+    display_change_set
+  end
+
+  def create_change_set(params)
+    unless stack_exists?(@stack_name)
+      puts "Cannot create a change set for the stack because the #{@stack_name} does not exists."
+      return
+    end
+    exist_unless_updatable(stack_status(@stack_name))
+
+    template_body = IO.read(@template_path)
+    # begin
+      cfn.create_change_set(
+        change_set_name: change_set_name,
+        stack_name: @stack_name,
+        template_body: template_body,
+        parameters: params
+      )
+    # rescue Aws::CloudFormation::Errors::ValidationError => e
+    #   if e.message =~ /^Parameters: /
+    #     puts "Error creating CloudFormation preview because invalid CloudFormation parameters. Full error message:".colorize(:red)
+    #     puts e.message
+    #     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
+      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:"
+      change_set.changes.each do |change|
+        display_change(change)
+      end
+    when "FAILED"
+      puts "Fail to create a CloudFormation preview for '#{@stack_name}' stack update. Reason:".colorize(:red)
+      puts change_set.status_reason
+      quit(1)
+    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
+
+  # generates a change set name
+  def change_set_name
+    @change_set_name ||= "changeset-#{Time.now.strftime("%Y%d%m%H%M%S")}"
+  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
+
+    colors = { Remove: :red, Add: :green, Modify: :yellow }
+    action = change.resource_change.action.to_sym
+    message = message.colorize(colors[action]) if colors.has_key?(action)
+    puts message
+  end
+
+  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

data/lib/lono/cfn/update.rb

@@ -0,0 +1,62 @@
+class Lono::Cfn::Update < Lono::Cfn::Base
+  # save_stack is the interface method
+  def save_stack(params)
+    update_stack(params)
+  end
+
+  # aws cloudformation update-stack --stack-name prod-hi-123456789 --parameters file://output/params/prod-hi-123456789.json --template-body file://output/prod-hi.json
+  def update_stack(params)
+    message = "Updating #{@stack_name} stack"
+    if @options[:noop]
+      puts "NOOP #{message}"
+      return
+    end
+
+    unless stack_exists?(@stack_name)
+      puts "Cannot update a stack because the #{@stack_name} does not exists."
+      return
+    end
+    exist_unless_updatable(stack_status(@stack_name))
+
+    error = nil
+    diff.run if @options[:diff]
+    preview.run if @options[:preview]
+    are_you_sure?(:update)
+
+    if @options[:change_set] # defaults to this
+      message << " via change set: #{preview.change_set_name}"
+      change_set_update
+    else
+      standard_update(params)
+    end
+    puts message unless @options[:mute] || error
+  end
+
+  def standard_update(params)
+    template_body = IO.read(@template_path)
+    begin
+      cfn.update_stack(
+        stack_name: @stack_name,
+        template_body: template_body,
+        parameters: params#,
+        # capabilities: ["CAPABILITY_IAM"]
+      )
+    rescue Aws::CloudFormation::Errors::ValidationError => e
+      puts "ERROR: #{e.message}".red
+      error = true
+    end
+  end
+
+  def preview
+    options = @options.merge(lono: false, mute_params: true, mute_using: true, keep: true)
+    @preview ||= Preview.new(@stack_name, options)
+  end
+
+  def diff
+    @diff ||= Diff.new(@stack_name, @options.merge(lono: false, mute_params: true, mute_using: true))
+  end
+
+  def change_set_update
+    preview.execute_change_set
+  end
+end

data/lib/lono/cfn/util.rb

@@ -0,0 +1,21 @@
+module Lono::Cfn::Util
+  def are_you_sure?(action)
+    if @options[:sure]
+      sure = 'y'
+    else
+      message = case action
+      when :update
+        "Are you sure you want to want to update the stack with the changes? (y/N)"
+      when :delete
+        "Are you sure you want to want to delete the stack with the changes? (y/N)"
+      end
+      puts message
+      sure = $stdin.gets
+    end
+
+    unless sure =~ /^y/
+      puts "Exiting without #{action}"
+      exit 0
+    end
+  end
+end

data/lib/lono/cli.rb

@@ -1,8 +1,10 @@
 require 'thor'
-require 'lono/cli/help'
+require 'lono/command'
 
 module Lono
-  class CLI < Thor
+  autoload :Help, 'lono/help'
+
+  class CLI < Command
 
     desc "new [NAME]", "Generates lono starter project"
     Help.new_long_desc
@@ -13,20 +15,16 @@ module Lono
       Lono::New.new(options.clone.merge(project_root: project_root)).run
     end
 
-    desc "generate", "Generate the cloudformation templates"
+    desc "generate", "Generate both CloudFormation templates and parameters files"
     Help.generate
     option :clean, type: :boolean, aliases: "-c", desc: "remove all output files before generating"
     option :project_root, default: ".", aliases: "-r", desc: "project root"
     option :quiet, type: :boolean, aliases: "-q", desc: "silence the output"
     option :pretty, type: :boolean, default: true, desc: "json pretty the output.  only applies with json format"
     def generate
-      Lono::DSL.new(options.clone).run
-    end
-
-    desc "bashify [URL-OR-PATH]", "Convert the UserData section of an existing CloudFormation Template to a starter bash script that is compatiable with lono"
-    Help.bashify
-    def bashify(path)
-      Lono::Bashify.new(path: path).run
+      puts "Generating both CloudFormation template and parameter files."
+      Lono::Template::DSL.new(options.clone).run
+      Lono::Param::Generator.generate_all(options.clone)
     end
 
     desc "version", "Prints version"
@@ -34,5 +32,16 @@ module Lono
       puts Lono::VERSION
     end
 
+    desc "template ACTION", "template subcommand tasks"
+    long_desc Help.template
+    subcommand "template", Template
+
+    desc "cfn ACTION", "cfn subcommand tasks"
+    long_desc Help.cfn
+    subcommand "cfn", Cfn
+
+    desc "param ACTION", "param subcommand tasks"
+    long_desc Help.param
+    subcommand "param", Lono::Param
   end
 end