This is a docker image that provides some basic tools to manipulate an AWS envionment
Its built on the Alpine docker image and contains the following tools:
- AWSCLI - Installed via the python package manager ( pip )
- Terraform - Downloaded directly from HashiCorp
- Bash-my-AWS - Nice set of tools to help you AWS. Downloaded directly from the master branch on github here
The containers default user is
cloud and its home directory is /home/cloud
For convenience a directory named
project has been created in this home directory. You can use this to store the files for your project or as a convenient place to mount your existing files as a volume
There are a number of ways you can run this container.
You could run it and execute your commands directly inside it:
docker run -it mcrmonkey/awstools
You could pass commands to the container like so:
docker run mcrmonkey/awstools aws <command>
docker run mcrmonkey/awstools terraform <command>
You can mount your existing project files in to the container by adding the following volume options to the run command:
See the docker documentation on volumes here for more information
Your AWS Credentials
Obviously you'll need to some credentials to actually talk to AWS or nothing will work for you.
You can do a few things to pass these details in:
aws configureinside the container
Enter each detail as prompted however if you delete the container the details will be lost
- Pass your .aws directory to the container
Run the container with the volume option set:
docker run -it -v /home/user/.aws:/home/cloud/.aws:ro mcrmonkey/awstools
- Pass your pre-set details in to the container
If your envionment variables are already setup you can run the following to pass those variables directly in to the container:
docker run -it -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_SESSION_TOKEN -e AWS_DEFAULT_REGION mcrmonkey/awstools
If you like you can build your own version of this container
First, clone this repo to a location of your choosing on your own machine:
git clone firstname.lastname@example.org:mcrmonkey/awstools.git
Then run the following in that directory:
docker build -t awstools .
Then you should be all set
I've not applied one.
You can do what ever you like to this version. However, I'd ask you link back here if you make something based on this.