Package: awstools
=====================================AWSTOOLS - high level tools for AWS=====================================AWSTOOLS is a Python package that provide modules and commands to manage aninfrastructure on `Amazon Web Services <http://aws.amazon.com>`_.Awstools is driven by a set of conventions and choices to makes systemoperations simple to the most. Awstools is mainly focused on managing multipleisolated social/web/mobile architectures.Main conventions and choices:- Using one of the Amazon Web Service is better than a custom solution- Operation system: Ubuntu LTS or newer- Configuration system: `Puppet <http://puppetlabs.com>`_At the moment awstools supports:- `CloudFormation <http://aws.amazon.com/cloudformation>`_- **ApplicationSettings** (awstools.applications)Describe your application by declaring a set of *Pool* per *Environment*- **cfn**: List, Create, Update, Delete, InspectManage your AWS resources based on ApplicationSettings and cloudformationtemplates- `EC2 <http://aws.amazon.com/ec2>`_- **ec2ssh**:Connect to one or multiple instances in a handy way- **awstools.fabric.populate_roledefs**:Populate Fabric roles with EC2 instances using the tags.fab -R App-Role cmd_run_on_all_app-role-*_instancesInstallation============Python requirements:- argh- boto- PyYamlConfiguration=============::You must have a valid boto credentials provider to use the awstools.See the `Boto tutorial <http://docs.pythonboto.org/en/latest/boto_config_tut.html>`_.- A **configuration file** is searched in this order:1. <specified by --config>2. ./awstools.cfg3. ~/.awstools.cfg4. /etc/awstools.cfg- An application settings file is searched in this order:1. specified by --settings2. specified by awstools configuration fileTesting=======Run the test with nose::pip install -r requirements-test.txtnosetestsExamples========Command ec2ssh--------------::$ ec2ssh MyInstanceByTagNameWelcome to Ubuntu 12.04 LTS (GNU/Linux 3.2.0-23-virtual x86_64)ubuntu@tb-java-stage:~$$ ec2ssh MyInstanceByTagName uptime19:14:03 up 182 days,  4:49,  0 users,  load average: 0.08, 0.06, 0.05$ ec2ssh App-Role-* uptime----- Command: uptime----- Instances(2): App-Role-development,App-Role-productionConfirm? (Y/n)----- i-a0b24444: ec2-12-12-12-12.compute-1.amazonaws.com  10.101.101.10119:21:32 up 52 days,  3:51,  0 users,  load average: 0.00, 0.01, 0.05----- i-ce786666: ec2-23-23-23-23.compute-1.amazonaws.com  10.201.201.20119:21:32 up 182 days,  4:56,  0 users,  load average: 0.08, 0.04, 0.05----- DONE$ ec2ssh i-a0b24444 uptime19:24:28 up 52 days,  3:54,  0 users,  load average: 0.00, 0.01, 0.05$ ec2ssh 10.101.101.101 uptime19:25:18 up 52 days,  3:55,  0 users,  load average: 0.00, 0.01, 0.05$ ec2ssh App1-*,App2-*,App3-Role-test uptimeConfiguration-------------::[cfn]settings = ~/cloudformation/applications.yamltemplatedir = ~/cloudformationApplications Settings---------------------::Application: gmailShortName: gmKeyName: google-secretkeylive: Trueenvironments:production:storage:template: storage.jsAvailabilityZones: us-east-1a,us-east-1b,us-east-1cWebServerCapacity: 6InstanceType: m1.xlargefrontweb:template: frontweb.jsAvailabilityZones: us-east-1a,us-east-1bWebServerCapacity: 4InstanceType: m1.mediumstage:storage:template: storage.jsAvailabilityZones: us-east-1a,us-east-1bWebServerCapacity: 2InstanceType: m1.smallfrontweb:template: frontweb.jsAvailabilityZones: us-east-1a,us-east-1bWebServerCapacity: 2InstanceType: m1.smalltest:frontweb:template: frontweb.jsAvailabilityZones: us-east-1a,us-east-1bWebServerCapacity: 2The application *gmail* has a production, a staging and a test environment.An environment is defined by two pools: *storage* and *frontweb*.However in test you mock the storage and don't need a *storage* pool.All those settings will be available for the CloudFormation templates.Contribute==========Want to contribute, report a but of request a feature ? The development goes onat Ludia's BitBucket account:- **Report bugs**: https://bitbucket.org/pior/awstools/issues- **Fork the code**: https://bitbucket.org/pior/awstools- **Download**: http://pypi.python.org/pypi/awstoolsCredits=======* `Pior Bastida <pior@pbastida.net>`_ is the originator and main author.Changelog for Awstools======================0.3.10 (2015-04-30)-------------------- Nothing changed yet.0.3.9 (2015-04-30)------------------- Nothing changed yet.0.3.8 (2015-04-23)------------------- Nothing changed yet.0.3.7 (2013-12-17)------------------- Fix wrong priority order when reading multiple configuration files0.3.6 (2013-10-11)------------------- update author email- cfnas: add subcommand metrics to control the ASG metrics collection0.3.5 (2013-10-10)------------------- ec2ssh: add instance private hostname matching- Move autoscale subcommands to a new cfnas command- ec2ssh: add bash completion helpers- Pylint0.3.4 (2013-07-04)------------------- cfn batch-update: continue after a failure if user wants to0.3.3 (2013-07-04)------------------- Add --force option to `cfn update` command- Add a `cfn batch-update` command0.3.2 (2013-06-11)------------------- Complete hgignore- ec2ssh: enhance fallback when denying connection to multiple instances- Fix wrong current_capacity displayed in autoscale update utility0.3.1 (2013-03-13)------------------- fix *cfn setcapacity* setting 0 instead of the desired value0.3 (2013-03-11)----------------- start using zest.releaser for versioning0.2.3 (2013-02-01)------------------- display template description in cfn subcommands- create subcommand "cfn activities"