Amazon Web Services Commandline Client
Simple and lightweight ubuntu based Docker Image for Amazon web services command line tool (awscli)
Supported Platforms
Platforms |
---|
linux/amd64 |
linux/arm64 |
linux/arm/v7 |
Docker Image Types
Image Type | Tag prefix | Usage |
---|---|---|
Command | NONE | This image runs the aws command when launched with docker run with at least one parameter |
Command Image type has default tags without any prefixes. For example "latest", "1.18.32". | ||
Shell | shell- | This image is used for scripting use/automations where shell based command execution is needed |
Shell Image type has default tags with prefix shell-. For example "shell-latest", "shell-1.18.32". |
AWSCLI Versions
TAG | AWSCLI Version | Docker Pull Command |
---|---|---|
latest | 1.18.32 | docker pull satishweb/awscli |
shell-latest | 1.18.32 | docker pull satishweb/awscli:shell-latest |
1.18.32 | 1.18.32 | docker pull satishweb/awscli:1.18.32 |
shell-1.18.32 | 1.18.32 | docker pull satishweb/awscli:shell-1.18.32 |
Command Image Type Usage
Action | Command |
---|---|
Pull | docker pull satishweb/awscli |
Run | docker run --rm -e AWS_ACCESS_KEY_ID=<key> -e AWS_SECRET_ACCESS_KEY=<secret> -e AWS_DEFAULT_REGION=<region> -it satishweb/awscli <command> <options> |
Alias | aws(){dParam='run --rm -e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY -e AWS_DEFAULT_REGION=$AWS_DEFAULT_REGION -it satishweb/awscli'; [[ "$1" ]] && eval docker $dParam $@ && return; eval docker $dParam help} |
With Creds | docker run -i -t --rm -v mycredentialsfile:/root/.aws/credentials:ro satishweb/awscli <command> <options> |
You can setup alias in ~/.bashrc or /etc/profile to make
aws
command available in each shell by default
Shell Image Type Usage
Command: docker run --rm -e AWS_ACCESS_KEY_ID=<key> -e AWS_SECRET_ACCESS_KEY=<secret> -e AWS_DEFAULT_REGION=<region> -it satishweb/awscli:shell-latest
This will open bash shell prompt. This image type should be used for all script/automation systems.
Useful Commands
Action | Command |
---|---|
aws version | docker run --rm -it satishweb/awscli --version |
aws help | docker run --rm -it satishweb/awscli help |
If you run this image in AWS ECS then ensure you have atleast 40MB memory configured.
AWSCLI Configurations
We can write awscli config file and run docker image with it (see Usage section).
Credentials Config Example:
[default]
aws_access_key_id=XXXXXXXXXXX
aws_secret_access_key=xxxxxxxxxxxxxxxxxx
region=us-east-1
output=text
Found Issues?
***Please help me resolve issues that you notice by reporting them *** HERE
References
Title | Reference |
---|---|
AWS Client Help | https://aws.amazon.com/cli/ |
Ubuntu Docker Image | https://hub.docker.com/_/ubuntu/ |