ploy-ec2 1.0.0

Plugin for ploy to provision Amazon EC2 instances.

Overview

The ploy_ec2 plugin provides integration of Amazon EC2 with ploy.

Installation

ploy_ec2 is best installed with easy_install, pip or with zc.recipe.egg in a buildout.

Masters

To use ploy_ec2 you need an Amazon account and AWS keys.

Once you got your keys, you should put them in a secure location and reference them in your ploy.conf. Additionally you need to set the region of the master:

[ec2-master:ec2eu]
access-key-id = ~/.aws/ec2.id
secret-access-key = ~/.aws/ec2.key
region = eu-west-1

You can also set the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables instead.

You need to define a master for each region you want to use.

Instances

Each instance has the following mandatory settings:

image

The Amazon Machine Image (AMI) that this instance will start up with.

keypair

The name of the SSH keypair to use.

placement

The availability zone in which to launch the instances.

securitygroups

The name of the Securitygroups this instance should be assigned to.

The following settings are optional:

instance_type

ip

startup_script

Path to a script which will be run right after creation and first start of the instance. This uses the User Data feature and needs to be supported by the AMI.

volumes

snapshots

device_map

delete-volumes-on-terminate

Securitygroups

description

connections

[ec2-securitygroup:app-server]
description = The production server
connections =
    tcp     22      22      0.0.0.0/0
    tcp     80      80      0.0.0.0/0

Macro expansion

For instances the ip and volumes options aren’t copied when expanding macros.

Changelog

1.0.0 - 2014-07-19

• Added documentation. [fschulze]

1.0b4 - 2014-07-15

• Fix confusion between instance from ploy and ec2 instance. [fschulze]

1.0b3 - 2014-07-08

• Moved snapshots list command here after ploy enabled it. [fschulze]

• Renamed mr.awsome to ploy and mr.awsome.ec2 to ploy_ec2. [fschulze]

1.0b2 - 2014-05-15

• Renamed conn to ec2_conn to allow reuse of conn from BaseInstance. [fschulze]

• Moved setuptools-git from setup.py to .travis.yml, it’s only needed for releases and testing. [fschulze]

1.0b1 - 2014-03-24

• Initial release [fschulze]