aws-starter's Introduction

Automation tool for Amazon AWS

Purpose:

start one or more Amazon instances;
configure each started instance;
run some code, using access to the instances via SSH;
terminate the instances

Synopsis

To show usage help:

aws-starter -h

To start instances:

aws-starter [options] config_path

Positional arguments:

config_path - Path to configuration file.

Optional arguments:

-h, --help - Show this help message and exit.
-p, --pause - Wait until user press the ENTER key after the super script and before termination of the instances. In case of an error no pause will be made.
--pause-on-error - Wait until user press the ENTER key before termination of the instances when an error occurs.
--no-terminate - Do not terminate the instances after the work is done. The instances WILL be terminated when an error occurs.
--no-terminate-on-error - Do not terminate the instances after an error has been occured. This is useful to make able the user to investigate the problem on the instances.
--stop - do not start any instances. Read instance IDs from a local file, defined in a 'instance_ids_path' configuration option, terminate them all and exit. See description of 'instance_ids_path' configuration option for more details;
-v VERBOSITY, --verbosity VERBOSITY - Verbosity level. Default is "info". Possible values are: "debug", "info", "warning", "error", "critical".

Instance features

Each instance started with aws-starter have the following features:

instance_initiated_shutdown_behaviour option is set to terminate which means the instance will be terminated after a shutdown initiated within the instance (i.e. by poweroff command line tool);
a set of standard tags will be set, e.g.
- Name - instance name defined in the aws-starter.cfg file;
- StartedBy - effective user name and short hostname where the aws-starter tool was launched;
- StarterProg - 'aws-starter';
- StarterHost - uname -a string.

aws-starter's People

Contributors

Watchers

aws-starter's Issues

Feature: show used AMI in the logs

Race condition during instance launch

How it looks:

2015-07-07 00:48:59 aws-starter I node1: launched i-44739b8d at us-west-2. Wait until it starts...
2015-07-07 00:49:04 boto E 400 Bad Request
2015-07-07 00:49:04 boto E <?xml version="1.0" encoding="UTF-8"?>
<Response><Errors><Error><Code>InvalidInstanceID.NotFound</Code><Message>The instance ID 'i-44739b8d' does not exist</Message></Error></Errors><RequestID>aae8e674-5adc-4500-8bb4-cde6eff3e5b7</RequestID></Response>
2015-07-07 00:49:04 aws-starter E EC2ResponseError: 400 Bad Request
<?xml version="1.0" encoding="UTF-8"?>
<Response><Errors><Error><Code>InvalidInstanceID.NotFound</Code><Message>The instance ID 'i-44739b8d' does not exist</Message></Error></Errors><RequestID>aae8e674-5adc-4500-8bb4-cde6eff3e5b7</RequestID></Response>
Traceback (most recent call last):
  File "/usr/bin/aws-starter", line 82, in launch_catched
    launch(*args)
  File "/usr/bin/aws-starter", line 158, in launch
    if not wait_for_instance(instance, max_wait_time):
  File "/usr/bin/aws-starter", line 277, in wait_for_instance
    if instance.update() == 'running':
  File "/usr/lib/python2.7/dist-packages/boto/ec2/instance.py", line 413, in update
    rs = self.connection.get_all_reservations([self.id], dry_run=dry_run)
  File "/usr/lib/python2.7/dist-packages/boto/ec2/connection.py", line 682, in get_all_reservations
    [('item', Reservation)], verb='POST')
  File "/usr/lib/python2.7/dist-packages/boto/connection.py", line 1182, in get_list
    raise self.ResponseError(response.status, response.reason, body)
EC2ResponseError: EC2ResponseError: 400 Bad Request
<?xml version="1.0" encoding="UTF-8"?>
<Response><Errors><Error><Code>InvalidInstanceID.NotFound</Code><Message>The instance ID 'i-44739b8d' does not exist</Message></Error></Errors><RequestID>aae8e674-5adc-4500-8bb4-cde6eff3e5b7</RequestID></Response>

Recommend Projects