aws-ia / terraform-repo-template

Terraform Module Template

Creating modules for AWS I&A Organization

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.

TL;DR

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

Module Documentation

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.

Terratest

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

Configure and run Terratest

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

Module Standards

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

Continuous Integration

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.

Requirements

Name	Version
terraform	>= 1.0.7
aws	>= 4.0.0, < 5.0.0
awscc	>= 0.24.0

Providers

No providers.

Modules

No modules.

Resources

No resources.

Inputs

No inputs.

Outputs

No outputs.