How to use Atmos
Getting Started
To use Atmos we recommend interacting with the atmos command via geodesic.
info
Run all the following commands in the geodesic container from the Project root. e.g the infrastructure repository. To run the geodesic shell run make run from the project root.
The following assumes <component> is a folder that exists in <ProjectDir>/components/terraform/that contains .tf files to be applied.
e.g. ecr, dns-primary, accounts are examples of components.
And that a <stack> is the name of a stack that exists in <ProjectDir/stacks/ with .yaml not included.
e.g. gbl-security, uw2-audit are examples of stacks
Terraform
terraform plan
atmos terraform plan <component> -s <stack>
terraform apply
atmos terraform apply <component> -s <stack>
terraform destroy
atmos terraform destroy <component> -s <stack>
terraform force-unlock
cd components/terraform/<component>
terraform force-unlock -force <LockID>
cd ../../../
terraform apply -auto-approve
This command is used for planning and applying in the same command.
atmos terraform deploy <component> -s <stack>
Related Guides
- How to use Spacectl
- How to Scale Spacelift Runners
- How to Upgrade Atmos
- How to Upgrade or Install Versions of Terraform
- How to Manage Terraform Dependencies in Micro-service Repositories
- How to Keep Everything Up to Date
- How to Use Terraform Remote State
- How to Manage Explicit Component Dependencies with Spacelift
- How to Switch Versions of Terraform
- How to support GovCloud and Other AWS Partitions with Terraform
- How to Sign Up for Spacelift
- How to Enable Spacelift Drift Detection
- How to Use Multiple Infrastructure Repositories with Spacelift?
- How to terraform non-AWS infrastructure?
- How to use Atmos