|
2 | 2 |
|
3 | 3 | <!-- markdownlint-disable --> |
4 | 4 | <a href="https://cpco.io/homepage"><img src="https://github.com/cloudposse/terraform-aws-eks-node-group/blob/main/.github/banner.png?raw=true" alt="Project Banner"/></a><br/> |
5 | | - <p align="right"> |
6 | | -<a href="https://github.com/cloudposse/terraform-aws-eks-node-group/releases/latest"><img src="https://img.shields.io/github/release/cloudposse/terraform-aws-eks-node-group.svg?style=for-the-badge" alt="Latest Release"/></a><a href="https://github.com/cloudposse/terraform-aws-eks-node-group/commits"><img src="https://img.shields.io/github/last-commit/cloudposse/terraform-aws-eks-node-group.svg?style=for-the-badge" alt="Last Updated"/></a><a href="https://cloudposse.com/slack"><img src="https://slack.cloudposse.com/for-the-badge.svg" alt="Slack Community"/></a></p> |
| 5 | + |
| 6 | + |
| 7 | +<p align="right"><a href="https://github.com/cloudposse/terraform-aws-eks-node-group/releases/latest"><img src="https://img.shields.io/github/release/cloudposse/terraform-aws-eks-node-group.svg?style=for-the-badge" alt="Latest Release"/></a><a href="https://github.com/cloudposse/terraform-aws-eks-node-group/commits"><img src="https://img.shields.io/github/last-commit/cloudposse/terraform-aws-eks-node-group.svg?style=for-the-badge" alt="Last Updated"/></a><a href="https://cloudposse.com/slack"><img src="https://slack.cloudposse.com/for-the-badge.svg" alt="Slack Community"/></a><a href="https://cloudposse.com/support/"><img src="https://img.shields.io/badge/Get_Support-success.svg?style=for-the-badge" alt="Get Support"/></a> |
| 8 | + |
| 9 | +</p> |
7 | 10 | <!-- markdownlint-restore --> |
8 | 11 |
|
9 | 12 | <!-- |
@@ -484,7 +487,36 @@ In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow. |
484 | 487 | 5. **Push** your work back up to your fork |
485 | 488 | 6. Submit a **Pull Request** so that we can review your changes |
486 | 489 |
|
487 | | -**NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request! |
| 490 | +**NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request!## Running Terraform Tests |
| 491 | +
|
| 492 | +We use [Atmos](https://atmos.tools) to streamline how Terraform tests are run. It centralizes configuration and wraps common test workflows with easy-to-use commands. |
| 493 | +
|
| 494 | +All tests are located in the [`test/`](test) folder. |
| 495 | + |
| 496 | +Under the hood, tests are powered by Terratest together with our internal [Test Helpers](https://github.com/cloudposse/test-helpers) library, providing robust infrastructure validation. |
| 497 | + |
| 498 | +Setup dependencies: |
| 499 | +- Install Atmos ([installation guide](https://atmos.tools/install/)) |
| 500 | +- Install Go [1.24+ or newer](https://go.dev/doc/install) |
| 501 | +- Install Terraform or OpenTofu |
| 502 | + |
| 503 | +To run tests: |
| 504 | + |
| 505 | +- Run all tests: |
| 506 | + ```sh |
| 507 | + atmos test run |
| 508 | + ``` |
| 509 | +- Clean up test artifacts: |
| 510 | + ```sh |
| 511 | + atmos test clean |
| 512 | + ``` |
| 513 | +- Explore additional test options: |
| 514 | + ```sh |
| 515 | + atmos test --help |
| 516 | + ``` |
| 517 | +The configuration for test commands is centrally managed. To review what's being imported, see the [`atmos.yaml`](https://raw.githubusercontent.com/cloudposse/.github/refs/heads/main/.github/atmos/terraform-module.yaml) file. |
| 518 | + |
| 519 | +Learn more about our [automated testing in our documentation](https://docs.cloudposse.com/community/contribute/automated-testing/) or implementing [custom commands](https://atmos.tools/core-concepts/custom-commands/) with atmos. |
488 | 520 |
|
489 | 521 | ### 🌎 Slack Community |
490 | 522 |
|
|
0 commit comments