atmos terraform deploy
Use this command to execute terraform apply -auto-approve
on an Atmos component in an Atmos stack.
Usage
Execute the terraform deploy
subcommand like this:
atmos terraform deploy <component> -s <stack>
atmos terraform deploy
command supports--deploy-run-init=true|false
flag to enable/disable runningterraform init
before executing the commandatmos terraform deploy
command automatically sets-auto-approve
flag when runningterraform apply
atmos terraform deploy
command supports--from-plan
flag. If the flag is specified, the command will use the planfile previously generated byatmos terraform plan
command instead of generating a new planfile, e.g.atmos terraform deploy <component> -s <stack> --from-plan
. Note that in this case, the planfile name is in the format supported by Atmos and is saved to the component's folderatmos terraform deploy
command supports--planfile
flag to specify the path to a planfile. The--planfile
flag should be used instead of the planfile argument in the nativeterraform apply <planfile>
command. For example, you can execute the commandatmos terraform plan <component> -s <stack> -out=<FILE>
, which will save the generated plan to a file on disk, and then execute the commandatmos terraform deploy <component> -s <stack> --planfile <FILE>
to apply the previously generated planfile
See all flags.
Run atmos terraform deploy --help
to see all the available options
Examples
atmos terraform deploy top-level-component1 --stack tenant1-ue2-dev
atmos terraform deploy top-level-component1 -s tenant1-ue2-dev --from-plan
atmos terraform deploy top-level-component1 -s tenant1-ue2-dev --planfile <path_to_planfile>
atmos terraform deploy infra/vpc -s tenant1-ue2-staging
atmos terraform deploy test/test-component -s tenant1-ue2-dev
atmos terraform deploy test/test-component-override-2 -s tenant2-ue2-prod
atmos terraform deploy test/test-component-override-3 -s tenant1-ue2-dev
Arguments
Argument | Description | Required |
---|---|---|
component | Atmos terraform component | yes |
Flags
Flag | Description | Alias | Required |
---|---|---|---|
--stack | Atmos stack | -s | yes |
--dry-run | Dry run | no | |
--deploy-run-init | Enable/disable running terraform init before executing the command | no | |
--from-plan | If the flag is specified, use the planfile previously generated by Atmos instead ofgenerating a new planfile . The planfile name is in the format supported by Atmosand is saved to the component's folder | no | |
--planfile | The path to a planfile. The --planfile flag should be used instead of the planfileargument in the native terraform apply <planfile> command | no |
The atmos terraform deploy
command supports all native terraform apply
options described
in Terraform apply options, with the exception that a planfile argument
can't be provided on the command line. To use a previously generated planfile, use the --from-plan
or --planfile
command-line flags