Skip to content

Commit e8c911d

Browse files
authored
Update README.md and docs
1 parent 7d5a754 commit e8c911d

File tree

1 file changed

+97
-95
lines changed

1 file changed

+97
-95
lines changed

README.md

Lines changed: 97 additions & 95 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,18 @@
11

2+
23
<!-- markdownlint-disable -->
3-
# github-action-atmos-terraform-plan [![Latest Release](https://img.shields.io/github/release/cloudposse/github-action-atmos-terraform-plan.svg)](https://github.com/cloudposse/github-action-atmos-terraform-plan/releases/latest) [![Slack Community](https://slack.cloudposse.com/badge.svg)](https://slack.cloudposse.com)
4+
# github-action-atmos-terraform-plan <a href="https://cpco.io/homepage?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content="><img align="right" src="https://cloudposse.com/logo-300x69.svg" width="150" /></a>
5+
<a href="https://github.com/cloudposse/github-action-atmos-terraform-plan/releases/latest"><img src="https://img.shields.io/github/release/cloudposse/github-action-atmos-terraform-plan.svg" alt="Latest Release"/></a><a href="https://slack.cloudposse.com"><img src="https://slack.cloudposse.com/badge.svg" alt="Slack Community"/></a>
46
<!-- markdownlint-restore -->
57

6-
[![README Header][readme_header_img]][readme_header_link]
7-
8-
[![Cloud Posse][logo]](https://cpco.io/homepage)
9-
108
<!--
119
1210
1311
1412
1513
** DO NOT EDIT THIS FILE
1614
**
17-
** This file was automatically generated by the `build-harness`.
15+
** This file was automatically generated by the `cloudposse/build-harness`.
1816
** 1) Make all changes to `README.yaml`
1917
** 2) Run `make init` (you only need to do this once)
2018
** 3) Run`make readme` to rebuild this file.
@@ -30,22 +28,17 @@
3028

3129
This Github Action is used to run Terraform plan for a single, Atmos-supported component and save the given planfile to S3 and DynamoDB.
3230

33-
---
34-
35-
This project is part of our comprehensive ["SweetOps"](https://cpco.io/sweetops) approach towards DevOps.
36-
37-
38-
It's 100% Open Source and licensed under the [APACHE2](LICENSE).
39-
40-
41-
42-
43-
44-
45-
46-
47-
4831

32+
> [!TIP]
33+
> #### 👽 Use Atmos with Terraform
34+
> Cloud Posse uses [`atmos`](https://atmos.tools) to easily orchestrate multiple environments using Terraform. <br/>
35+
> Works with [Github Actions](https://atmos.tools/integrations/github-actions/), [Atlantis](https://atmos.tools/integrations/atlantis), or [Spacelift](https://atmos.tools/integrations/spacelift).
36+
>
37+
> <details>
38+
> <summary><strong>Watch demo of using Atmos with Terraform</strong></summary>
39+
> <img src="https://github.com/cloudposse/atmos/blob/master/docs/demo.gif?raw=true"/><br/>
40+
> <i>Example of running <a href="https://atmos.tools"><code>atmos</code></a> to manage infrastructure from our <a href="https://atmos.tools/quick-start/">Quick Start</a> tutorial.</i>
41+
> </detalis>
4942
5043

5144
## Introduction
@@ -56,9 +49,8 @@ After running this action, apply Terraform with the companion action, [github-ac
5649

5750

5851

59-
## Usage
60-
6152

53+
## Usage
6254

6355
### Prerequisites
6456

@@ -178,6 +170,14 @@ Which would produce the same behavior as in `v1`, doing this:
178170
aws-region: "us-east-2"
179171
```
180172

173+
> [!IMPORTANT]
174+
> In Cloud Posse's examples, we avoid pinning modules to specific versions to prevent discrepancies between the documentation
175+
> and the latest released versions. However, for your own projects, we strongly advise pinning each module to the exact version
176+
> you're using. This practice ensures the stability of your infrastructure. Additionally, we recommend implementing a systematic
177+
> approach for updating versions to avoid unexpected changes.
178+
179+
180+
181181

182182

183183

@@ -224,75 +224,94 @@ For additional context, refer to some of these links.
224224
- [github-action-terraform-plan-storage](https://github.com/cloudposse/github-action-terraform-plan-storage) - GitHub Action to store Terraform plans
225225

226226

227+
228+
> [!TIP]
229+
> #### Use Terraform Reference Architectures for AWS
230+
>
231+
> Use Cloud Posse's ready-to-go [terraform architecture blueprints](https://cloudposse.com/reference-architecture/) for AWS to get up and running quickly.
232+
>
233+
> ✅ We build it with you.<br/>
234+
> ✅ You own everything.<br/>
235+
> ✅ Your team wins.<br/>
236+
>
237+
> <a href="https://cpco.io/commercial-support?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=commercial_support"><img alt="Request Quote" src="https://img.shields.io/badge/request%20quote-success.svg?style=for-the-badge"/></a>
238+
> <details><summary>📚 <strong>Learn More</strong></summary>
239+
>
240+
> <br/>
241+
>
242+
> Cloud Posse is the leading [**DevOps Accelerator**](https://cpco.io/commercial-support?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=commercial_support) for funded startups and enterprises.
243+
>
244+
> *Your team can operate like a pro today.*
245+
>
246+
> Ensure that your team succeeds by using Cloud Posse's proven process and turnkey blueprints. Plus, we stick around until you succeed.
247+
> #### Day-0: Your Foundation for Success
248+
> - **Reference Architecture.** You'll get everything you need from the ground up built using 100% infrastructure as code.
249+
> - **Deployment Strategy.** Adopt a proven deployment strategy with GitHub Actions, enabling automated, repeatable, and reliable software releases.
250+
> - **Site Reliability Engineering.** Gain total visibility into your applications and services with Datadog, ensuring high availability and performance.
251+
> - **Security Baseline.** Establish a secure environment from the start, with built-in governance, accountability, and comprehensive audit logs, safeguarding your operations.
252+
> - **GitOps.** Empower your team to manage infrastructure changes confidently and efficiently through Pull Requests, leveraging the full power of GitHub Actions.
253+
>
254+
> <a href="https://cpco.io/commercial-support?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=commercial_support"><img alt="Request Quote" src="https://img.shields.io/badge/request%20quote-success.svg?style=for-the-badge"/></a>
255+
>
256+
> #### Day-2: Your Operational Mastery
257+
> - **Training.** Equip your team with the knowledge and skills to confidently manage the infrastructure, ensuring long-term success and self-sufficiency.
258+
> - **Support.** Benefit from a seamless communication over Slack with our experts, ensuring you have the support you need, whenever you need it.
259+
> - **Troubleshooting.** Access expert assistance to quickly resolve any operational challenges, minimizing downtime and maintaining business continuity.
260+
> - **Code Reviews.** Enhance your team’s code quality with our expert feedback, fostering continuous improvement and collaboration.
261+
> - **Bug Fixes.** Rely on our team to troubleshoot and resolve any issues, ensuring your systems run smoothly.
262+
> - **Migration Assistance.** Accelerate your migration process with our dedicated support, minimizing disruption and speeding up time-to-value.
263+
> - **Customer Workshops.** Engage with our team in weekly workshops, gaining insights and strategies to continuously improve and innovate.
264+
>
265+
> <a href="https://cpco.io/commercial-support?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=commercial_support"><img alt="Request Quote" src="https://img.shields.io/badge/request%20quote-success.svg?style=for-the-badge"/></a>
266+
> </details>
267+
227268
## ✨ Contributing
228269

229-
This project is under active development, and we encourage contributions from our community.
270+
This project is under active development, and we encourage contributions from our community.
271+
272+
273+
230274
Many thanks to our outstanding contributors:
231275

232276
<a href="https://github.com/cloudposse/github-action-atmos-terraform-plan/graphs/contributors">
233277
<img src="https://contrib.rocks/image?repo=cloudposse/github-action-atmos-terraform-plan&max=24" />
234278
</a>
235279

236-
### 🐛 Bug Reports & Feature Requests
237-
238-
Please use the [issue tracker](https://github.com/cloudposse/github-action-atmos-terraform-plan/issues) to report any bugs or file feature requests.
239-
240-
### 💻 Developing
241-
242-
If you are interested in being a contributor and want to get involved in developing this project or [help out](https://cpco.io/help-out) with our other projects, we would love to hear from you! Shoot us an [email][email].
280+
For 🐛 bug reports & feature requests, please use the [issue tracker](https://github.com/cloudposse/github-action-atmos-terraform-plan/issues).
243281

244282
In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.
245-
246-
1. **Fork** the repo on GitHub
247-
2. **Clone** the project to your own machine
248-
3. **Commit** changes to your own branch
249-
4. **Push** your work back up to your fork
250-
5. Submit a **Pull Request** so that we can review your changes
283+
1. Review our [Code of Conduct](https://github.com/cloudposse/github-action-atmos-terraform-plan/?tab=coc-ov-file#code-of-conduct) and [Contributor Guidelines](https://github.com/cloudposse/.github/blob/main/CONTRIBUTING.md).
284+
2. **Fork** the repo on GitHub
285+
3. **Clone** the project to your own machine
286+
4. **Commit** changes to your own branch
287+
5. **Push** your work back up to your fork
288+
6. Submit a **Pull Request** so that we can review your changes
251289

252290
**NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request!
253291

254292
### 🌎 Slack Community
255293

256-
Join our [Open Source Community][slack] on Slack. It's **FREE** for everyone! Our "SweetOps" community is where you get to talk with others who share a similar vision for how to rollout and manage infrastructure. This is the best place to talk shop, ask questions, solicit feedback, and work together as a community to build totally *sweet* infrastructure.
294+
Join our [Open Source Community](https://cpco.io/slack?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=slack) on Slack. It's **FREE** for everyone! Our "SweetOps" community is where you get to talk with others who share a similar vision for how to rollout and manage infrastructure. This is the best place to talk shop, ask questions, solicit feedback, and work together as a community to build totally *sweet* infrastructure.
257295

258296
### 📰 Newsletter
259297

260-
Sign up for [our newsletter][newsletter] that covers everything on our technology radar. Receive updates on what we're up to on GitHub as well as awesome new projects we discover.
261-
262-
### 📆 Office Hours <img src="https://img.cloudposse.com/fit-in/200x200/https://cloudposse.com/wp-content/uploads/2019/08/Powered-by-Zoom.png" align="right" />
263-
264-
[Join us every Wednesday via Zoom][office_hours] for our weekly "Lunch & Learn" sessions. It's **FREE** for everyone!
265-
266-
## About
267-
268-
This project is maintained and funded by [Cloud Posse, LLC][website].
269-
<a href="https://cpco.io/homepage"><img src="https://cloudposse.com/logo-300x69.svg" align="right" /></a>
298+
Sign up for [our newsletter](https://cpco.io/newsletter?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=newsletter) and join 3,000+ DevOps engineers, CTOs, and founders who get insider access to the latest DevOps trends, so you can always stay in the know.
299+
Dropped straight into your Inbox every week — and usually a 5-minute read.
270300

271-
We are a [**DevOps Accelerator**][commercial_support]. We'll help you build your cloud infrastructure from the ground up so you can own it. Then we'll show you how to operate it and stick around for as long as you need us.
301+
### 📆 Office Hours <a href="https://cloudposse.com/office-hours?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=office_hours"><img src="https://img.cloudposse.com/fit-in/200x200/https://cloudposse.com/wp-content/uploads/2019/08/Powered-by-Zoom.png" align="right" /></a>
272302

273-
[![Learn More](https://img.shields.io/badge/learn%20more-success.svg?style=for-the-badge)][commercial_support]
274-
275-
Work directly with our team of DevOps experts via email, slack, and video conferencing.
276-
277-
We deliver 10x the value for a fraction of the cost of a full-time engineer. Our track record is not even funny. If you want things done right and you need it done FAST, then we're your best bet.
278-
279-
- **Reference Architecture.** You'll get everything you need from the ground up built using 100% infrastructure as code.
280-
- **Release Engineering.** You'll have end-to-end CI/CD with unlimited staging environments.
281-
- **Site Reliability Engineering.** You'll have total visibility into your apps and microservices.
282-
- **Security Baseline.** You'll have built-in governance with accountability and audit logs for all changes.
283-
- **GitOps.** You'll be able to operate your infrastructure via Pull Requests.
284-
- **Training.** You'll receive hands-on training so your team can operate what we build.
285-
- **Questions.** You'll have a direct line of communication between our teams via a Shared Slack channel.
286-
- **Troubleshooting.** You'll get help to triage when things aren't working.
287-
- **Code Reviews.** You'll receive constructive feedback on Pull Requests.
288-
- **Bug Fixes.** We'll rapidly work with you to fix any bugs in our projects.
289-
290-
[![README Commercial Support][readme_commercial_support_img]][readme_commercial_support_link]
303+
[Join us every Wednesday via Zoom](https://cloudposse.com/office-hours?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=office_hours) for your weekly dose of insider DevOps trends, AWS news and Terraform insights, all sourced from our SweetOps community, plus a _live Q&A_ that you can’t find anywhere else.
304+
It's **FREE** for everyone!
291305
## License
292306

293-
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
307+
<a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge" alt="License"></a>
308+
309+
<details>
310+
<summary>Preamble to the Apache License, Version 2.0</summary>
311+
<br/>
312+
<br/>
294313

295-
See [LICENSE](LICENSE) for full details.
314+
Complete license is available in the [`LICENSE`](LICENSE) file.
296315

297316
```text
298317
Licensed to the Apache Software Foundation (ASF) under one
@@ -312,34 +331,17 @@ KIND, either express or implied. See the License for the
312331
specific language governing permissions and limitations
313332
under the License.
314333
```
334+
</details>
315335

316336
## Trademarks
317337

318338
All other trademarks referenced herein are the property of their respective owners.
339+
340+
319341
---
320-
Copyright © 2017-2023 [Cloud Posse, LLC](https://cpco.io/copyright)
321-
[![README Footer][readme_footer_img]][readme_footer_link]
322-
[![Beacon][beacon]][website]
323-
<!-- markdownlint-disable -->
324-
[logo]: https://cloudposse.com/logo-300x69.svg
325-
[docs]: https://cpco.io/docs?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=docs
326-
[website]: https://cpco.io/homepage?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=website
327-
[github]: https://cpco.io/github?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=github
328-
[jobs]: https://cpco.io/jobs?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=jobs
329-
[hire]: https://cpco.io/hire?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=hire
330-
[slack]: https://cpco.io/slack?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=slack
331-
[twitter]: https://cpco.io/twitter?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=twitter
332-
[office_hours]: https://cloudposse.com/office-hours?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=office_hours
333-
[newsletter]: https://cpco.io/newsletter?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=newsletter
334-
[email]: https://cpco.io/email?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=email
335-
[commercial_support]: https://cpco.io/commercial-support?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=commercial_support
336-
[we_love_open_source]: https://cpco.io/we-love-open-source?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=we_love_open_source
337-
[terraform_modules]: https://cpco.io/terraform-modules?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=terraform_modules
338-
[readme_header_img]: https://cloudposse.com/readme/header/img
339-
[readme_header_link]: https://cloudposse.com/readme/header/link?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=readme_header_link
340-
[readme_footer_img]: https://cloudposse.com/readme/footer/img
341-
[readme_footer_link]: https://cloudposse.com/readme/footer/link?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=readme_footer_link
342-
[readme_commercial_support_img]: https://cloudposse.com/readme/commercial-support/img
343-
[readme_commercial_support_link]: https://cloudposse.com/readme/commercial-support/link?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=readme_commercial_support_link
344-
[beacon]: https://ga-beacon.cloudposse.com/UA-76589703-4/cloudposse/github-action-atmos-terraform-plan?pixel&cs=github&cm=readme&an=github-action-atmos-terraform-plan
345-
<!-- markdownlint-restore -->
342+
Copyright © 2017-2024 [Cloud Posse, LLC](https://cpco.io/copyright)
343+
344+
345+
<a href="https://cloudposse.com/readme/footer/link?utm_source=github&utm_medium=readme&utm_campaign=cloudposse/github-action-atmos-terraform-plan&utm_content=readme_footer_link"><img alt="README footer" src="https://cloudposse.com/readme/footer/img"/></a>
346+
347+
<img alt="Beacon" width="0" src="https://ga-beacon.cloudposse.com/UA-76589703-4/cloudposse/github-action-atmos-terraform-plan?pixel&cs=github&cm=readme&an=github-action-atmos-terraform-plan"/>

0 commit comments

Comments
 (0)