Skip to content

aws-ia/terraform-repo-template

Repository files navigation

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
  2. configure pre-commit: pre-commit install
  3. install required tools

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.

Releases

No releases published

Packages

No packages published