atmos terraform planfile
The atmos terraform planfile command group provides tools for managing Terraform planfiles. Store, retrieve, and share planfiles across CI/CD pipelines using local filesystem, S3, or GitHub Artifacts storage.
Learn how to configure CI/CD integration in your atmos.yaml, including setting up providers (like GitHub Actions), managing workflows, environment variables, and secrets for automated infrastructure pipelines.
Subcommands
Delete Terraform plan files from the configured storage backend.
Download a Terraform plan file from the configured storage backend.
List Terraform plan files from the configured storage backend.
Show metadata for a Terraform plan file from the configured storage backend.
Upload a Terraform plan file to the configured storage backend.
Storage Backends
Atmos supports multiple storage backends for planfiles:
local/dirStore planfiles on the local filesystem. Useful for development and single-machine workflows.
Default path:
.atmos/planfiles/aws/s3Store planfiles in Amazon S3. Ideal for team workflows and cross-region access.
Configure via
ATMOS_PLANFILE_BUCKETandATMOS_PLANFILE_PREFIXenvironment variables.github/artifactsStore planfiles as GitHub Actions artifacts. Perfect for GitHub-native CI/CD workflows.
Automatically detected when running in GitHub Actions.
Related
- CI Configuration - Configure CI integration in
atmos.yaml atmos terraform plan- Generate plans that can be uploaded- Native CI - CI/CD integration overview
