Utility program for Amazon Web Services

Features

• Command line interface for Boto
• Wrapper for Fabric
• List instances and regions for ELB and EC2 services
• List EC2 instances for specific ELB
• Manage your EC2 instances
• Run Fabric tasks against all EC2 instances or EC2 instances of specific ELB

Motivation

We all love Boto and Fabric. Why not combine them?

Goal of this project is to provide easy to use command line interface for Boto and provide tools for finding out hosts for your Fabric remote calls.

Are you using Fabric? Now you don't have to write code to find your Amazon EC2 instances by yourself. Just pass the name of your Elastic Load Balancer and name of your custom Fabric function and your servers are updated.

TODO

• More features!
• Start/Stop/Terminate instances
• Manage your AMIs
• AWS Auto Scaling support

#Installation#

$ pip install aws

#Configuration#

aws should work with minimal configuration.

You only need to make sure that AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables are set.

If you want to use Fabric and execute code on your remote servers, or use different regions, you can set necessary info into settings file:

# /home/<username>/.aws/settings.conf
[SSH]
KEY_FILE = /home/<username>/.ec2/myserver.pem
USER = ubuntu

# Service specific settings
[EC2]
REGION = 'eu-west-1'

# Service specific settings
[ELB]
REGION = 'eu-west-1'

See Boto's documentation for more how to set Amazon access credentials: http://boto.readthedocs.org/en/latest/boto_config_tut.html

See Fabric's documentation on how to set SSH access credentials: http://docs.fabfile.org/en/latest/usage/execution.html#leveraging-native-ssh-config-files

#Usage examples#

See aws --help for more information or aws ec2 --help for command specific help.

List all ELB instances:

$ aws elb list

List all EC2 instances:

$ aws ec2 list

List all EC2 instances for ELB named "MyBalancer":

$ aws ec2 list --elb MyBalancer

Run Fabric tasks against EC2 instances:

$ aws ec2 fab mymethod

Run Fabric tasks against EC2 instances and define fabfile to be used:

$ aws ec2 fab mymethod -f myfabfile.py

You can pass parameters to your methods as with Fabric's fab command:

$ aws ec2 fab mymethod:name='Jeff'

Or run Fabric tasks against EC2 instances of specific ELB:

$ aws ec2 fab mymethod --elb MyBalancer