Migrate from Legacy Actions
Move Terraform CI features from wrapper actions into Atmos itself. Native commands publish job summaries, outputs, checks, and pull request comments, and can store and verify planfiles between workflow stages.
Migration Steps
- Set up Atmos in the workflow and pin its version.
- Enable the features you need in CI configuration.
- Configure authentication and permissions. Review planfile storage before replacing a workflow that applies stored plans.
- Replace wrapper actions with the native equivalents below. Use the GitHub Actions guides for complete workflow examples.
- Run a pull request plan and verify its outputs, comments, checks, and stored plan before enabling deployment.
Native CI Equivalents
| Capability | Legacy action | Native CI replacement |
|---|---|---|
| Plan with job summary | cloudposse/github-action-atmos-terraform-plan | atmos terraform plan (writes to $GITHUB_STEP_SUMMARY) |
| Apply stored planfile | cloudposse/github-action-atmos-terraform-apply | atmos terraform apply / atmos terraform deploy |
| Affected stacks matrix | cloudposse/github-action-atmos-affected-stacks | atmos describe affected --format=matrix |
| Drift detection | cloudposse/github-action-atmos-terraform-drift-detection | Scheduled workflow running atmos terraform plan |
| Drift remediation | cloudposse/github-action-atmos-terraform-drift-remediation | atmos terraform deploy triggered from an issue |
| Update vendored components | cloudposse/github-action-atmos-component-updater | atmos vendor update --pull-request |
| Planfile storage | cloudposse/github-action-terraform-plan-storage (S3/Azure Blob + DynamoDB/CosmosDB) | Built-in planfile storage (S3, GitHub Artifacts, or local) |
| Read a setting | cloudposse/github-action-atmos-get-setting | atmos list settings --query / atmos describe component --query |
| Select components by query | cloudposse/github-action-atmos-terraform-select-components | atmos describe affected --format=matrix / atmos list components --query |
| Trigger Spacelift stacks | cloudposse/github-action-atmos-affected-trigger-spacelift | Native CI (the Spacelift integration itself is deprecated) |
The deprecated action documentation remains available for maintaining existing workflows during migration.
