https://github.com/trinitronx/docker-awscli

Docker container with the AWS CLI tools installed
https://github.com/trinitronx/docker-awscli

Last synced: 3 months ago
JSON representation

Docker container with the AWS CLI tools installed

• Host: GitHub
• URL: https://github.com/trinitronx/docker-awscli
• Owner: trinitronx
• License: apache-2.0
• Created: 2016-01-08T19:35:38.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2017-01-25T20:28:10.000Z (over 9 years ago)
• Last Synced: 2025-01-10T07:47:22.737Z (over 1 year ago)
• Size: 12.7 KB
• Stars: 1
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# docker-awscli

A Docker container with the AWS CLI tools installed.

Based on [sourcegraph/docker-awscli][1], with added packages (`sudo`, `acl`, `locales`) and fixed UTF-8 locale.

Default Entrypoint: `/usr/local/bin/aws`

## Usage

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

## License

This project is simply a packaging script for the [`awscli`][awscli-github] tool.  As such, nothing in this repository is "novel", or "non-obvious".

However, the upstream tool ["`awscli`"][awscli-license], is released under the [Apache 2.0 License][apache-2-license]. The text of this tool's license is included here to avoid confusion.

[1]: https://github.com/sourcegraph/docker-awscli

[awscli-github]: https://github.com/aws/aws-cli

[apache-2-license]: https://choosealicense.com/licenses/apache-2.0/

[awscli-license]: https://github.com/aws/aws-cli/blob/develop/LICENSE.txt