Documentation

Introduction

Terratest provides a variety of helper functions and patterns for common infrastructure testing tasks. Learn more about Terratest basic usage.

Quick start

Learn how to start with Terratest.

Examples

Examples are the best way to start testing Terraform, Docker, Packer, Kubernetes, AWS, GCP, and more with Terratest.

Package by package overview

Learn more about Terratest modules and how they can help you test different types infrastructure.

GoDoc

Browse Terratest methods and types in GoDoc.

Unit tests, integration tests, end-to-end tests

See the talk about unit tests, integration tests, end-to-end tests, dependency injection, test parallelism, retries, error handling, and static analysis.

Testing environment

Learn more about testing environments.

Namespacing

Learn how to avoid conflicts due to duplicated identifiers.

Cleanup

Since automated tests with Terratest deploy real resources into real environments, you'll want to make sure your tests always cleanup after themselves.

Timeouts and logging

Long-running infrastructure tests may exceed timeouts or can be killed if they do not prompt logs.

Debugging interleaved test output

Learn more about `terratest_log_parser`.

Avoid test caching

Since Go 1.10, test results are automatically cached. See how to turn off caching test results.

Error handling

Learn how to handle errors.

Iterating locally using Docker

If you're writing scripts (i.e., Bash, Python, or Go), you should be able to test them locally using Docker. Docker containers typically build 10x faster and start 100x faster than real servers.

Iterating locally using test stages

Learn more about Terratest's `test_structure`.

Alternative testing tools

Learn more about alternatives to Terratest, and how Terratest compares to other testing tools.

Idempotent

Test that your Terraform configuration results in consistent deployments.

Picking EC2 instance types

Pick EC2 instance types that are available in the current AWS region.

Tools and Plugins

Additional tools and plugins for terratest to make integration with existing workflows easier.

Contributing

Terratest is an open source project, and contributions from the community are very welcome!

Support

Need help?

License

This code is released under the Apache 2.0 License. Read more here.