Skip to content

Commit 1a56bc9

Browse files
committed
chore: update README.md
1 parent f4c62be commit 1a56bc9

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-elasticache-memcached/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-elasticache-memcached/releases/latest"><img src="https://img.shields.io/github/release/cloudposse/terraform-aws-elasticache-memcached.svg?style=for-the-badge" alt="Latest Release"/></a><a href="https://github.com/cloudposse/terraform-aws-elasticache-memcached/commits"><img src="https://img.shields.io/github/last-commit/cloudposse/terraform-aws-elasticache-memcached.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-elasticache-memcached/releases/latest"><img src="https://img.shields.io/github/release/cloudposse/terraform-aws-elasticache-memcached.svg?style=for-the-badge" alt="Latest Release"/></a><a href="https://github.com/cloudposse/terraform-aws-elasticache-memcached/commits"><img src="https://img.shields.io/github/last-commit/cloudposse/terraform-aws-elasticache-memcached.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
<!--
@@ -315,7 +318,36 @@ In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.
315318
5. **Push** your work back up to your fork
316319
6. Submit a **Pull Request** so that we can review your changes
317320

318-
**NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request!
321+
**NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request!## Running Terraform Tests
322+
323+
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.
324+
325+
All tests are located in the [`test/`](test) folder.
326+
327+
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.
328+
329+
Setup dependencies:
330+
- Install Atmos ([installation guide](https://atmos.tools/install/))
331+
- Install Go [1.24+ or newer](https://go.dev/doc/install)
332+
- Install Terraform or OpenTofu
333+
334+
To run tests:
335+
336+
- Run all tests:
337+
```sh
338+
atmos test run
339+
```
340+
- Clean up test artifacts:
341+
```sh
342+
atmos test clean
343+
```
344+
- Explore additional test options:
345+
```sh
346+
atmos test --help
347+
```
348+
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.
349+
350+
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.
319351

320352
### 🌎 Slack Community
321353

0 commit comments

Comments
 (0)