yamaszone/aws repository overview

⁠aws-cli

Minimal AWS CLI⁠ Docker container using official Python Alpine⁠ base.

⁠Prerequisites

1. Docker installed in your environment
2. You have an AWS access key pair⁠

⁠User Guide

• Copy the shell script⁠ aws from project root to /usr/local/bin or /opt/bin (CoreOS)
  • aws above uses yamaszone/awscli:latest as the default image. If you need specific CLI version, see available tags⁠.
• Configure AWS credentials following this⁠ instruction or via aws configure from terminal.

⁠Developer Guide

• Project root contains a convenient run script⁠ to help performing typical tasks for developer workflow (e.g. build image, setup test framework to test image, run tests, etc.)

$ ./run help
Usage:
         cba | configure-bats-assert    : Configure bats-assert library (first-time only).
         stf | setup-test-framework     : Setup test framework (first-time only).
         build                          : Build image with the given tag (default=latest).
         tests                          : Run tests.
         help                           : Show this help.

• All the tests under ./tests assert successful image builds and are split into two groups using the following prefix:
  • healthcheck_*.bats: Smoke tests that doesn't require AWS credentials
  • test_*.bats: Smoke tests that requires AWS credentials
• The project is configured to run healthchecks_*.bats via CircleCI when any new changes are pushed to master