docs: deprecate account-map and related components @milldr (#834)
Summary
Deprecate account-map, aws-teams, aws-team-roles, and legacy GitHub Actions GitOps in favor of Atmos Auth, AWS SSO Permission Sets, Atmos Pro, and RunsOn.
Site Structure
Getting Started/
├── Introduction
├── Quickstart (DIY)
└── Jumpstart Customers
Build Your Foundation/
├── Setup your project/
│ ├── Create Repository
│ ├── Toolbox
│ ├── Design Decisions/
│ └── Tutorials/
+│ └── Migrate from Account Map # NEW - migration guide
│
├── Manage Accounts/
│ ├── Accounts (index)
│ ├── Prepare AWS Organization
│ ├── Initialize Terraform Backend
│ ├── Deploy Accounts
+│ ├── Setup CloudTrail # NEW
-│ ├── Account Baseline # REMOVED
│ ├── FAQ
│ ├── Design Decisions/
│ └── Tutorials/
-│ ├── Cold Start # REMOVED
-│ ├── Deprecated Cold Start Components # REMOVED
-│ ├── Manual Configuration # REMOVED
+│ ├── Create Account Root Users # NEW
+│ ├── Legacy Account Map # NEW - reference for migration
│ ├── How to Add a New OU
│ ├── How to Add or Mirror a Region
│ ├── How to Adopt/Import Legacy Accounts
│ ├── How to Create and Setup AWS Accounts
│ ├── How to Create SuperAdmin User
│ ├── How to Delete AWS Accounts
│ ├── How to Manage Account Settings
│ ├── How to Register Pristine AWS Root Account
│ ├── How to Set Up AWS Email Notifications
│ └── Terraform S3 State
│
├── Identity and Authentication/
│ ├── Identity (index)
│ ├── Setup Identity Center (AWS SSO)
+│ ├── Centralize Root Access # NEW
│ ├── Deploy IAM Roles
+│ ├── Configure Atmos Auth # NEW - replaces Leapp
│ ├── Login to AWS
-│ ├── Centralized Terraform Access # REMOVED
-│ ├── FAQ # REMOVED
│ ├── Design Decisions/
-│ ├── Docs/ # REMOVED folder
-│ │ ├── AWS Access Control Architecture
-│ │ ├── AWS Access Control Evolution
-│ │ ├── AWS Access Control
-│ │ ├── AWS Restricting Admin Access
-│ │ └── Dynamic Terraform Roles
-│ ├── Optional/ # REMOVED folder
-│ │ └── AWS SAML
│ └── Tutorials/
+│ ├── Access Control Evolution # NEW (content from docs/)
+│ ├── AWS SAML # NEW (moved from optional/)
│ ├── How to Setup SAML Login from Office 365
-│ ├── Expanding IAM Roles # REMOVED
-│ ├── How to Create a Delegated Role # REMOVED
-│ ├── How to Easily Switch AWS Account Roles # REMOVED
-│ └── Leapp/ # REMOVED folder
-│ ├── Leapp
-│ └── How to Setup Windows
│
└── Network and DNS/
├── Network (index)
├── Deploy VPCs
├── Connect Network (Transit Gateway) # REWRITTEN
├── Access Network (VPN)
├── DNS Setup
├── FAQ
└── Design Decisions/
Set Up Your Platform/
├── Configure GitHub Actions/
│ ├── GitHub Actions (index)
│ ├── Design Decisions/
│ ├── GitHub OIDC with AWS
│ ├── Setup RunsOn # UPDATED - now primary option
+│ └── Tutorials/ # NEW folder
+│ ├── Philips Labs Runners # MOVED + deprecated notice
+│ └── EKS ARC Runners # MOVED + deprecated notice
-│ ├── Philips Labs GitHub Runners # MOVED to tutorials/
-│ └── EKS GitHub Actions Controller # MOVED to tutorials/
│
├── Orchestrate Containers/
│ ├── Use ECS/
│ └── Use EKS/
│
└── Automate Terraform (Atmos Pro)/
├── Atmos Pro (index)
├── Setup Atmos Pro # REWRITTEN
+ ├── Deploy with Terraform # NEW (was in tutorials/)
+ ├── Drift Detection # NEW
└── Tutorials/
- ├── Deploy with Terraform # MOVED up to main level
+ └── Migrate from GitHub Actions GitOps # NEW
Deploy Your Apps/
├── Provision Databases/
└── Implement CI/CD (Software Delivery)/
└── EKS with ArgoCD/
Monitor Everything/
├── Implement Telemetry/
│ ├── Datadog/
│ └── Grafana/
└── Security and Compliance/
GitOps/ # ALL PAGES DEPRECATED
├── GitOps (index) # + deprecation notice
├── Setup # + deprecation notice
├── Example Workflows # + deprecation notice
└── FAQ # + deprecation noticeLayer Changes Summary
| Layer | Added | Removed | Modified |
|---|---|---|---|
| Accounts | setup-cloudtrail, tutorials/create-account-root-users, tutorials/legacy-account-map | account-baseline, tutorials/cold-start, tutorials/deprecated-cold-start-components, tutorials/manual-configuration | accounts, deploy-accounts, initialize-tfstate, prepare-aws-organization, faq, how-to-create-superadmin-user |
| Identity | atmos-auth, centralized-root-access, tutorials/access-control-evolution, tutorials/aws-saml | centralized-terraform-access, faq, docs/, optional/, tutorials/expanding-iam-roles, tutorials/how-to-create-delegated-role, tutorials/how-to-easily-switch-roles, tutorials/leapp/* | identity, aws-sso, deploy, how-to-log-into-aws |
| Network | - | - | connect-network (rewritten), access-network, deploy-vpcs, dns-setup |
| GitHub Actions | tutorials/tutorials.mdx | - | runs-on, github-actions, design-decisions/decide-on-self-hosted-runner-architecture; MOVED: philips-labs-github-runners, eks-github-actions-controller → tutorials/ |
| Atmos Pro | deploy-with-terraform, drift-detection, tutorials/migrate-from-github-actions-gitops | tutorials/deploy-with-terraform (moved up) | atmos-pro, setup |
| GitOps | - | - | All pages get deprecation notices |
| Project | tutorials/migrate-from-account-map | - | toolbox |
Workflow Snippets
Updated examples/snippets/stacks/workflows/quickstart/:
quickstart/
├── app/
│ ├── app-on-ecs.yaml
│ └── app-on-eks-with-argocd.yaml
├── foundation/
│ ├── accounts.yaml # UPDATED (merged baseline)
+│ ├── atmos-pro.yaml # NEW (renamed from gitops.yaml)
-│ ├── baseline.yaml # REMOVED (merged into accounts)
-│ ├── github.yaml # REMOVED (OIDC → identity)
-│ ├── gitops.yaml # RENAMED → atmos-pro.yaml
│ ├── identity.yaml # UPDATED (added OIDC deployment)
+│ └── runs-on.yaml # NEW (runner deployment only)
├── monitor/
-│ └── compliance.yaml # RENAMED
+│ └── security-and-compliance.yaml # RENAMED from compliance.yaml
+├── network/ # NEW folder
+│ └── network.yaml # MOVED from foundation/
-├── foundation/network.yaml # MOVED → network/network.yaml
└── platform/
- └── argocd.yaml # RENAMED
+ └── software-delivery.yaml # RENAMED from argocd.yamlWhy
- Transition to Atmos Auth, AWS SSO Permission Sets, and Atmos Pro
- Simplify IAM architecture by removing aws-teams/aws-team-roles
- Better GitOps experience through Atmos Pro vs custom GitHub Actions
- RunsOn provides simpler self-hosted runners without Kubernetes dependency
- Workflow file naming aligns with docs site layer structure
References
♻️ docs: update Claude skills with improved vendoring docs and catalog patterns @cloudpossebot (#836)
[!IMPORTANT]
Do not merge this PR manually. It will be handled automatically by the cloudposse/refarch-scaffold repository.
Instead, please review the changes and merge cloudposse/refarch-scaffold#822
What
This pull request was created by the 🚀 Generate Examples workflow in the cloudposse/refarch-scaffold repository. This PR updates this documentation repo with the latest configuration for the Cloud Posse reference architecture.
Why
This documentation repo is used for reference purposes and should have the latest configuration.
References
Internal PR: cloudposse/refarch-scaffold#822
♻️ feat: Remove Account Map @cloudpossebot (#831)
[!IMPORTANT]
Do not merge this PR manually. It will be handled automatically by the cloudposse/refarch-scaffold repository.
Instead, please review the changes and merge cloudposse/refarch-scaffold#818
What
This pull request was created by the 🚀 Generate Examples workflow in the cloudposse/refarch-scaffold repository. This PR updates this documentation repo with the latest configuration for the Cloud Posse reference architecture.
Why
This documentation repo is used for reference purposes and should have the latest configuration.
References
Internal PR: cloudposse/refarch-scaffold#818
Fix HTML in terraform variable description @goruha (#835)
what
- Escape HTML for Terraform docs descriptions
why
- Fix the MDX compilation for docs. Specifically
aurora-postgres-resourcesandaurora-mysql-resources
references
Fix footer link wrapping and update label @osterman (#833)
what
- Prevent external link icons from wrapping to next line by adding
white-space: nowrapto footer links - Change footer label from "Reference" to "Reference Architecture"
why
- With ample screen real estate, link icons should stay on the same line as their text
- "Reference Architecture" is more descriptive and accurate than just "Reference"
references
- Addresses footer layout improvement for better visual consistency
♻️ Go Testing Framework @cloudpossebot (#830)
[!IMPORTANT]
Do not merge this PR manually. It will be handled automatically by the cloudposse/refarch-scaffold repository.
Instead, please review the changes and merge cloudposse/refarch-scaffold#817
What
This pull request was created by the 🚀 Generate Examples workflow in the cloudposse/refarch-scaffold repository. This PR updates this documentation repo with the latest configuration for the Cloud Posse reference architecture.
Why
This documentation repo is used for reference purposes and should have the latest configuration.
References
Internal PR: cloudposse/refarch-scaffold#817
Add llms.txt documentation support @osterman (#828)
what
- Added a new blog post detailing the implementation of the
llms.txtstandard. - This standard aims to make Cloud Posse documentation more accessible to AI assistants.
- The new blog post explains the purpose of
llms.txt, its benefits for users interacting with AI tools, and the technical implementation usingdocusaurus-plugin-llms.
why
- To improve the accuracy and relevance of AI-generated responses when users query about Cloud Posse tools and best practices.
- By providing curated content in machine-readable formats (
/llms.txtand/llms-full.txt), AI assistants can reference up-to-date documentation directly, rather than relying on potentially stale training data. - This aligns with the growing trend of AI integration in developer workflows and enhances developer velocity by providing faster, more precise information.
references
Contributors
osterman, goruha, and 2 other contributors