moonshot 0.7.7 → 1.0.0.rc1

data/lib/moonshot/commands/build.rb

@@ -0,0 +1,12 @@
+module Moonshot
+  module Commands
+    class Build < Moonshot::Command
+      self.usage = 'build VERSION'
+      self.description = 'Build a release artifact, ready for deployment'
+
+      def execute(version_name)
+        controller.build_version(version_name)
+      end
+    end
+  end
+end

data/lib/moonshot/commands/console.rb

@@ -0,0 +1,19 @@
+module Moonshot
+  module Commands
+    class Console < Moonshot::Command
+      self.usage = 'console [options]'
+      self.description = 'Launch a interactive Ruby console with configured access to AWS'
+
+      def execute
+        controller
+
+        ec2 = Aws::EC2::Client.new
+        iam = Aws::IAM::Client.new
+        autoscaling = Aws::AutoScaling::Client.new
+        cf = Aws::CloudFormation::Client.new
+
+        Pry.start binding, backtrace: nil
+      end
+    end
+  end
+end

data/lib/moonshot/commands/create.rb

@@ -0,0 +1,37 @@
+require_relative 'parameter_arguments'
+
+module Moonshot
+  module Commands
+    class Create < Moonshot::Command
+      include ParameterArguments
+
+      self.usage = 'create [options]'
+      self.description = 'Create a new environment'
+
+      attr_reader :version, :deploy
+
+      def parser
+        @deploy = true
+
+        parser = super
+        parser.on('-d', '--[no-]deploy', TrueClass, 'Choose if code should be deployed immediately after the stack is created') do |v| # rubocop:disable LineLength
+          @deploy = v
+        end
+
+        parser.on('--version VERSION_NAME', 'Version for initial deployment. If unset, a new development build is created from the local directory') do |v| # rubocop:disable LineLength
+          @version = v
+        end
+      end
+
+      def execute
+        controller.create
+
+        if @deploy && @version.nil?
+          controller.push
+        elsif @deploy
+          controller.deploy_version(@version)
+        end
+      end
+    end
+  end
+end

data/lib/moonshot/commands/delete.rb

@@ -0,0 +1,12 @@
+module Moonshot
+  module Commands
+    class Delete < Moonshot::Command
+      self.usage = 'delete [options]'
+      self.description = 'Delete an existing environment'
+
+      def execute
+        controller.delete
+      end
+    end
+  end
+end

data/lib/moonshot/commands/deploy.rb

@@ -0,0 +1,12 @@
+module Moonshot
+  module Commands
+    class Deploy < Moonshot::Command
+      self.usage = 'deploy VERSION'
+      self.description = 'Deploy a versioned release to the environment'
+
+      def execute(version_name)
+        controller.deploy_version(version_name)
+      end
+    end
+  end
+end

data/lib/moonshot/commands/doctor.rb

@@ -0,0 +1,12 @@
+module Moonshot
+  module Commands
+    class Doctor < Moonshot::Command
+      self.usage = 'doctor [options]'
+      self.description = 'Run configuration checks against the local environment'
+
+      def execute
+        controller.doctor || raise('One or more checks failed.')
+      end
+    end
+  end
+end

data/lib/moonshot/commands/list.rb

@@ -0,0 +1,16 @@
+require_relative '../stack_lister'
+require_relative '../stack_list_printer'
+
+module Moonshot
+  module Commands
+    class List < Moonshot::Command
+      self.usage = 'list [options]'
+      self.description = 'List stacks for this application'
+
+      def execute
+        stacks = StackLister.new(controller.config.app_name).list
+        StackListPrinter.new(stacks).print
+      end
+    end
+  end
+end

data/lib/moonshot/commands/new.rb

@@ -0,0 +1,99 @@
+module Moonshot
+  module Commands
+    class New < Moonshot::Command
+      self.usage = 'new [options]'
+      self.description = 'Creates a new Moonshot project.'
+
+      DEFAULT_DIRECTORY = File.join(__dir__, '..', '..', 'default').freeze
+
+      def execute
+        warn 'Looks like your project is already set up!'
+      end
+
+      class << self
+        def run!(application_name)
+          @application_name = application_name
+
+          create_project_dir
+          copy_defaults
+          create_file(parameter_path)
+          create_file(template_path)
+          fill_moonfile
+          print_success_message
+        end
+
+        private
+
+        def cwd
+          Dir.pwd
+        end
+
+        def create_project_dir
+          raise "Directory '#{@application_name}' already exists!" \
+            if Dir.exist?(project_path)
+          Dir.mkdir(project_path)
+        end
+
+        def project_path
+          @project_path ||= File.join(cwd, @application_name)
+        end
+
+        def copy_defaults
+          target_path = File.join(DEFAULT_DIRECTORY.dup, '.')
+          FileUtils.cp_r(target_path, project_path)
+        end
+
+        def create_file(path)
+          FileUtils.touch(path)
+        end
+
+        def moonfile_path
+          File.join(project_path, 'Moonfile.rb')
+        end
+
+        def parameter_path
+          File.join(cf_dir, 'parameters', "#{@application_name}.yml")
+        end
+
+        def template_path
+          File.join(cf_dir, "#{@application_name}.json")
+        end
+
+        def cf_dir
+          File.join(project_path, 'cloud_formation')
+        end
+
+        def fill_moonfile
+          File.open(moonfile_path, 'w') { |f| f.write generate_moonfile }
+        end
+
+        def generate_moonfile
+          <<-EOF
+            Moonshot.config do |m|
+              m.app_name = '#{@application_name}'
+              m.artifact_repository = S3Bucket.new('<your_bucket>')
+              m.build_mechanism = Script.new('bin/build.sh')
+              m.deployment_mechanism = CodeDeploy.new(asg: 'AutoScalingGroup')
+            end
+        	EOF
+        end
+
+        def print_success_message
+          warn 'Your application is configured, the following changes have '\
+               'been made to your project directory:'
+          warn ''
+          warn '- Created a Moonfile.rb where you can configure your project.'
+          warn '- Created moonshot/plugins where you can add hooks to core '\
+               'Moonshot actions.'
+          warn '- Created moonshot/cli_extensions where you can create '\
+               'project-specific commands.'
+          warn ''
+          warn 'You will also need to ensure your Amazon account is configured'\
+               ' for CodeDeploy, by creating a role that allows deployments. '\
+               'See: http://moonshot.readthedocs.io/en/latest/mechanisms/'\
+               'deployment/'
+        end
+      end
+    end
+  end
+end

data/lib/moonshot/commands/parameter_arguments.rb

@@ -0,0 +1,27 @@
+# rubocop:disable LineLength
+module Moonshot
+  module Commands
+    module ParameterArguments
+      def parser
+        parser = super
+
+        parser.on('--[no-]interactive', TrueClass, 'Use interactive prompts for gathering missing configuration.') do |v|
+          Moonshot.config.interactive = v
+        end
+
+        parser.on('--answer-file FILE', '-aFILE', 'Load Stack Parameters from a YAML file') do |v|
+          Moonshot.config.answer_file = File.expand_path(v)
+        end
+
+        parser.on('--parameter KEY=VALUE', '-PKEY=VALUE', 'Specify Stack Parameter on the command line') do |v|
+          data = v.split('=', 2)
+          unless data.size == 2
+            raise "Invalid parameter format '#{v}', expected KEY=VALUE (e.g. MyStackParameter=12)"
+          end
+
+          Moonshot.config.parameter_overrides[data[0]] = data[1]
+        end
+      end
+    end
+  end
+end

data/lib/moonshot/commands/push.rb

@@ -0,0 +1,12 @@
+module Moonshot
+  module Commands
+    class Push < Moonshot::Command
+      self.usage = 'push [options]'
+      self.description = 'Build and deploy a development artifact from the working directory'
+
+      def execute
+        controller.push
+      end
+    end
+  end
+end

data/lib/moonshot/commands/ssh.rb

@@ -0,0 +1,12 @@
+module Moonshot
+  module Commands
+    class Ssh < Moonshot::SSHCommand
+      self.usage = 'ssh [options]'
+      self.description = 'SSH into the first (or specified) instance on the stack'
+
+      def execute
+        controller.ssh
+      end
+    end
+  end
+end

data/lib/moonshot/commands/status.rb

@@ -0,0 +1,12 @@
+module Moonshot
+  module Commands
+    class Status < Moonshot::Command
+      self.usage = 'status [options]'
+      self.description = 'Show the status of an existing environment'
+
+      def execute
+        controller.status
+      end
+    end
+  end
+end

data/lib/moonshot/commands/update.rb

@@ -0,0 +1,29 @@
+require_relative 'parameter_arguments'
+
+module Moonshot
+  module Commands
+    class Update < Moonshot::Command
+      include ParameterArguments
+
+      self.usage = 'update [options]'
+      self.description = 'Update the CloudFormation stack within an environment.'
+
+      def execute
+        controller.update
+      end
+
+      private
+
+      def parameter_strategy_factory(value)
+        case value.to_sym
+        when :default
+          Moonshot::ParameterStrategy::DefaultStrategy.new
+        when :merge
+          Moonshot::ParameterStrategy::MergeStrategy.new
+        else
+          raise "Unknown parameter strategy: #{value}"
+        end
+      end
+    end
+  end
+end

data/lib/moonshot/commands/version.rb

@@ -0,0 +1,12 @@
+module Moonshot
+  module Commands
+    class Version < Moonshot::Command
+      self.usage = 'version'
+      self.description = 'Display the version of Moonshot'
+
+      def execute
+        puts Gem.loaded_specs['moonshot'].version
+      end
+    end
+  end
+end

data/lib/moonshot/controller.rb

@@ -1,10 +1,14 @@
 require_relative 'ssh_target_selector'
 require_relative 'ssh_command_builder'
 
+require_relative 'stack_parameter'
+require_relative 'parameter_collection'
+require_relative 'parent_stack_parameter_loader'
+
 module Moonshot
   # The Controller coordinates and performs all Moonshot actions.
   class Controller # rubocop:disable ClassLength
-    attr_reader :config
+    attr_accessor :config
 
     def initialize
       @config = ControllerConfig.new
@@ -12,22 +16,108 @@ module Moonshot
     end
 
     def list
-      Moonshot::StackLister.new(
-        @config.app_name, log: @config.logger).list
+      Moonshot::StackLister.new(@config.app_name).list
     end
 
-    def create
+    def create # rubocop:disable AbcSize
+      # Scan the template for all required parameters and configure
+      # the ParameterCollection.
+      @config.parameters = ParameterCollection.from_template(stack.template)
+
+      # Import all Outputs from parent stacks as Parameters on this
+      # stack.
+      ParentStackParameterLoader.new(@config).load!
+
+      # If there is an answer file, use it to populate parameters.
+      if @config.answer_file
+        YAML.load_file(@config.answer_file).each do |key, value|
+          @config.parameters[key] = value
+        end
+      end
+
+      # Apply any overrides configured, such as from the CLI -p option.
+      @config.parameter_overrides.each do |key, value|
+        @config.parameters[key] = value
+      end
+
+      # Interview the user for missing parameters, using the
+      # appropriate prompts.
+      @config.parameters.values.each do |sp|
+        next if sp.set?
+
+        parameter_source = @config.parameter_sources.fetch(sp.name,
+                                                           @config.default_parameter_source)
+        parameter_source.get(sp)
+      end
+
+      # Plugins get the final say on parameters before create,
+      # allowing them to manipulate user supplied input and answers
+      # file content.
       run_plugins(:pre_create)
+
+      # Fail if any parameters are still missing without defaults.
+      missing_parameters = @config.parameters.missing_for_create
+      unless missing_parameters.empty?
+        raise "The following parameters were not provided: #{missing_parameters.map(&:name).join(', ')}" # rubocop:disable LineLength
+      end
+
       run_hook(:deploy, :pre_create)
       stack_ok = stack.create
       if stack_ok # rubocop:disable GuardClause
         run_hook(:deploy, :post_create)
         run_plugins(:post_create)
+      else
+        raise 'Stack creation failed!'
       end
     end
 
-    def update
+    def update # rubocop:disable AbcSize
+      # Scan the template for all required parameters and configure
+      # the ParameterCollection.
+      @config.parameters = ParameterCollection.from_template(stack.template)
+
+      # Set all values already provided by the stack to UsePreviousValue.
+      stack.parameters.each do |key, value|
+        @config.parameters[key].use_previous!(value) if @config.parameters.key?(key)
+      end
+
+      # Import all Outputs from parent stacks as Parameters on this
+      # stack.
+      ParentStackParameterLoader.new(@config).load_missing_only!
+
+      # If there is an answer file, use it to populate parameters.
+      if @config.answer_file
+        YAML.load_file(@config.answer_file).each do |key, value|
+          @config.parameters[key] = value
+        end
+      end
+
+      # Apply any overrides configured, such as from the CLI -p option.
+      @config.parameter_overrides.each do |key, value|
+        @config.parameters[key] = value
+      end
+
+      # Interview the user for missing parameters, using the
+      # appropriate prompts.
+      @config.parameters.values.each do |sp|
+        next if sp.set?
+
+        parameter_source = @config.parameter_sources.fetch(sp.name,
+                                                           @config.default_parameter_source)
+        parameter_source.get(sp)
+      end
+
+      # Plugins get the final say on parameters before create,
+      # allowing them to manipulate user supplied input and answers
+      # file content.
       run_plugins(:pre_update)
+
+      # Fail if any parameters are still missing without defaults.
+      missing_parameters = @config.parameters.missing_for_update
+      unless missing_parameters.empty?
+        raise "The following parameters were not provided: #{missing_parameters.map(&:name).join(', ')}" # rubocop:disable LineLength
+      end
+
       run_hook(:deploy, :pre_update)
       stack.update
       run_hook(:deploy, :post_update)
@@ -41,8 +131,8 @@ module Moonshot
       run_plugins(:post_status)
     end
 
-    def deploy_code
-      version = "#{stack_name}-#{Time.now.to_i}"
+    def push
+      version = @config.dev_build_name_proc.call(@config)
       build_version(version)
       deploy_version(version)
     end
@@ -63,6 +153,12 @@ module Moonshot
     end
 
     def delete
+      # Populate the current values of parameters, for use by plugins.
+      @config.parameters = ParameterCollection.from_template(stack.template)
+      stack.parameters.each do |key, value|
+        @config.parameters[key].use_previous!(value) if @config.parameters.key?(key)
+      end
+
       run_plugins(:pre_delete)
       run_hook(:deploy, :pre_delete)
       stack.delete
@@ -71,7 +167,6 @@ module Moonshot
     end
 
     def doctor
-      # @todo use #run_hook when Stack becomes an InfrastructureProvider
       success = true
       success &&= stack.doctor_hook
       success &&= run_hook(:build, :doctor)
@@ -90,56 +185,25 @@ module Moonshot
       cb = SSHCommandBuilder.new(@config.ssh_config, @config.ssh_instance)
       result = cb.build(@config.ssh_command)
 
-      puts "Opening SSH connection to #{@config.ssh_instance} (#{result.ip})..."
+      warn "Opening SSH connection to #{@config.ssh_instance} (#{result.ip})..."
       exec(result.cmd)
     end
 
     def stack
-      @stack ||= Stack.new(stack_name,
-                           app_name: @config.app_name,
-                           log: @config.logger,
-                           ilog: @config.interactive_logger) do |config|
-        config.parent_stacks = @config.parent_stacks
-        config.show_all_events = @config.show_all_stack_events
-        config.parameter_strategy = @config.parameter_strategy
-      end
+      @stack ||= Stack.new(@config)
     end
 
     private
 
-    def default_stack_name
-      user = ENV.fetch('USER').gsub(/\W/, '')
-      "#{@config.app_name}-dev-#{user}"
-    end
-
-    def ensure_prefix(name)
-      if name.start_with?(@config.app_name + '-')
-        name
-      else
-        @config.app_name + "-#{name}"
-      end
-    end
-
-    def stack_name
-      name = @config.environment_name || default_stack_name
-      if @config.auto_prefix_stack == false
-        name
-      else
-        ensure_prefix(name)
-      end
-    end
-
     def resources
       @resources ||=
-        Resources.new(stack: stack, log: @config.logger,
-                      ilog: @config.interactive_logger)
+        Resources.new(stack: stack, ilog: @config.interactive_logger, controller: self)
     end
 
     def run_hook(type, name, *args)
       mech = get_mechanism(type)
       name = name.to_s << '_hook'
 
-      @config.logger.debug("Calling hook=#{name} on mech=#{mech.class}")
       return unless mech && mech.respond_to?(name)
 
       mech.resources = resources