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.

Experimental

Configure CI Integration

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.

CI Configuration Reference

Subcommands

📄️ delete

Delete Terraform plan files from the configured storage backend.

📄️ download

Download a Terraform plan file from the configured storage backend.

📄️ list

List Terraform plan files from the configured storage backend.

📄️ show

Show metadata for a Terraform plan file from the configured storage backend.

📄️ upload

Upload a Terraform plan file to the configured storage backend.

Storage Backends

Atmos supports multiple storage backends for planfiles:

local/dir

Store planfiles on the local filesystem. Useful for development and single-machine workflows.

Default path: .atmos/planfiles/

aws/s3

Store planfiles in Amazon S3. Ideal for team workflows and cross-region access.

Configure via ATMOS_PLANFILE_BUCKET and ATMOS_PLANFILE_PREFIX environment variables.

github/artifacts

Store 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