CloudFormation aware aws cli wrapper.
Project description
pronounced /ˈɒzi/ oz-ee like our great friends from down under.
AWSIE is a CloudFormation aware wrapper on top of the AWS cli. It help you to call an awscli command, but instead of the actual physical ID of the resource you set the logical CloudFormation template id which will be replaced then.
For many different resources AWS can automatically set a random name when creating the resource through Cloudformation. While this has a big upside with resources not clashing when the same stack gets deployed multipe times, a downside is that running a command against a specific resource means you have to write lookup code or use the resource name by hand.
Awsie helps you to do that lookup and call the awscli without any potential for clashes.
Installation
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
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
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.
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for awsie-0.0.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6771b4ceb2d3c14cdee70e6f8a5eba5d16361671e0b85c24d62b7d5826eaa54a |
|
MD5 | 25c9da7446dca4c800b29ab7fbc98a72 |
|
BLAKE2b-256 | f6da3b1b4877c4b165102a929e420ae805adcfc599e04501eaec103906b3533d |