bora 1.4.1 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a0e4a8a4f46e58395bd724d7b5b43e47682aa4ad
-  data.tar.gz: 9f457db9cd67e8b64d6c23d2424491f69cd8977f
+  metadata.gz: ff4f553135f201ba7386c5b97464b2cf23931c85
+  data.tar.gz: 78c79cc5fd9755d085b6f28ea6c8233a967fc0c2
 SHA512:
-  metadata.gz: 000fe250f567e4e7e9ad734fdab2f3c8d0783e0d688492163690849cb60c1111e9932267393edce64c7bf856ec7bf1b4b03e925eb4cd9559f6280f0ff6b0dea2
-  data.tar.gz: db0d0bde5699eff9255cf38e98419ca46805b0d57f84505e6568ef42568f7294f82238fd66a28f52109559a8248a946de025ad33b84928ccb08aa454268ea5e6
+  metadata.gz: f95882cd11d3ee76306203b5a38c765c7ff525ff6e7633325593d5114afee6dee4ebf00f26dae6088628fb8a891ed1bfd488c8cb43d3d0175aa2b85e6837c874
+  data.tar.gz: ae7563ed6725c60cd623051a3f3cbd625aa1eff8bacce0a5e7c3931a92a7fac07b86a15efc26557b824c20927dbed2b5ee660f9d20b97ae42e29ae63a142cf86

data/README.md

@@ -151,8 +151,10 @@ templates:
 The following commands are available through the command line and rake tasks.
 
 * **apply** - Creates the stack if it doesn't exist, or updates it otherwise
+* **changeset** - Manage CloudFormation change sets for the stack
 * **delete** - Deletes the stack
-* **diff** - Provides a visual diff between the local template and the currently applied template in AWS
+* **diff** - Provides a visual diff between the local template and the currently applied template in AWS.
+  The diff also shows the changes that CloudFormation will apply as reported by the CloudFormation [Change Set API](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html).
 * **events** - Outputs the latest events from the stack
 * **list** - Outputs a list of all stacks defined in the config file
 * **outputs** - Shows the outputs from the stack
@@ -163,6 +165,20 @@ The following commands are available through the command line and rake tasks.
 * **status** - Displays the current status of the stack
 * **validate** - Validates the template using the AWS CloudFormation "validate" API call
 
+### Change Sets
+Bora provides full support for working with [CloudFormation Change Sets](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html)
+via the "changeset" command. The following subcommands are available (eg: `bora changeset <subcommand> ...`). Run `bora changeset help` for more information.
+
+* **changeset create** - Creates a change set for the stack
+* **changeset list** - Lists all available change sets for the stack
+* **changeset show** - Shows the details of a particular change set
+* **changeset apply** - Applies a change set. Any other available change sets will be automatically deleted by AWS after this action.
+* **changeset delete** - Deletes a particular change set for the stack
+
+Note that `bora diff` will also show you a summary of the change set that will be applied.
+It does this by creating (and automaticlly deleting) a temporary change set in order to get the change actions to display.
+
+Note that change set funtionality is not available via the Rake tasks at this time.
 
 ### Command Line
 
@@ -288,9 +304,12 @@ ${hostedzone://example.com/private}
 
 Looks up an AMI given a name prefix which may contain wildcards. If query returns multiple images the latest is used.
 
+Owners takes a query string list of AWS account ID, self (owner is the sender of the request), or an AWS owner alias (valid values are amazon | aws-marketplace | microsoft). Omitting this option defaults to self
+
 ```bash
 ${ami://amzn-ami-hv*x86_64-gp2?owner=amazon}
 ${ami://my-windows-soe}
+${ami://my-windows-soe?owner=1234567890,self}
 ```
 
 ## Overriding Stack Parameters from the Command Line
@@ -334,7 +353,8 @@ If this is of interest to you, please have a look at the [GitHub issue](https://
 
 
 ## Related Projects
-The following projects provided inspiration for Bora:
+The following projects provided inspiration for or are similar to Bora.
+If Bora doesn't meet your needs, one of these might.
 * [CfnDsl](https://github.com/stevenjack/cfndsl) - A Ruby DSL for CloudFormation templates
 * [StackMaster](https://github.com/envato/stack_master) - Very similar in goals to Bora
 * [CloudFormer](https://github.com/kunday/cloudformer) - Rake tasks for CloudFormation

data/bora.gemspec

@@ -26,6 +26,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "thor", "~> 0.19"
 
   spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "hashie", "~> 3.4.6"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "simplecov", "~> 0.12"
 end

data/lib/bora/cfn/change.rb

@@ -0,0 +1,17 @@
+require "bora/cfn/change_set_action"
+
+class Bora
+  module Cfn
+    class Change
+      def initialize(change)
+        @change = change
+        @resource_change = @change.resource_change
+        @action = ChangeSetAction.new(@resource_change.action, @resource_change.replacement)
+      end
+
+      def to_s
+        "#{@action} - #{@resource_change.resource_type} - #{@resource_change.logical_resource_id}"
+      end
+    end
+  end
+end

data/lib/bora/cfn/change_set.rb

@@ -0,0 +1,45 @@
+require "bora/cfn/change"
+require "bora/cfn/status"
+
+class Bora
+  module Cfn
+    class ChangeSet
+      def initialize(change_set, is_summary = false)
+        @change_set = change_set
+        @is_summary = is_summary
+        @status = Status.new(@change_set.status)
+        @execution_status = Status.new(@change_set.execution_status)
+        @changes = @is_summary ? [] : change_set.changes.map { |c| Change.new(c) }
+      end
+
+      def status_success?
+        @status.success?
+      end
+
+      def status_failure?
+        @status.failure?
+      end
+
+      def status_complete?
+        status_success? || status_failure?
+      end
+
+      def has_changes?
+        @status.success? && @changes.size > 0
+      end
+
+      def to_s(changes_only: false)
+        reason = @change_set.status_reason ? " (#{@change_set.status_reason})" : ""
+        description = @change_set.description ? " - #{@change_set.description}" : ""
+        changes_str = !@is_summary ? @changes.map(&:to_s).join("\n") : ""
+        if changes_only
+          s = changes_str
+        else
+          s = "#{@change_set.change_set_name.bold} - #{@change_set.creation_time.getlocal} - #{@status}#{reason} - #{@execution_status}#{description}"
+          s += "\n#{changes_str}" if !changes_str.empty?
+        end
+        s
+      end
+    end
+  end
+end

data/lib/bora/cfn/change_set_action.rb

@@ -0,0 +1,36 @@
+require 'colorize'
+
+class Bora
+  module Cfn
+    class ChangeSetAction
+      def initialize(action, replacement)
+        @action = action
+        @replacement = replacement
+      end
+
+      def to_s
+        action_str = @action
+        if @action == "Modify"
+          action_str = case @replacement
+            when "True" then "Replace"
+            when "Conditional" then "Replace (conditional)"
+            else action_str
+          end
+        end
+        action_str.colorize(color)
+      end
+
+
+      private
+
+      def color
+        case @action
+          when "Add" then :green
+          when "Remove" then :red
+          else :yellow
+        end
+      end
+    end
+
+  end
+end

data/lib/bora/cfn/stack.rb

@@ -2,6 +2,7 @@ require 'set'
 require 'open-uri'
 require 'aws-sdk'
 require 'bora/cfn/stack_status'
+require 'bora/cfn/change_set'
 require 'bora/cfn/event'
 require 'bora/cfn/output'
 require 'bora/cfn/parameter'
@@ -19,11 +20,11 @@ class Bora
       end
 
       def create(options, &block)
-        call_cfn_action(:create, options, &block)
+        call_cfn_action(:create_stack, options, &block)
       end
 
       def update(options, &block)
-        call_cfn_action(:update, options, &block)
+        call_cfn_action(:update_stack, options, &block)
       end
 
       def create_or_update(options, &block)
@@ -36,7 +37,7 @@ class Bora
       end
 
       def delete(&block)
-        call_cfn_action(:delete, &block)
+        call_cfn_action(:delete_stack, &block)
       end
 
       def events
@@ -72,6 +73,36 @@ class Bora
         status.exists?
       end
 
+      def create_change_set(change_set_name, options)
+        change_set_options = {
+          stack_name: @stack_name,
+          change_set_name: change_set_name
+        }
+        cloudformation.create_change_set(change_set_options.merge(options))
+        begin
+          change_set = ChangeSet.new(cloudformation.describe_change_set(change_set_options))
+          sleep 5 unless change_set.status_complete?
+        end until change_set.status_complete?
+        change_set
+      end
+
+      def list_change_sets
+        cfn_change_sets = cloudformation.list_change_sets(stack_name: @stack_name)
+        cfn_change_sets.summaries.map { |cs| ChangeSet.new(cs, true) }
+      end
+
+      def describe_change_set(change_set_name)
+        ChangeSet.new(cloudformation.describe_change_set(stack_name: @stack_name, change_set_name: change_set_name))
+      end
+
+      def delete_change_set(change_set_name)
+        cloudformation.delete_change_set(stack_name: @stack_name, change_set_name: change_set_name)
+      end
+
+      def execute_change_set(change_set_name, &block)
+        call_cfn_action(:execute_change_set, {change_set_name: change_set_name}, &block)
+      end
+
 
       # =============================================================================================
       private
@@ -82,23 +113,19 @@ class Bora
         end
       end
 
-      def method_missing(sym, *args, &block)
-        underlying_stack ? underlying_stack.send(sym, *args, &block) : nil
-      end
-
       def call_cfn_action(action, options = {}, &block)
         underlying_stack(refresh: true)
-        return true if action == :delete && !exists?
+        return true if action == :delete_stack && !exists?
         @previous_event_time = last_event_time
         begin
           action_options = {stack_name: @stack_name}.merge(options)
-          cloudformation.method("#{action.to_s.downcase}_stack").call(action_options)
+          cloudformation.method(action.to_s.downcase).call(action_options)
           wait_for_completion(&block)
         rescue Aws::CloudFormation::Errors::ValidationError => e
           raise e unless e.message.include?(NO_UPDATE_MESSAGE)
           return nil
         end
-        (action == :delete && !underlying_stack) || status.success?
+        (action == :delete_stack && !underlying_stack) || status.success?
       end
 
       def wait_for_completion
@@ -140,7 +167,9 @@ class Bora
         events = cloudformation.describe_stack_events({stack_name: @stack_name}).stack_events
         events.length > 0 ? events[0].timestamp : Time.at(0)
       end
+
     end
 
+
   end
 end

data/lib/bora/cfn/status.rb

@@ -12,7 +12,7 @@ class Bora
       end
 
       def failure?
-        @status.end_with?("_FAILED") || @status.include?("ROLLBACK")
+        @status.end_with?("FAILED") || @status.include?("ROLLBACK")
       end
 
       def deleted?

data/lib/bora/cli.rb

@@ -1,8 +1,11 @@
 require "thor"
 require "bora"
+require "bora/cli_base"
+require "bora/cli_change_set"
 
 class Bora
-  class Cli < Thor
+  class Cli < CliBase
+
     class_option :file,
       type: :string,
       aliases: :f,
@@ -91,33 +94,8 @@ class Bora
       stack(options.file, stack_name).validate(params)
     end
 
-
-    private
-
-    def stack(config_file, stack_name)
-      region = options.region
-      cfn_stack_name = options["cfn-stack-name"]
-
-      override_config = {}
-      override_config["default_region"] = region if region
-      override_config["cfn_stack_name"] = cfn_stack_name if cfn_stack_name
-
-      bora = bora(config_file, override_config)
-      stack = bora.stack(stack_name)
-      if !stack
-        STDERR.puts "Could not find stack #{stack_name}"
-        exit(1)
-      end
-      stack
-    end
-
-    def bora(config_file, override_config = {})
-      Bora.new(config_file_or_hash: config_file, override_config: override_config)
-    end
-
-    def params
-      options.params ? Hash[options.params.map { |param| param.split("=", 2) }] : {}
-    end
+    desc "changeset SUBCOMMAND ...ARGS", "Manage CloudFormation change sets"
+    subcommand "changeset", CliChangeSet
 
   end
 end

data/lib/bora/cli_base.rb

@@ -0,0 +1,43 @@
+require "thor"
+
+class Bora
+  class CliBase < Thor
+    # Fix for incorrect subcommand help. See https://github.com/erikhuda/thor/issues/261
+    def self.banner(command, namespace = nil, subcommand = false)
+      subcommand = subcommand_prefix
+      subcommand_str = subcommand ? " #{subcommand}" : ""
+      "#{basename}#{subcommand_str} #{command.usage}"
+    end
+
+    def self.subcommand_prefix
+      nil
+    end
+
+    no_commands do
+      def stack(config_file, stack_name)
+        region = options.region
+        cfn_stack_name = options["cfn-stack-name"]
+
+        override_config = {}
+        override_config["default_region"] = region if region
+        override_config["cfn_stack_name"] = cfn_stack_name if cfn_stack_name
+
+        bora = bora(config_file, override_config)
+        stack = bora.stack(stack_name)
+        if !stack
+          STDERR.puts "Could not find stack #{stack_name}"
+          exit(1)
+        end
+        stack
+      end
+
+      def bora(config_file, override_config = {})
+        Bora.new(config_file_or_hash: config_file, override_config: override_config)
+      end
+
+      def params
+        options.params ? Hash[options.params.map { |param| param.split("=", 2) }] : {}
+      end
+    end
+  end
+end

data/lib/bora/cli_change_set.rb

@@ -0,0 +1,40 @@
+require "thor"
+require 'thor/group'
+
+class Bora
+  class CliChangeSet < CliBase
+    # Fix for incorrect subcommand help. See https://github.com/erikhuda/thor/issues/261
+    def self.subcommand_prefix
+      "changeset"
+    end
+
+    desc "create STACK_NAME CHANGE_SET_NAME", "Creates a change set"
+    option :params, type: :array, aliases: :p, desc: "Parameters to be passed to the template, eg: --params 'instance_type=t2.micro'"
+    option :description, type: :string, aliases: :d, desc: "A description for this change set"
+    option :pretty, type: :boolean, default: false, desc: "Send pretty (formatted) JSON to AWS (only works for cfndsl templates)"
+    def create(stack_name, change_set_name)
+      stack(options.file, stack_name).create_change_set(change_set_name, options.description, params, options.pretty)
+    end
+
+    desc "list STACK_NAME", "Lists all change sets for stack STACK_NAME"
+    def list(stack_name)
+      stack(options.file, stack_name).list_change_sets
+    end
+
+    desc "show STACK_NAME CHANGE_SET_NAME", "Shows the details of the named change set"
+    def show(stack_name, change_set_name)
+      stack(options.file, stack_name).describe_change_set(change_set_name)
+    end
+
+    desc "delete STACK_NAME CHANGE_SET_NAME", "Deletes the named change set"
+    def delete(stack_name, change_set_name)
+      stack(options.file, stack_name).delete_change_set(change_set_name)
+    end
+
+    desc "apply STACK_NAME CHANGE_SET_NAME", "Executes the named change set"
+    def apply(stack_name, change_set_name)
+      stack(options.file, stack_name).execute_change_set(change_set_name)
+    end
+
+  end
+end

data/lib/bora/resolver/ami.rb

@@ -1,38 +1,45 @@
 require 'bora/cfn/stack'
-
 class Bora
   module Resolver
     class Ami
       NoAMI = Class.new(StandardError)
       InvalidParameter = Class.new(StandardError)
+      InvalidUserId = Class.new(StandardError)
 
       def initialize(stack)
         @stack = stack
       end
 
       def resolve(uri)
-        owner = 'self' # Default to account owner
+        owners = []
         ami_prefix = uri.host
         raise InvalidParameter, "Invalid ami parameter #{uri}" unless ami_prefix
         if !uri.query.nil? && uri.query.include?('owner')
           query = URI.decode_www_form(uri.query).to_h
-          owner = query['owner']
+          owners = query['owner'].split(',')
+        else
+          owners << 'self'
         end
 
+
         ec2 = Aws::EC2::Client.new(region: @stack.region)
-        images = ec2.describe_images(
-          owners: [owner],
-          filters: [
-            {
-              name:   'name',
-              values: [ami_prefix]
-            },
-            {
-              name:   'state',
-              values: ['available']
-            }
-          ]
-        ).images
+        begin
+          images = ec2.describe_images(
+            owners: owners,
+            filters: [
+              {
+                name:   'name',
+                values: [ami_prefix]
+              },
+              {
+                name:   'state',
+                values: ['available']
+              }
+            ]
+          ).images
+        rescue Aws::EC2::Errors::InvalidUserIDMalformed
+          raise InvalidUserId, "Invalid owner argument in #{uri}"
+        end
 
         raise NoAMI, "No Matching AMI's for prefix #{ami_prefix}" if images.empty?
         images.sort! { |a, b| DateTime.parse(a.creation_date) <=> DateTime.parse(b.creation_date) }.last.image_id

data/lib/bora/stack.rb

@@ -1,3 +1,4 @@
+require 'securerandom'
 require 'tempfile'
 require 'colorize'
 require 'cfndsl'
@@ -19,6 +20,7 @@ class Bora
     STACK_VALIDATE_SUCCESS_MESSAGE = "Template for stack '%s' is valid"
     STACK_DIFF_TEMPLATE_UNCHANGED_MESSAGE = "Template has not changed"
     STACK_DIFF_PARAMETERS_UNCHANGED_MESSAGE = "Parameters have not changed"
+    STACK_DIFF_NO_CHANGES_MESSAGE = "No changes will be applied"
 
     def initialize(stack_name, template_file, stack_config)
       @stack_name = stack_name
@@ -41,7 +43,8 @@ class Bora
 
     def apply(override_params = {}, pretty_json = false)
       cfn_options = generate(override_params, pretty_json)
-      success = invoke_action(@cfn_stack.exists? ? "update" : "create", cfn_options)
+      action = @cfn_stack.exists? ? "update" : "create"
+      success = invoke_action(action.capitalize, action, cfn_options)
       if success
         outputs = @cfn_stack.outputs
         if outputs && outputs.length > 0
@@ -53,13 +56,14 @@ class Bora
     end
 
     def delete
-      invoke_action("delete")
+      invoke_action("Delete", "delete")
     end
 
     def diff(override_params = {}, context_lines = 3)
       cfn_options = generate(override_params)
       diff_parameters(cfn_options)
-      diff_template(override_params, context_lines, cfn_options)
+      diff_template(context_lines, cfn_options)
+      diff_change_set(cfn_options)
     end
 
     def events
@@ -109,7 +113,7 @@ class Bora
 
     def recreate(override_params = {})
       cfn_options = generate(override_params)
-      invoke_action("recreate", cfn_options)
+      invoke_action("Recreate", "recreate", cfn_options)
     end
 
     def show(override_params = {})
@@ -133,6 +137,32 @@ class Bora
       is_valid
     end
 
+    def create_change_set(change_set_name, description = nil, override_params = {}, pretty_json = false)
+      puts "Creating change set '#{change_set_name}' for stack '#{@cfn_stack_name}' in region #{@region}"
+      cfn_options = generate(override_params, pretty_json)
+      cfn_options[:description] = description if description
+      change_set = @cfn_stack.create_change_set(change_set_name, cfn_options)
+      puts change_set
+      change_set
+    end
+
+    def list_change_sets
+      puts @cfn_stack.list_change_sets.map(&:to_s).join("\n")
+    end
+
+    def describe_change_set(change_set_name)
+      puts @cfn_stack.describe_change_set(change_set_name)
+    end
+
+    def delete_change_set(change_set_name)
+      @cfn_stack.delete_change_set(change_set_name)
+      puts "Deleted change set '#{change_set_name}' for stack '#{@cfn_stack_name}' in region #{@region}"
+    end
+
+    def execute_change_set(change_set_name)
+      invoke_action("Execute change set '#{change_set_name}'", "execute_change_set", change_set_name)
+    end
+
     def resolved_params(override_params = {})
       params = @stack_config['params'] || {}
       params.merge!(override_params)
@@ -192,7 +222,7 @@ class Bora
       params
     end
 
-    def diff_template(override_params, context_lines, cfn_options)
+    def diff_template(context_lines, cfn_options)
       diff = Diffy::Diff.new(get_current_template, get_new_template(cfn_options),
               context: context_lines,
               include_diff_info: true)
@@ -217,6 +247,24 @@ class Bora
       puts
     end
 
+    def diff_change_set(cfn_options)
+      change_set_name = "cs-#{SecureRandom.uuid}"
+      if @cfn_stack.exists?
+        change_set = @cfn_stack.create_change_set(change_set_name, cfn_options)
+        @cfn_stack.delete_change_set(change_set_name)
+        if change_set.has_changes?
+          puts "Changes".colorize(mode: :bold)
+          puts "-------"
+          puts change_set.to_s(changes_only: true)
+          puts
+        else
+          puts "Changes".colorize(mode: :bold)
+          puts "-------"
+          puts STACK_DIFF_NO_CHANGES_MESSAGE
+        end
+      end
+    end
+
     def generate(override_params = {}, pretty_json = false)
       cfn_options = cfn_options_from_stack_config
       params = resolved_params(override_params)
@@ -242,16 +290,16 @@ class Bora
       cfn_options
     end
 
-    def invoke_action(action, *args)
-      puts "#{action.capitalize} stack '#{@cfn_stack_name}' in region #{@region}"
+    def invoke_action(action_desc, action, *args)
+      puts "#{action_desc} stack '#{@cfn_stack_name}' in region #{@region}"
       success = @cfn_stack.send(action, *args) { |event| puts event }
       if success
-        puts STACK_ACTION_SUCCESS_MESSAGE % [action.capitalize, @cfn_stack_name]
+        puts STACK_ACTION_SUCCESS_MESSAGE % [action_desc, @cfn_stack_name]
       else
         if success == nil
-          puts STACK_ACTION_NOT_CHANGED_MESSAGE % [action.capitalize, @cfn_stack_name]
+          puts STACK_ACTION_NOT_CHANGED_MESSAGE % [action_desc, @cfn_stack_name]
         else
-          raise(STACK_ACTION_FAILURE_MESSAGE % [action.capitalize, @cfn_stack_name])
+          raise(STACK_ACTION_FAILURE_MESSAGE % [action_desc, @cfn_stack_name])
         end
       end
       success

data/lib/bora/version.rb

@@ -1,3 +1,3 @@
 class Bora
-  VERSION = "1.4.1"
+  VERSION = "1.5.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bora
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.5.0
 platform: ruby
 authors:
 - Charles Blaxland
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-11-02 00:00:00.000000000 Z
+date: 2016-11-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk
@@ -108,6 +108,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.6
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -156,6 +170,9 @@ files:
 - bora.gemspec
 - exe/bora
 - lib/bora.rb
+- lib/bora/cfn/change.rb
+- lib/bora/cfn/change_set.rb
+- lib/bora/cfn/change_set_action.rb
 - lib/bora/cfn/event.rb
 - lib/bora/cfn/output.rb
 - lib/bora/cfn/parameter.rb
@@ -163,6 +180,8 @@ files:
 - lib/bora/cfn/stack_status.rb
 - lib/bora/cfn/status.rb
 - lib/bora/cli.rb
+- lib/bora/cli_base.rb
+- lib/bora/cli_change_set.rb
 - lib/bora/parameter_resolver.rb
 - lib/bora/parameter_resolver_loader.rb
 - lib/bora/resolver/ami.rb