Terratest | Automated tests for your infrastructure code.

Test infrastructure code with Terratest in 4 steps

Write test code using Go Create a file ending in _test.go and run tests with the go test command. E.g., go test my_test.go.

Use Terratest to deploy infrastructure Use Terratest to execute your real IaC tools (e.g., Terraform, Packer, etc.) to deploy real infrastructure (e.g., servers) in a real environment (e.g., AWS).

Validate infrastructure with Terratest Use the tools built into Terratest to validate that the infrastructure works correctly in that environment by making HTTP requests, API calls, SSH connections, etc.

Undeploy Undeploy everything at the end of the test.

Test with Terratest

main.tf

terraform_hello_world_example_test.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/terraform-hello-world-example/main.tf

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/test/terraform_hello_world_example_test.go

Learn more:

Terraform Hello, World

build.pkr.hcl

packer_hello_world_example_test.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/packer-hello-world-example/build.pkr.hcl

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/test/packer_hello_world_example_test.go

Learn more:

Packer Hello, World

Dockerfile

docker_hello_world_example_test.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/docker-hello-world-example/Dockerfile

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/test/docker_hello_world_example_test.go

Learn more:

Docker Hello, World

hello-world-deployment.yml

kubernetes_hello_world_example_test.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/kubernetes-hello-world-example/hello-world-deployment.yml

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/test/kubernetes_hello_world_example_test.go

Learn more:

Kubernetes Hello, World

terragrunt.hcl

main.tf

terragrunt_example_test.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/terragrunt-example/terragrunt.hcl

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/terragrunt-example/main.tf

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/test/terragrunt_example_test.go

Learn more:

Terragrunt

main.tf

terraform_aws_hello_world_example_test.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/terraform-aws-hello-world-example/main.tf

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/test/terraform_aws_hello_world_example_test.go

Learn more:

AWS Hello, World

main.tf

terraform_gcp_hello_world_example_test.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/terraform-gcp-hello-world-example/main.tf

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/test/gcp/terraform_gcp_hello_world_example_test.go

Learn more:

GCP Hello, World

main.tf

outputs.tf

variables.tf

terraform_azure_example_test.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/azure/terraform-azure-example/main.tf

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/azure/terraform-azure-example/outputs.tf

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/azure/terraform-azure-example/variables.tf

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/test/azure/terraform_azure_example_test.go

Learn more:

Terraform Azure Example

main_pass.tf

main_fail.tf

enforce_source.rego

terraform_opa_example_test.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/terraform-opa-example/pass/main_pass.tf

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/terraform-opa-example/fail/main_fail.tf

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/examples/terraform-opa-example/policy/enforce_source.rego

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/test/terraform_opa_example_test.go

Learn more:

Terraform OPA Example

client_factory.go

client_factory_test.go

compute.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/modules/azure/client_factory.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/modules/azure/client_factory_test.go

Loading...

View on GitHub:

github.com/gruntwork-io/terratest/modules/azure/compute.go

Start testing infrastructure code shape

Watch:

How to test infrastructure code:
automated testing for Terraform, Kubernetes, Docker, Packer and more

The talk is a step-by-step, live-coding class on how to write automated tests for infrastructure code, including the code you write for use with tools such as Terraform, Kubernetes, Docker, and Packer. Topics covered include unit tests, integration tests, end-to-end tests, test parallelism, retries, error handling, static analysis, and more.

Check out the video and slides for the talk.

Built by Gruntwork

Your entire infrastructure. Defined as code. In about a day.

Explore Gruntwork.io

Links

Quick start

Documentation

Examples

Automated tests for your infrastructure code.

Test infrastructure code with Terratest in 4 steps

Test with Terratest

How to test infrastructure code: automated testing for Terraform, Kubernetes, Docker, Packer and more

Built by Gruntwork

Links

How to test infrastructure code:
automated testing for Terraform, Kubernetes, Docker, Packer and more