A Docker container with the AWS CLI tools installed.
Based on sourcegraph/docker-awscli, with added packages (sudo, acl, locales) and fixed UTF-8 locale.
Default Entrypoint: /usr/local/bin/aws
To run, simply pass your AWS CLI command as the CMD option to docker run. For example:
# List all instance IDs, PublicDNSName, Tags :
docker run --rm -v ~/.aws:/root/.aws returnpath/awscli ec2 describe-instances --output=text --query='Reservations[*].Instances[*].{ID:InstanceId,PublicDNSName:PublicDnsName,Tags:Tags[?Key==`Name`].{Name:Value}}'
# Same as above, but limit to hosts matching a `Name=foo` tag:
docker run --rm -v ~/.aws:/root/.aws returnpath/awscli ec2 describe-instances --filters='Name=tag-name,Values=app,Name=tag-value,Values=foo' --output=text --query='Reservations[*].Instances[*].{ID:InstanceId,PublicDNSName:PublicDnsName,Tags:Tags[?Key==`Name`].{Name:Value}}'
# Same again, but only print PublicDNSName using access keys & profile existing in `~/.aws/config`:
docker run --rm -v ~/.aws:/root/.aws returnpath/awscli --profile=devops-monkey ec2 describe-instances --filters 'Name=tag:Name,Values=foo' --query='Reservations[*].Instances[*].{PublicDNSName:PublicDnsName}' --output=text
# List S3 buckets for an AWS account given access keys & profile existing in `~/.aws/config`:
docker run --rm -v ~/.aws:/root/.aws returnpath/awscli --profile=business-monkey s3 ls
# Spawn interactive container to do more involved work:
docker run -ti --rm -v ~/.aws:/root/.aws --entrypoint=/bin/bash returnpath/awscli
This project is simply a packaging script for the awscli tool. As such, nothing in this repository is "novel", or "non-obvious".
However, the upstream tool "awscli", is released under the Apache 2.0 License. The text of this tool's license is included here to avoid confusion.