This repo template is used to seed Terraform Module templates for the AWS I&A GitHub organization. Usage of this template is allowed per included license. PRs to this template will be considered but are not guaranteed to be included. Consider creating an issue to discuss a feature you want to include before taking the time to create a PR.

1. install pre-commit
   • Prerequisites:
     • Python
     • Pip
2. configure pre-commit: pre-commit install
3. install required tools
   • tflint
   • tfsec
   • terraform-docs
   • golang (for macos you can use brew)
   • coreutils

Write code according to I&A module standards

Do not manually update README.md. README.md is automatically generated by pulling in content from other files. For instructions, including a fill-in-the-blank content template, see Create readmes for Terraform-based Partner Solutions.

Please include tests to validate your examples/<> root modules, at a minimum. This can be accomplished with usually only slight modifications to the boilerplate test provided in this template

1. Install

   golang (for macos you can use brew)

2. Change directory into the test folder.

   cd test

3. Initialize your test

   go mod init github.com/[github org]/[repository]

   go mod init github.com/aws-ia/terraform-aws-vpc

4. Run tidy

   go mod tidy

5. Install Terratest

   go get github.com/gruntwork-io/terratest/modules/terraform

6. Run test (You can have multiple test files).

   • Run all tests

     go test

   • Run a specific test with a timeout

     go test -run TestExamplesBasic -timeout 45m

For best practices and information on developing with Terraform, see the I&A Module Standards

The I&A team uses AWS CodeBuild to perform continuous integration (CI) within the organization. Our CI uses the a repo's .pre-commit-config.yaml file as well as some other checks. All PRs with other CI will be rejected. See our FAQ for more details.

No providers.

No modules.

No resources.

No inputs.

No outputs.