Hello World
"); 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /sample/bin/aws-codedeploy-samples/conf-mgmt/puppet/masterless/src/main/java/com/amazonaws/sample/HelloServlet.java: -------------------------------------------------------------------------------- 1 | package com.amazonaws.sample; 2 | 3 | import javax.servlet.http.HttpServlet; 4 | import javax.servlet.ServletException; 5 | import javax.servlet.http.HttpServletRequest; 6 | import javax.servlet.http.HttpServletResponse; 7 | 8 | import java.io.IOException; 9 | import java.io.PrintWriter; 10 | 11 | public class HelloServlet extends HttpServlet { 12 | 13 | protected void doGet(HttpServletRequest request, 14 | HttpServletResponse response) 15 | throws ServletException, IOException 16 | { 17 | PrintWriter writer = response.getWriter(); 18 | writer.print("Hello World
"); 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /lib/moonshot/stack_template.rb: -------------------------------------------------------------------------------- 1 | # frozen_string_literal: true 2 | 3 | module Moonshot 4 | # A StackTemplate loads the template from disk and stores information 5 | # about it. 6 | class StackTemplate 7 | attr_reader :filename 8 | 9 | def initialize(filename) 10 | @filename = filename 11 | end 12 | 13 | def parameters 14 | template_body.fetch('Parameters', {}).map do |k, v| 15 | StackParameter.new(k, 16 | default: v['Default'], 17 | description: v.fetch('Description', '')) 18 | end 19 | end 20 | 21 | def resource_names 22 | template_body.fetch('Resources', {}).keys 23 | end 24 | 25 | def exist? 26 | File.exist?(@filename) 27 | end 28 | end 29 | end 30 | -------------------------------------------------------------------------------- /sample/bin/aws-codedeploy-samples/conf-mgmt/chef/solo/src/main/webapp/WEB-INF/web.xml: -------------------------------------------------------------------------------- 1 | 2 |
29 |
33 |
34 |
35 |
36 |
--------------------------------------------------------------------------------
/spec/moonshot/commands/build_spec.rb:
--------------------------------------------------------------------------------
1 | describe Moonshot::Commands::Build do
2 |
3 | it 'should raise RuntimeError when send --skip-ci-status param without GithubRelease plugin' do
4 | cli_dispatcher = Moonshot::CommandLineDispatcher.new('build', subject, {})
5 | parser = cli_dispatcher.send(:build_parser, subject)
6 | expect { parser.parse(%w(--skip-ci-status)) }.to raise_error(RuntimeError)
7 | end
8 |
9 | it 'should not raise RuntimeError when send --skip-ci-status param with GithubRelease plugin' do
10 | Moonshot.config = Moonshot::ControllerConfig.new
11 | Moonshot.config do |c|
12 | c.build_mechanism = Moonshot::BuildMechanism::GithubRelease.new('')
13 | end
14 | cli_dispatcher = Moonshot::CommandLineDispatcher.new('build', subject, {})
15 | parser = cli_dispatcher.send(:build_parser, subject)
16 | expect { parser.parse(%w(--skip-ci-status)) }.to_not raise_error
17 | end
18 |
19 | end
20 |
--------------------------------------------------------------------------------
/sample/bin/aws-codedeploy-samples/applications/SampleApp_Windows/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | Congratulations
30 |This application was deployed using AWS CodeDeploy.
31 |For next steps, read the AWS CodeDeploy Documentation.
32 |
32 |
36 |
37 |
38 |
--------------------------------------------------------------------------------
/lib/plugins/encrypted_parameters/parameter_encrypter.rb:
--------------------------------------------------------------------------------
1 | # frozen_string_literal: true
2 |
3 | require 'base64'
4 | module Moonshot
5 | module Plugins
6 | class EncryptedParameters
7 | # Class that can encrypt and decrypt parameters using KMS.
8 | class ParameterEncrypter
9 | # @param [String] key_arn The ARN for the KMS key.
10 | def initialize(key_arn)
11 | @kms_client = Aws::KMS::Client.new
12 | @key_arn = key_arn
13 | end
14 |
15 | # Encrypt and base64 encode the parameter value.
16 | #
17 | # @param [String] param_value The parameter to encrypt.
18 | # @return [String] base64 encoded encrypted ciphertext.
19 | def encrypt(param_value)
20 | resp = @kms_client.encrypt(key_id: @key_arn, plaintext: param_value)
21 |
22 | # Use strict here to avoid newlines which cause issues with parameters.
23 | Base64.strict_encode64(resp.ciphertext_blob)
24 | end
25 | end
26 | end
27 | end
28 | end
29 |
--------------------------------------------------------------------------------
/lib/moonshot/ask_user_source.rb:
--------------------------------------------------------------------------------
1 | # frozen_string_literal: true
2 |
3 | require 'colorize'
4 |
5 | module Moonshot
6 | class AskUserSource
7 | def get(sp)
8 | return unless Moonshot.config.interactive
9 |
10 | @sp = sp
11 |
12 | prompt
13 | loop do
14 | input = gets.chomp
15 |
16 | if String(input).empty? && @sp.default?
17 | # We will use the default value, print it here so the output is clear.
18 | puts 'Using default value.'
19 | return
20 | elsif String(input).empty?
21 | puts "Cannot proceed without value for #{@sp.name}!"
22 | else
23 | @sp.set(String(input))
24 | return
25 | end
26 |
27 | prompt
28 | end
29 | end
30 |
31 | private
32 |
33 | def prompt
34 | print "(#{@sp.name})".light_black
35 | print " #{@sp.description}" unless @sp.description.empty?
36 | print " [#{@sp.default}]".light_black if @sp.default?
37 | print ': '
38 | end
39 | end
40 | end
41 |
--------------------------------------------------------------------------------
/sample/bin/aws-codedeploy-samples/conf-mgmt/ansible/local-only/lamp_simple/roles/db/tasks/main.yml:
--------------------------------------------------------------------------------
1 | ---
2 | # This playbook will install mysql and create db user and give permissions.
3 |
4 | - name: Install Mysql package
5 | yum: name={{ item }} state=installed
6 | with_items:
7 | - mysql-server
8 | - MySQL-python
9 |
10 | - name: Create Mysql configuration file
11 | template: src=my.cnf.j2 dest=/etc/my.cnf
12 | notify:
13 | - restart mysql
14 |
15 | - name: Start Mysql Service
16 | service: name=mysqld state=started enabled=true
17 |
18 | - name: insert iptables rule
19 | lineinfile: dest=/etc/sysconfig/iptables state=present regexp="{{ mysql_port }}"
20 | insertafter="^:OUTPUT " line="-A INPUT -p tcp --dport {{ mysql_port }} -j ACCEPT"
21 | notify: restart iptables
22 |
23 | - name: Create Application Database
24 | mysql_db: name={{ dbname }} state=present
25 |
26 | - name: Create Application DB User
27 | mysql_user: name={{ dbuser }} password={{ upassword }} priv=*.*:ALL host='%' state=present
28 |
--------------------------------------------------------------------------------
/sample/bin/aws-codedeploy-samples/conf-mgmt/ansible/local-only/lamp_simple/roles/common/templates/iptables.j2:
--------------------------------------------------------------------------------
1 | # {{ ansible_managed }}
2 | *filter
3 | :INPUT ACCEPT [0:0]
4 | :FORWARD ACCEPT [0:0]
5 | :OUTPUT ACCEPT [0:0]
6 |
7 | #Syn-flood protection
8 | -A INPUT -p tcp ! --syn -m state --state NEW -j DROP
9 |
10 | #Force SYN packets check
11 | -A INPUT -f -j DROP
12 |
13 | #Force Fragments packets check
14 | -A INPUT -p tcp --tcp-flags ALL ALL -j DROP
15 |
16 | #XMAS packets
17 | -A INPUT -p tcp --tcp-flags ALL NONE -j DROP
18 |
19 | # Accept packets belonging to established and related connections
20 | -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
21 |
22 | # Allow pings
23 | -A INPUT -p icmp --icmp-type any -j ACCEPT
24 |
25 | # Set access for localhost
26 | -A INPUT -i lo -j ACCEPT
27 |
28 | # Allow SSH connections on tcp port 22
29 | -A INPUT -m state --state NEW -m tcp -p tcp --dport 22 -j ACCEPT
30 |
31 | # Set default policies for INPUT, FORWARD and OUTPUT chains
32 | -P INPUT DROP
33 | -P FORWARD DROP
34 | -P OUTPUT ACCEPT
35 |
36 | COMMIT
37 |
--------------------------------------------------------------------------------
/lib/moonshot/commands/parameter_arguments.rb:
--------------------------------------------------------------------------------
1 | # frozen_string_literal: true
2 |
3 | # rubocop:disable Layout/LineLength
4 | module Moonshot
5 | module Commands
6 | module ParameterArguments
7 | def parser
8 | parser = super
9 |
10 | parser.on('--[no-]interactive', TrueClass, 'Use interactive prompts for gathering missing configuration.') do |v|
11 | Moonshot.config.interactive = v
12 | end
13 |
14 | parser.on('--answer-file FILE', '-aFILE', 'Load Stack Parameters from a YAML file') do |v|
15 | Moonshot.config.answer_file = File.expand_path(v)
16 | end
17 |
18 | parser.on('--parameter KEY=VALUE', '-PKEY=VALUE', 'Specify Stack Parameter on the command line') do |v|
19 | data = v.split('=', 2)
20 | raise "Invalid parameter format '#{v}', expected KEY=VALUE (e.g. MyStackParameter=12)" unless data.size == 2
21 |
22 | Moonshot.config.parameter_overrides[data[0]] = data[1]
23 | end
24 | end
25 | end
26 | end
27 | end
28 | # rubocop:enable Layout/LineLength
29 |
--------------------------------------------------------------------------------
/sample/bin/aws-codedeploy-samples/conf-mgmt/chef/solo/pom.xml:
--------------------------------------------------------------------------------
1 | Congratulations
33 |This application was deployed using AWS CodeDeploy.
34 |For next steps, read the AWS CodeDeploy Documentation.
35 |
Moonshot
2 | _Because releasing services shouldn't be a moonshot._
3 |
4 | ## Overview
5 |
6 | Moonshot is a command line tool and library for provisioning and
7 | managing application environments using CloudFormation. It has native
8 | support for integration with S3 and CodeDeploy, as well. Other systems
9 | may be added using our pluggable system. The core components are:
10 |
11 | - A DeploymentMechanism controls releasing code. For example, Amazon
12 | CodeDeploy.
13 | - A BuildMechanism creates a release artifact. For example, a local
14 | shell script.
15 | - A ArtifactRepository stores the release artifacts. For example,
16 | Amazon S3.
17 |
18 | 
19 |
20 | ## Design Goals
21 |
22 | The goal of Moonshot is to wrap CloudFormation in a toolchain that
23 | codifies the deployment and management of a service. Our goal is that
24 | within a given service the Moonshot configuration, CloudFormation
25 | template, and supporting AWS services should be easily understood.
26 |
27 | Some of our original design goals were:
28 |
29 | - Simplicity: It shouldn't take more than a few hours to understand what your
30 | release tooling does.
31 | - Choice: As much as possible, each component should be pluggable and omittable,
32 | so teams are free to use what works best for them.
33 | - Verbosity: The output of core Moonshot code should explain in detail what
34 | changes are being made, so knowledge is shared and not abstracted.
35 |
36 | ## Installation
37 |
38 | You can install Moonshot for your local user with:
39 |
40 | $ gem install moonshot
41 |
42 | If you would prefer to manage your projects dependencies with Bundler,
43 | add the following to your Gemfile:
44 |
45 | gem 'moonshot'
46 |
47 | And then execute:
48 |
49 | $ bundle install
50 |
51 | After installation, there is still some work required. Follow
52 | the [example documentation](example.md) as described below to dig in!
53 |
54 | ## Getting started
55 |
56 | The Moonshot tool has been designed to be an extensible library for
57 | your specific use-case. We aren't trying to solve every use case, but
58 | rather give you an extensible toolkit that your project can grow with,
59 | without leaving your trapped behind rigid design philosophy.
60 | Interested in how it can be used? See our [example documentation][2].
61 | The example doc uses the files shown in the [sample directory][3] so
62 | you can figure out how to modify this for your own application.
63 |
64 | We also want to [help you contribute and answer all your questions][1]
65 | on how Moonshot is maintained.
66 |
67 | [1]: http://moonshot.readthedocs.org/en/latest/about/contribute
68 | [2]: example.md
69 | [3]: https://github.com/acquia/moonshot/tree/master/sample
70 |
71 | ## Requirements
72 |
73 | - Ruby 2.2 or higher
74 |
75 | ## Attributions
76 |
77 | Thanks to [Acquia Inc.](https://acquia.com) for sponsoring the time to work on this tool.
78 | Thanks to [Ted](https://github.com/tottey) for the funky logo.
79 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # 
Moonshot [](http://moonshot.readthedocs.org/en/latest/?badge=latest)[](https://codeclimate.com/github/acquia/moonshot/coverage)[](https://codeclimate.com/github/acquia/moonshot)[](https://badge.fury.io/rb/moonshot)
2 | _Because releasing services shouldn't be a moonshot._
3 |
4 | ## Overview
5 |
6 | [We also have pretty docs, lots more to find there.](http://moonshot.readthedocs.org/en/latest/)
7 |
8 | Moonshot is a Ruby gem for provisioning environments in AWS using a CLI.
9 | The environments are centered around a single CloudFormation stack and supported
10 | by pluggable systems:
11 |
12 | - A DeploymentMechanism controls releasing code.
13 | - A BuildMechanism creates a release artifact.
14 | - A ArtifactRepository stores the release artifacts.
15 |
16 | 
17 |
18 | ## Design Goals
19 |
20 | These are core ideas to the creation of this project. Not all are met to the
21 | level we'd like (e.g. CloudFormation isn't much of a Choice currently), but we
22 | should aspire to meet them with each iteration.
23 |
24 | - Simplicity: It shouldn't take more than a few hours to understand what your
25 | release tooling does.
26 | - Choice: As much as possible, each component should be pluggable and omittable,
27 | so teams are free to use what works best for them.
28 | - Verbosity: The output of core Moonshot code should explain in detail what
29 | changes are being made, so knowledge is shared and not abstracted.
30 |
31 | ## Existing limitations
32 |
33 | - Moonshot does not support detailed error logging from Cloudformation substacks.
34 | - Moonshot does not support a non-local cloudformation file.
35 |
36 | ## Installation
37 |
38 | Install the Moonshot gem:
39 |
40 | ```shell
41 | $ gem install moonshot
42 | ```
43 |
44 | After installation, there is still some work required. Follow the [example documentation](docs/example.md) as described below to dig in!
45 |
46 | ## Getting started
47 |
48 | The Moonshot tool has been designed to be an extensible library for your
49 | specific use-case. Interested in how it can be used? See our [example
50 | documentation](http://moonshot.readthedocs.org/en/latest/example). The example
51 | doc uses the files shown in the [sample
52 | directory](https://github.com/acquia/moonshot/tree/master/sample) so you can
53 | figure out how to modify this for your own deployment strategy.
54 |
55 | We also want to [help you contribute and answer all your questions](http://moonshot.readthedocs.org/en/latest/about/contribute) on how Moonshot is maintained.
56 |
57 | ## Requirements
58 |
59 | - Ruby 2.2 or higher
60 |
61 | ## Attributions
62 |
63 | Thanks to [Acquia Inc.](https://acquia.com) for sponsoring the time to work on this tool.
64 | Thanks to [Ted](https://github.com/tottey) for the funky logo.
65 |
--------------------------------------------------------------------------------
/sample/bin/aws-codedeploy-samples/load-balancing/elb/register_with_elb.sh:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 | #
3 | # Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved.
4 | #
5 | # Licensed under the Apache License, Version 2.0 (the "License").
6 | # You may not use this file except in compliance with the License.
7 | # A copy of the License is located at
8 | #
9 | # http://aws.amazon.com/apache2.0
10 | #
11 | # or in the "license" file accompanying this file. This file is distributed
12 | # on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
13 | # express or implied. See the License for the specific language governing
14 | # permissions and limitations under the License.
15 |
16 | . $(dirname $0)/common_functions.sh
17 |
18 | msg "Running AWS CLI with region: $(get_instance_region)"
19 |
20 | # get this instance's ID
21 | INSTANCE_ID=$(get_instance_id)
22 | if [ $? != 0 -o -z "$INSTANCE_ID" ]; then
23 | error_exit "Unable to get this instance's ID; cannot continue."
24 | fi
25 |
26 | # Get current time
27 | msg "Started $(basename $0) at $(/bin/date "+%F %T")"
28 | start_sec=$(/bin/date +%s.%N)
29 |
30 | msg "Checking if instance $INSTANCE_ID is part of an AutoScaling group"
31 | asg=$(autoscaling_group_name $INSTANCE_ID)
32 | if [ $? == 0 -a -n "$asg" ]; then
33 | msg "Found AutoScaling group for instance $INSTANCE_ID: $asg"
34 |
35 | msg "Checking that installed CLI version is at least at version required for AutoScaling Standby"
36 | check_cli_version
37 | if [ $? != 0 ]; then
38 | error_exit "CLI must be at least version ${MIN_CLI_X}.${MIN_CLI_Y}.${MIN_CLI_Z} to work with AutoScaling Standby"
39 | fi
40 |
41 | msg "Attempting to move instance out of Standby"
42 | autoscaling_exit_standby $INSTANCE_ID $asg
43 | if [ $? != 0 ]; then
44 | error_exit "Failed to move instance out of standby"
45 | else
46 | msg "Instance is no longer in Standby"
47 | exit 0
48 | fi
49 | fi
50 |
51 | msg "Instance is not part of an ASG, continuing..."
52 |
53 | msg "Checking that user set at least one load balancer"
54 | if test -z "$ELB_LIST"; then
55 | error_exit "Must have at least one load balancer to register to"
56 | fi
57 |
58 | # Loop through all LBs the user set, and attempt to register this instance to them.
59 | for elb in $ELB_LIST; do
60 | msg "Checking validity of load balancer named '$elb'"
61 | validate_elb $INSTANCE_ID $elb
62 | if [ $? != 0 ]; then
63 | msg "Error validating $elb; cannot continue with this LB"
64 | continue
65 | fi
66 |
67 | msg "Registering $INSTANCE_ID to $elb"
68 | register_instance $INSTANCE_ID $elb
69 |
70 | if [ $? != 0 ]; then
71 | error_exit "Failed to register instance $INSTANCE_ID from ELB $elb"
72 | fi
73 | done
74 |
75 | # Wait for all Registrations to finish
76 | msg "Waiting for instance to register to its load balancers"
77 | for elb in $ELB_LIST; do
78 | wait_for_state "elb" $INSTANCE_ID "InService" $elb
79 | if [ $? != 0 ]; then
80 | error_exit "Failed waiting for $INSTANCE_ID to return to $elb"
81 | fi
82 | done
83 |
84 | msg "Finished $(basename $0) at $(/bin/date "+%F %T")"
85 |
86 | end_sec=$(/bin/date +%s.%N)
87 | elapsed_seconds=$(echo "$end_sec - $start_sec" | /usr/bin/bc)
88 |
89 | msg "Elapsed time: $elapsed_seconds"
90 |
--------------------------------------------------------------------------------
/sample/bin/aws-codedeploy-samples/load-balancing/elb/deregister_from_elb.sh:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 | #
3 | # Copyright 2014 Amazon.com, Inc. or its affiliates. All Rights Reserved.
4 | #
5 | # Licensed under the Apache License, Version 2.0 (the "License").
6 | # You may not use this file except in compliance with the License.
7 | # A copy of the License is located at
8 | #
9 | # http://aws.amazon.com/apache2.0
10 | #
11 | # or in the "license" file accompanying this file. This file is distributed
12 | # on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
13 | # express or implied. See the License for the specific language governing
14 | # permissions and limitations under the License.
15 |
16 | . $(dirname $0)/common_functions.sh
17 |
18 | msg "Running AWS CLI with region: $(get_instance_region)"
19 |
20 | # get this instance's ID
21 | INSTANCE_ID=$(get_instance_id)
22 | if [ $? != 0 -o -z "$INSTANCE_ID" ]; then
23 | error_exit "Unable to get this instance's ID; cannot continue."
24 | fi
25 |
26 | # Get current time
27 | msg "Started $(basename $0) at $(/bin/date "+%F %T")"
28 | start_sec=$(/bin/date +%s.%N)
29 |
30 | msg "Checking if instance $INSTANCE_ID is part of an AutoScaling group"
31 | asg=$(autoscaling_group_name $INSTANCE_ID)
32 | if [ $? == 0 -a -n "$asg" ]; then
33 | msg "Found AutoScaling group for instance $INSTANCE_ID: $asg"
34 |
35 | msg "Checking that installed CLI version is at least at version required for AutoScaling Standby"
36 | check_cli_version
37 | if [ $? != 0 ]; then
38 | error_exit "CLI must be at least version ${MIN_CLI_X}.${MIN_CLI_Y}.${MIN_CLI_Z} to work with AutoScaling Standby"
39 | fi
40 |
41 | msg "Attempting to put instance into Standby"
42 | autoscaling_enter_standby $INSTANCE_ID $asg
43 | if [ $? != 0 ]; then
44 | error_exit "Failed to move instance into standby"
45 | else
46 | msg "Instance is in standby"
47 | exit 0
48 | fi
49 | fi
50 |
51 | msg "Instance is not part of an ASG, continuing..."
52 |
53 | msg "Checking that user set at least one load balancer"
54 | if test -z "$ELB_LIST"; then
55 | error_exit "Must have at least one load balancer to deregister from"
56 | fi
57 |
58 | # Loop through all LBs the user set, and attempt to deregister this instance from them.
59 | for elb in $ELB_LIST; do
60 | msg "Checking validity of load balancer named '$elb'"
61 | validate_elb $INSTANCE_ID $elb
62 | if [ $? != 0 ]; then
63 | msg "Error validating $elb; cannot continue with this LB"
64 | continue
65 | fi
66 |
67 | msg "Deregistering $INSTANCE_ID from $elb"
68 | deregister_instance $INSTANCE_ID $elb
69 |
70 | if [ $? != 0 ]; then
71 | error_exit "Failed to deregister instance $INSTANCE_ID from ELB $elb"
72 | fi
73 | done
74 |
75 | # Wait for all Deregistrations to finish
76 | msg "Waiting for instance to de-register from its load balancers"
77 | for elb in $ELB_LIST; do
78 | wait_for_state "elb" $INSTANCE_ID "OutOfService" $elb
79 | if [ $? != 0 ]; then
80 | error_exit "Failed waiting for $INSTANCE_ID to leave $elb"
81 | fi
82 | done
83 |
84 | msg "Finished $(basename $0) at $(/bin/date "+%F %T")"
85 |
86 | end_sec=$(/bin/date +%s.%N)
87 | elapsed_seconds=$(echo "$end_sec - $start_sec" | /usr/bin/bc)
88 |
89 | msg "Elapsed time: $elapsed_seconds"
90 |
--------------------------------------------------------------------------------
/docs/plugins.md:
--------------------------------------------------------------------------------
1 | # Plugin Support
2 |
3 | **Warning, the plugin support in Moonshot is a work-in-progress. The interface
4 | to plugins may change dramatically in future versions.**
5 |
6 |
7 | Moonshot supports adding plugins (implemented as a Ruby class) to the
8 | controller that can perform actions before and after the `create`,
9 | `update`, `delete`, `deploy`, `status`, `doctor` and `ssh` actions.
10 |
11 | ## Writing a Moonshot Plugin
12 |
13 | A Moonshot Plugin is a Ruby class that responds to one or more of the following
14 | methods:
15 |
16 | - pre_create
17 | - post_create
18 | - pre_update
19 | - post_update
20 | - pre_delete
21 | - post_delete
22 | - pre_deploy
23 | - post_deploy
24 | - pre_status
25 | - post_status
26 | - pre_doctor
27 | - post_doctor
28 | - pre_ssh
29 | - post_ssh
30 | - setup_create
31 | - setup_update
32 | - setup_status
33 | - setup_build
34 | - setup_deploy
35 | - setup_delete
36 |
37 |
38 | The method will be handed a single argument, which is an instance of the
39 | `Moonshot::Resources` class. This instance gives the plugin access to three
40 | important resources:
41 |
42 | - `Moonshot::Resources#ilog` is an instance of `InteractiveLogger`, used to
43 | display status to the user of the CLI interface.
44 | - `Moonshot::Resources#stack` is an instance of `Moonshot::Stack` which can
45 | retreive the name of the stack, stack parameters and stack outputs. This support
46 | should be expanded in the future to provide Plugins with more control over the
47 | CloudFormation stack.
48 |
49 | `setup` hooks work a bit differently. They are invoked before any other business
50 | logic is executed. This means no resource objects are actually instantiated,
51 | therefore no parameters are passed in this case.
52 |
53 | ## Manipulating CLI options with Plugins
54 |
55 | If you wish to modify the options accepted by a core Moonshot command
56 | in order to affect the pre/post hooks defined in your plugin,
57 | implement a method called `