Infra Guard AWS

Test Automation Tool for AWS Infrastructure

Configure AWS CLI profile

Install the AWS Command Line Interface (AWS CLI)

brew install awscli # macOS
sudo pacman -S aws-cli-v2 # Arch Linux

Verify the version of AWS CLI

aws --version

Configure CLI profile in ~/.aws/config (for non-SSO profile options refer to [1])

aws configure sso

Verify the above profile

aws s3 ls --profile AdministratorAccess-100000000000

If you get the following error

Error when retrieving token from sso: Token has expired and refresh failed

Then, login to SSO account and try again

aws sso login --profile AdministratorAccess-100000000000

Configure application

Add the profile configured in Configure AWS CLI profile and the AWS Region to application.yml, for example:

aws:
  profile: AdministratorAccess-100000000000
  region: eu-west-1

Add Gherkin feature files

Gherkin feature files are located within the src/test/resources/gherkin directory. Using the existing feature files for reference, create feature files to describe your own AWS infrastructure.

Refer to Test tool use cases for further example scenarios.

Usage

Test your AWS infrastructure by typing

AWS_PROFILE=AdministratorAccess-100000000000 ./gradlew clean test --info

Use Cases

Test tool use cases

References

For instructions on how to setup an AWS Profile refer to https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-format-profile