Skip to content

docs: next-gen component migration guide#887

Open
Benbentwo wants to merge 7 commits intomasterfrom
Benbentwo/nextgen-migration-guide
Open

docs: next-gen component migration guide#887
Benbentwo wants to merge 7 commits intomasterfrom
Benbentwo/nextgen-migration-guide

Conversation

@Benbentwo
Copy link
Member

what

  • Added new blog post explaining migration to next-gen components with Atmos Auth
  • Provides practical guidance on using Atmos mixins to update any component version
  • Includes side-by-side comparison of legacy vs. next-gen provider configurations
  • Contains step-by-step migration instructions and troubleshooting references

why

  • Documents the major improvements from Atmos Auth and account-map deprecation
  • Helps users understand the new authentication approach and how to upgrade components
  • Provides a clear migration path for both old and new component versions
  • Complements the existing account-map deprecation announcement with practical implementation guidance

references

New blog post explaining how to migrate components to use Atmos Auth and
the next-generation authentication approach, including practical guidance
on using Atmos mixins to update any component regardless of version.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Add "Why We Made These Changes" section explaining testability as the
driving force, and an info callout clarifying that all components remain
usable during the transition with providers.tf as the version indicator.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Restructure the blog post into two distinct migration paths:
1. Upgrading legacy infrastructure to Atmos Auth (forward migration)
2. Using new component versions on legacy infrastructure (bridge strategy)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…version

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add decision table for guide selection, Atmos Auth prerequisites,
precise generation definition, failure modes with sample errors,
Terraform state impact notes, CI/CD runner guidance, expanded
verification checklist, and dummy iam_roles module explanation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…n snippet

Note that cold start components have always used simple providers.
Add iam_role_arn_templates to the static account map example.
Remove standalone provider snippet from next-gen section.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Show how to use terraform.generate in stack config as an alternative
to per-component mixins, including versions_override.tf for migration.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant