Skip to content

Commit 99e979b

Browse files
committed
chore: update README.md
1 parent 143b711 commit 99e979b

File tree

1 file changed

+35
-3
lines changed

1 file changed

+35
-3
lines changed

README.md

Lines changed: 35 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,11 @@
22

33
<!-- markdownlint-disable -->
44
<a href="https://cpco.io/homepage"><img src="https://github.com/cloudposse/terraform-aws-acm-request-certificate/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-acm-request-certificate/releases/latest"><img src="https://img.shields.io/github/release/cloudposse/terraform-aws-acm-request-certificate.svg?style=for-the-badge" alt="Latest Release"/></a><a href="https://github.com/cloudposse/terraform-aws-acm-request-certificate/commits"><img src="https://img.shields.io/github/last-commit/cloudposse/terraform-aws-acm-request-certificate.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-acm-request-certificate/releases/latest"><img src="https://img.shields.io/github/release/cloudposse/terraform-aws-acm-request-certificate.svg?style=for-the-badge" alt="Latest Release"/></a><a href="https://github.com/cloudposse/terraform-aws-acm-request-certificate/commits"><img src="https://img.shields.io/github/last-commit/cloudposse/terraform-aws-acm-request-certificate.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>
710
<!-- markdownlint-restore -->
811

912
<!--
@@ -237,7 +240,36 @@ In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.
237240
5. **Push** your work back up to your fork
238241
6. Submit a **Pull Request** so that we can review your changes
239242

240-
**NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request!
243+
**NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request!## Running Terraform Tests
244+
245+
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.
246+
247+
All tests are located in the [`test/`](test) folder.
248+
249+
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.
250+
251+
Setup dependencies:
252+
- Install Atmos ([installation guide](https://atmos.tools/install/))
253+
- Install Go [1.24+ or newer](https://go.dev/doc/install)
254+
- Install Terraform or OpenTofu
255+
256+
To run tests:
257+
258+
- Run all tests:
259+
```sh
260+
atmos test run
261+
```
262+
- Clean up test artifacts:
263+
```sh
264+
atmos test clean
265+
```
266+
- Explore additional test options:
267+
```sh
268+
atmos test --help
269+
```
270+
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.
271+
272+
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.
241273

242274
### 🌎 Slack Community
243275

0 commit comments

Comments
 (0)