Skip to content

Conversation

@goruha
Copy link
Contributor

@goruha goruha commented Aug 20, 2025

what

  • Update README.yaml

why

  • Use atmos to generate readme

Summary by CodeRabbit

  • Documentation

    • Added a comprehensive repository guidelines document covering structure, commands, style, testing, PR process, and security tips.
    • Expanded main README with badges, auto-generated sections (Requirements, Providers, Modules, Resources, Inputs/Outputs), and detailed Terraform test instructions.
    • Updated component documentation with refreshed provider/module versions and formatting; adjusted branding placement.
  • Chores

    • Ignored .cache and .atmos directories in version control.
    • Added Atmos configuration to enable shared commands and automated README generation.
    • Removed remote build harness integration and built-in test target from the build workflow.

@goruha goruha added the auto-update This PR was automatically generated label Aug 20, 2025
@goruha goruha requested a review from a team as a code owner August 20, 2025 09:07
@goruha goruha added no-release Do not create a new release (wait for additional code changes) migration This PR involves a migration labels Aug 20, 2025
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Aug 20, 2025

Walkthrough

Adds repo config for Atmos and git ignores, removes Makefile harness/test targets, and updates documentation: new AGENTS.md, expanded root README, and refreshed src/README module docs with updated provider/module versions.

Changes

Cohort / File(s) Summary of changes
Repo config and tooling
atmos.yaml, .gitignore, Makefile
New Atmos config importing shared settings; ignore .cache and .atmos; removed remote build-harness include, default all, and test targets.
Root documentation
README.md, AGENTS.md
Expanded README with autogenerated sections and test instructions; added AGENTS.md with repository guidelines, commands, style, testing, PR/commit and security notes.
Module documentation
src/README.md
Updated providers/modules versions and sources; formatting/anchors adjusted; branding placement changed; disabled markdownlint in section.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Poem

A nibble of docs, a sprinkle of YAML delight,
I thump out rhythms in the build’s soft light.
Makefile trimmed, new trails to traverse,
Atmos breezes guide our verse.
Cache burrows hidden, readme fields bloom—
Hop, hop! This repo finds its room. 🥕🐇

Tip

🔌 Remote MCP (Model Context Protocol) integration is now available!

Pro plan users can now connect to remote MCP servers from the Integrations page. Connect with popular remote MCPs such as Notion and Linear to add more context to your reviews and chats.

✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch migration/20251908

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@mergify mergify bot requested review from a team August 20, 2025 09:08
@mergify
Copy link

mergify bot commented Aug 20, 2025

Important

Do not edit the README.md directly. It's auto-generated from the README.yaml

Please update the README.yaml file instead.

Could you fix it @goruha? 🙏

@mergify
Copy link

mergify bot commented Aug 20, 2025

Important

Cloud Posse Engineering Team Review Required

This pull request modifies files that require Cloud Posse's review. Please be patient, and a core maintainer will review your changes.

To expedite this process, reach out to us on Slack in the #pr-reviews channel.

@mergify mergify bot added the needs-cloudposse Needs Cloud Posse assistance label Aug 20, 2025
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
src/README.md (1)

63-141: Remove duplicated “Requirements/Providers/Modules/Resources/Inputs/Outputs” block (stale content)

This section duplicates information that is re-generated below (Lines 143–233) and contains older versions (e.g., aws >= 2.0 vs >= 4.9.0). Keep only the auto-generated block to avoid drift.

Proposed removal:

-## Requirements
-
-| Name      | Version   |
-| --------- | --------- |
-| terraform | >= 0.13.0 |
-| aws       | >= 2.0    |
-| datadog   | >= 3.3.0  |
-| local     | >= 1.3    |
-
-## Providers
-
-| Name    | Version  |
-| ------- | -------- |
-| aws     | >= 2.0   |
-| datadog | >= 3.7.0 |
-| http    | >= 2.1.0 |
-
-## Modules
-
-| Name                 | Source                              | Version |
-| -------------------- | ----------------------------------- | ------- |
-| cloudtrail           | cloudposse/cloudtrail/aws           | 0.21.0  |
-| cloudtrail_s3_bucket | cloudposse/cloudtrail-s3-bucket/aws | 0.23.1  |
-| iam_roles            | ../account-map/modules/iam-roles    | n/a     |
-| s3_bucket            | cloudposse/s3-bucket/aws            | 0.46.0  |
-| this                 | cloudposse/label/null               | 0.25.0  |
-
-## Resources
-
-| Name                                    | Type        |
-| --------------------------------------- | ----------- |
-| aws_caller_identity.current             | data source |
-| aws_partition.current                   | data source |
-| aws_ssm_parameter.datadog_api_key       | data source |
-| aws_ssm_parameter.datadog_app_key       | data source |
-| aws_ssm_parameter.datadog_aws_role_name | data source |
-| aws_ssm_parameter.datadog_external_id   | data source |
-| datadog_logs_archive.catchall_archive   | resource    |
-| datadog_logs_archive.logs_archive       | resource    |
-| http.current_order                      | data source |
-
-## Inputs
-... (remove the entire duplicated Inputs table)
-
-## Outputs
-... (remove the entire duplicated Outputs table)
README.md (1)

85-155: Remove duplicated, non-generated “Requirements/Providers/Modules/Resources/Inputs/Outputs”

This manual block duplicates the auto-generated docs added later (Lines 185–275) and will drift. Keep the generated block only.

Proposed removal:

-## Requirements
-... (remove the entire manual sections for Requirements/Providers/Modules/Resources/Inputs/Outputs here)
-## References
-... (keep References if still desired after generated block, otherwise relocate below)
🧹 Nitpick comments (6)
atmos.yaml (1)

9-11: Pin remote Atmos import to a tag or commit SHA for reproducibility

Importing from refs/heads/main risks unplanned changes when upstream updates. Pin to a release tag or specific commit to make doc generation deterministic.

Apply this diff once you decide the exact version/tag:

-import:
-  - https://raw.githubusercontent.com/cloudposse-terraform-components/.github/refs/heads/main/.github/atmos/terraform-component.yaml
+import:
+  # Pin to a tag or commit for reproducibility
+  - https://raw.githubusercontent.com/cloudposse-terraform-components/.github/<tag-or-sha>/.github/atmos/terraform-component.yaml
src/README.md (1)

238-239: Add alt text to the footer logo image (accessibility, MD045)

The tag lacks alt. Add descriptive alt text to satisfy markdownlint and improve accessibility.

-[<img src="https://cloudposse.com/logo-300x69.svg" height="32" align="right"/>](https://cpco.io/homepage?utm_source=github&utm_medium=readme&utm_campaign=cloudposse-terraform-components/aws-datadog-logs-archive&utm_content=)
+[<img src="https://cloudposse.com/logo-300x69.svg" height="32" align="right" alt="Cloud Posse"/>](https://cpco.io/homepage?utm_source=github&utm_medium=readme&utm_campaign=cloudposse-terraform-components/aws-datadog-logs-archive&utm_content=)
README.md (1)

170-174: Add alt text to demo image for accessibility

The demo GIF lacks alt text. Add alt to satisfy accessibility and typical markdownlint rules.

-<img src="https://github.com/cloudposse/atmos/blob/main/docs/demo.gif?raw=true"/><br/>
+<img src="https://github.com/cloudposse/atmos/blob/main/docs/demo.gif?raw=true" alt="Atmos demo animation"/><br/>
AGENTS.md (3)

10-12: Rewrite bare URL and improve grammar

  • Use a proper Markdown link instead of a bare URL (MD034).
  • Grammar: “To install Atmos, read these docs …”
-## Build, Test, and Development Commands
-- To install atmos read this docs https://github.com/cloudposse/atmos
+## Build, Test, and Development Commands
+- To install Atmos, read these docs: [github.com/cloudposse/atmos](https://github.com/cloudposse/atmos)

12-16: Tighten wording and capitalization for consistency

Minor editorial fixes to readme generation and pre-commit lines.

-- `atmos docs generate readme`: Regenerate `README.md` from `README.yaml` and terraform source.
-- `atmos docs generate readme-simple`: Regenerate `src/README.md` from `README.yaml` and terraform source.
+- `atmos docs generate readme`: Regenerate `README.md` from `README.yaml` and Terraform source.
+- `atmos docs generate readme-simple`: Regenerate `src/README.md` from `README.yaml` and Terraform source.
 ...
-- Pre-commit locally: `pre-commit install && pre-commit run -a` (runs `terraform_fmt`, `terraform_docs`, `tflint`).
+- Pre-commit locally: `pre-commit install && pre-commit run -a` (runs `terraform_fmt`, `terraform_docs`, and `tflint`).

24-27: Clarify tests cleanup/cost note and naming convention

Add a brief caution re: AWS costs and cleanup to reduce surprises.

-- Run: `atmos test run`. Ensure AWS credentials are configured; tests may incur AWS costs and will clean up after themselves.
+- Run: `atmos test run`. Ensure AWS credentials are configured. Tests create real AWS resources, may incur costs, and will attempt cleanup on completion.
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 1737dc0 and 20efc91.

📒 Files selected for processing (6)
  • .gitignore (1 hunks)
  • AGENTS.md (1 hunks)
  • Makefile (0 hunks)
  • README.md (3 hunks)
  • atmos.yaml (1 hunks)
  • src/README.md (2 hunks)
💤 Files with no reviewable changes (1)
  • Makefile
🧰 Additional context used
🪛 LanguageTool
AGENTS.md

[grammar] ~10-~10: There might be a mistake here.
Context: ...## Build, Test, and Development Commands - To install atmos read this docs https://...

(QB_NEW_EN)


[grammar] ~12-~12: There might be a mistake here.
Context: ...from README.yaml and terraform source. - atmos docs generate readme-simple: Regenerate src/README.md from `READM...

(QB_NEW_EN)


[grammar] ~13-~13: There might be a mistake here.
Context: ...from README.yaml and terraform source. - atmos test run: Run Terratest suite in test/ (uses A...

(QB_NEW_EN)


[grammar] ~14-~14: There might be a mistake here.
Context: ...d terraform source. - atmos test run: Run Terratest suite in test/ (uses Atmos ...

(QB_NEW_EN)


[grammar] ~14-~14: There might be a mistake here.
Context: ...es; creates and destroys AWS resources). - Pre-commit locally: `pre-commit install ...

(QB_NEW_EN)


[grammar] ~15-~15: There might be a mistake here.
Context: ...aform_fmt, terraform_docs, tflint). - TFLint plugin setup: tflint --init` (us...

(QB_NEW_EN)


[grammar] ~20-~20: There might be a mistake here.
Context: ...ed with Cloud Posse null-label patterns. - Lint/format: terraform fmt -recursive,...

(QB_NEW_EN)


[grammar] ~28-~28: There might be a mistake here.
Context: ...es. ## Commit & Pull Request Guidelines - Commits: follow Conventional Commits (e....

(QB_NEW_EN)

README.md

[grammar] ~188-~188: There might be a mistake here.
Context: ... --> ## Requirements | Name | Version | |------|---------| | <a name="requiremen...

(QB_NEW_EN)


[grammar] ~189-~189: There might be a mistake here.
Context: ...s | Name | Version | |------|---------| | [...

(QB_NEW_EN)


[grammar] ~190-~190: There might be a mistake here.
Context: ...](#requirement_terraform) | >= 0.13.0 | | [aws](#...

(QB_NEW_EN)


[grammar] ~191-~191: There might be a mistake here.
Context: ...#requirement_aws) | >= 4.9.0, < 6.0.0 | | [da...

(QB_NEW_EN)


[grammar] ~192-~192: There might be a mistake here.
Context: ...adog](#requirement_datadog) | >= 3.19 | | [http]...

(QB_NEW_EN)


[grammar] ~197-~197: There might be a mistake here.
Context: ....1.0 | ## Providers | Name | Version | |------|---------| | <a name="provider_a...

(QB_NEW_EN)


[grammar] ~198-~198: There might be a mistake here.
Context: ...s | Name | Version | |------|---------| | [aws](#pro...

(QB_NEW_EN)


[grammar] ~199-~199: There might be a mistake here.
Context: ...s](#provider_aws) | >= 4.9.0, < 6.0.0 | | [datad...

(QB_NEW_EN)


[grammar] ~200-~200: There might be a mistake here.
Context: ...datadog](#provider_datadog) | >= 3.19 | | [http](#p...

(QB_NEW_EN)


[grammar] ~242-~242: There might be a mistake here.
Context: ... 'dev', 'UAT' | string | null | no | | [...

(QB_NEW_EN)


[grammar] ~245-~245: There might be a mistake here.
Context: ...resent. | list(string) | null | no | | ...

(QB_NEW_EN)


[grammar] ~250-~250: There might be a mistake here.
Context: ...obally unique | string | null | no | | <a name="input_object_lock_days_archiv...

(QB_NEW_EN)


[grammar] ~251-~251: There might be a mistake here.
Context: ... buckets in days | number | 7 | no | | <a name="input_object_lock_days_cloudt...

(QB_NEW_EN)


[grammar] ~252-~252: There might be a mistake here.
Context: ... buckets in days | number | 7 | no | | <a name="input_object_lock_mode_archiv...

(QB_NEW_EN)


[grammar] ~254-~254: There might be a mistake here.
Context: ...NANCE | string | "COMPLIANCE" | no | | </...

(QB_NEW_EN)


[grammar] ~258-~258: There might be a mistake here.
Context: ...y', 'release' | string | null | no | | [tags](#inpu...

(QB_NEW_EN)


[grammar] ~363-~363: There might be a mistake here.
Context: ...ructure validation. Setup dependencies: - Install Atmos ([installation guide](http...

(QB_NEW_EN)

🪛 markdownlint-cli2 (0.17.2)
AGENTS.md

11-11: Bare URL used

(MD034, no-bare-urls)

src/README.md

238-238: Images should have alternate text (alt text)

(MD045, no-alt-text)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Summary
🔇 Additional comments (2)
.gitignore (1)

10-11: LGTM: Atmos/Cache ignores are appropriate

Adding .cache and .atmos is sensible given the new Atmos-based workflows. No concerns.

README.md (1)

382-383: Fix link to the imported Atmos config filename

README points to terraform-module.yaml while atmos.yaml imports terraform-component.yaml. Align the link to avoid confusion.

-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.
+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-component.yaml) file.

Please confirm which upstream file is intended and adjust both atmos.yaml and this link if needed. Consider pinning to a tag/commit for reproducibility, similar to the atmos.yaml suggestion.

@goruha goruha closed this Aug 20, 2025
@goruha goruha deleted the migration/20251908 branch August 20, 2025 09:50
@mergify mergify bot removed the needs-cloudposse Needs Cloud Posse assistance label Aug 20, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auto-update This PR was automatically generated migration This PR involves a migration no-release Do not create a new release (wait for additional code changes)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants