https://github.com/gruntwork-io/terratest
Terratest is a Go library that makes it easier to write automated tests for your infrastructure code.
https://github.com/gruntwork-io/terratest
aws devops docker golang packer terraform testing testing-library
Last synced: about 1 month ago
JSON representation
Terratest is a Go library that makes it easier to write automated tests for your infrastructure code.
- Host: GitHub
- URL: https://github.com/gruntwork-io/terratest
- Owner: gruntwork-io
- License: apache-2.0
- Created: 2016-03-05T00:26:17.000Z (over 10 years ago)
- Default Branch: main
- Last Pushed: 2026-10-15T17:10:14.000Z (about 1 month ago)
- Last Synced: 2026-10-17T10:56:25.934Z (about 1 month ago)
- Topics: aws, devops, docker, golang, packer, terraform, testing, testing-library
- Language: Go
- Homepage: https://terratest.gruntwork.io/
- Size: 31.3 MB
- Stars: 7,981
- Watchers: 105
- Forks: 1,369
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: CODEOWNERS
- Security: SECURITY.md
- Notice: NOTICE
Awesome Lists containing this project
- awesome-go - gruntwork-io/terratest
- go-awesome - Terratest - 基础设施测试,比如 Docker (开源类库 / 测试)
- awesome-opentofu - Terratest - Go library that makes writing automated tests for your infrastructure code easier. (Tools / Tests)
- go-awesome - Terratest - Infrastructure tests like Docker (Open source library / Test)
- awesome-terraform - terratest - Terratest is a Go library that makes it easier to write automated tests for your infrastructure code. (Testing / Miscellaneous)
- awesome-tf - terratest - Terratest is a Go library that makes it easier to write automated tests for your infrastructure code. (Testing / Community providers)
- awesome-go - gruntwork-io/terratest - Terratest is a Go library that makes it easier to write automated tests for your infrastructure code. (Testing and Quality / Testing)
- awesome-list-docker - terratest
- awesome-starred - gruntwork-io/terratest - Terratest is a Go library that makes it easier to write automated tests for your infrastructure code. (golang)
- awesome-systools - Terratest - is a Go library that makes it easier to write automated tests for your infrastructure code. (Continuous Integration)
- jimsghstars - gruntwork-io/terratest - Terratest is a Go library that makes it easier to write automated tests for your infrastructure code. (Go)
- github-ultimate-repos - gruntwork-io/terratest - | ⭐ 7,986★ | 🍴 1,368 | 💻 `Go`🔗 <https://github.com/gruntwork-io/terratest>📝 Terratest is a Go library that makes it easier to write automated tests for your infrastructure code.⚙️ `Declarative YAML manifest -> etcd Raft consensus quorum -> controller-runtime reconciliation loop -> CRI container runtime & CNI network routing.` (📜 Master Categorized Repository Directory (100% Clickable Links) / [39] CLOUD-NATIVE INFRASTRUCTURE, KUBERNETES, CONTAINERS & SERVICE MESHES)
- awesome - terratest - Terratest is a Go library that makes it easier to write automated tests for your infrastructure code. (Go)
- bookmarks - gruntwork-io/terratest - Terratest is a Go library that makes it easier to write automated tests for your infrastructure code. **See also** [Official Website](https://terratest.gruntwork.io/) (Climbing)
- awesome-list - terratest - io | 5490 | (Go)
README
# Terratest
[](https://gruntwork.io/?ref=repo_terratest)
[](https://pkg.go.dev/mod/github.com/gruntwork-io/terratest?tab=overview)

Terratest is a Go library that makes it easier to write automated tests for your infrastructure code. It provides a
variety of helper functions and patterns for common infrastructure testing tasks, including:
- Testing Terraform code
- Testing Packer templates
- Testing Docker images
- Executing commands on servers over SSH
- Working with AWS APIs
- Working with Azure APIs
- Working with GCP APIs
- Working with Kubernetes APIs
- Testing Helm Charts
- Making HTTP requests
- Running shell commands
- And much more
## Install
```bash
go get github.com/gruntwork-io/terratest@latest
```
Requires Go 1.26 or later. To lock to a specific release instead of `@latest`, see [Pinning a Terratest version](https://terratest.gruntwork.io/docs/getting-started/version-pinning/).
## Stability and versioning
Starting with v1.0.0, Terratest follows [semantic versioning](https://semver.org/). Breaking changes to the public API
only happen in major releases (e.g. v2.0.0).
Symbols renamed or replaced in v1 are kept with `// Deprecated:` annotations pointing at the new name; removals happen
in v2. Migrating from v0.x: see the [v1 migration guide](https://terratest.gruntwork.io/docs/migrating-to-v1/overview/). Migrating from v1 to v2: see the [v2 migration guide](https://terratest.gruntwork.io/docs/migrating-to-v2/overview/).
**v1 maintenance.** With v2 in development, the v1 line has entered maintenance: it receives security fixes only,
delivered on the `v1` branch, until 12 months after v2.0.0 reaches general availability. v2 ships under new `/v2`
module paths, so pinned v1 consumers are unaffected. Upgrade on your own schedule.
## More info
- [Terratest Website](https://terratest.gruntwork.io)
- [Getting started with Terratest](https://terratest.gruntwork.io/docs/getting-started/quick-start/)
- [Terratest Documentation](https://terratest.gruntwork.io/docs/)
- [Contributing to Terratest](https://terratest.gruntwork.io/docs/community/contributing/)
- [Commercial Support](https://gruntwork.io/support/)
## License
This code is released under the Apache 2.0 License. Please see [LICENSE](LICENSE) and [NOTICE](NOTICE) for more details.
Copyright © 2025 Gruntwork, Inc.