atmos aws cloudformation watch
Attach to a stack's operation and stream its events until the stack reaches
a terminal status — whether that operation is currently in progress,
already finished, or was started outside Atmos entirely (the AWS Console, a
CI pipeline running raw aws cloudformation, another teammate's terminal).
This is distinct from
apply/deploy/delete's
automatic inline streaming, which only covers the operation that command
itself just started.
Usage
atmos aws cloudformation watch <component> --stack <stack> [options]
atmos aws cloudformation watch vpc -s plat-ue2-dev
Watch all or affected components in dependency order:
atmos aws cloudformation watch --all -s plat-ue2-dev
atmos aws cloudformation watch --affected --base origin/main
Flags
--stack,-s(required)- Atmos stack.
--all(optional)- Watch all
aws/cloudformationcomponents in dependency order. --affected(optional)- Watch affected
aws/cloudformationcomponents and their dependencies. --include-dependents(optional)- With
--affected, include dependentaws/cloudformationcomponents. --tags(optional)- Filter by tags (comma-separated, matches any):
--tags=production,tier-1. Composes with--all/--affectedto narrow the selected set further; cannot be combined with a single component argument. --labels(optional)- Filter by labels (comma-separated
key=valueorkey:valuepairs, matches all):--labels=cost-center=platform,compliance=sox. Composes with--all/--affected/--tags; cannot be combined with a single component argument.
Behavior
If the stack ends in a failed status, watch exits non-zero, the same
failure signal apply/delete give when the operation they started fails.
