terraform stacks configuration watch reference

Use the terraform stacks configuration watch command to watch the deployment progress of a configuration version and display its current status, including deployment groups.

Usage

$ terraform stacks <global-stacks-flags> configuration watch <options>

Description

Watch the deployment progress of a Stack configuration version. This command displays the current status of the configuration, including its deployment groups.

Either -configuration-id must be provided, or -organization-name, -project-name, and -stack-name must be provided. If name arguments are used, the latest configuration for the specified Stack will be watched.

Options

-organization-name: The name of the organization to target.
- Optional when using -configuration-id, required when using name-based targeting.
- Data type: string.
- Overrides the ENV VAR TF_STACKS_ORGANIZATION_NAME if provided.
-project-name: The name of the project to target.
- Optional when using -configuration-id, required when using name-based targeting.
- Data type: string.
- Overrides the ENV VAR TF_STACKS_PROJECT_NAME if provided.
-stack-name: The name of the Stack to target.
- Optional when using -configuration-id, required when using name-based targeting.
- Data type: string.
- Overrides the ENV VAR TF_STACKS_STACK_NAME if provided.
-configuration-id: The ID of the configuration to watch.
- Optional (but required if not using -stack-name).
- Data type: string.
- Has precedence over the latest configuration of the stack provided in the -stack-name arg.

Examples

The following command watches a configuration by ID:

$ terraform stacks configuration watch -configuration-id config-abc123

The following command watches the latest configuration for a specific Stack:

$ terraform stacks configuration watch -organization-name my-org -project-name my-project -stack-name my-stack

Global flags

Refer to Global flags reference for information about flags you can use with all commands.