awsie 0.2.0

Installation

Before installing make sure you have the awscli installed as awsie depends on it. We don’t install it ourselves so you’re able to install the exact version you want to use.

pip install awscli

awsie can be installed through pip:

pip install awsie

Alternatively you can clone this repository and run

python setup.py install

Quick example

For example when you deploy a CloudFormation stack:

{
    "Resources": {
        "DeploymentBucket": {
            "Type": "AWS::S3::Bucket"
        }
    }
}

and then want to list the content of the bucket you can use awsie:

awsie example-stack s3 ls s3://cf:DeploymentBucket: --region us-west-1

or if you want to remove somefile from the DeploymentBucket:

awsie example-stack s3 rm s3://cf:DeploymentBucket:/somefile --region us-west-1

which will replace cf:DeploymentBucket: with the actual name of the resource and run the awscli with all arguments you passed to awsie, except for the stack-name (which has to be the first argument):

aws s3 ls s3://formica-example-stack-deploymentbucket-1jjzisylxreh9 --region us-west-1
aws s3 rm s3://formica-example-stack-deploymentbucket-1jjzisylxreh9/somefile --region us-west-1

Replacement syntax

The replacement syntax is cf:LOGICAL_ID: and will replace LOGICAL_ID with the PhysicalId of the resource through the data returned from list-stack-resources. Make sure you don’t forget the second colon at the end, its important to be able to separate the syntax when its embedded in another string.

Arbitrary commands

You can also use awsie to run arbitrary commands with replaced values. Simply use the --command option to set the specific command and the options you want to use. Make sure the command is in quotes so its handled as one argument to awsie.

awsie stack --command "awslogs get cf:LogGroup: ALL"

Options

awsie STACK_NAME

• stack Has to be the first positional argument and will be removed from call to the AWS cli.

• --profile PROFILE The AWS profile to use for the CloudFormation lookup, will be passed to the aws cli.

• --region REGION The AWS region to use for the CloudFormation lookup, will be passed to the aws cli.