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.
- install pre-commit
- configure pre-commit:
pre-commit install - 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
-
Install
golang (for macos you can use
brew) -
Change directory into the test folder.
cd test -
Initialize your test
go mod init github.com/[github org]/[repository]
go mod init github.com/aws-ia/terraform-aws-vpc -
Run tidy
go mod tidy -
Install Terratest
go get github.com/gruntwork-io/terratest/modules/terraform -
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.