Skip to main content

atmos aws cloudformation stackset update

Update a CloudFormation StackSet's template, parameters, and capabilities (UpdateStackSet) from the component's current configuration, and wait for the update to propagate to every existing stack instance. stackset update never changes which accounts/regions have instances — that set is fixed at stackset create time.

Experimental
atmos aws cloudformation stackset update --help

Usage​

atmos aws cloudformation stackset update <component> --stack <stack> [options]
atmos aws cloudformation stackset update vpc -s plat-ue2-dev

Skip the interactive confirmation prompt:

atmos aws cloudformation stackset update vpc -s plat-ue2-dev --auto-approve

Disambiguate when the component declares more than one kind: aws/stackset target:

atmos aws cloudformation stackset update vpc -s plat-ue2-dev --target multi-account

Update StackSets for all or affected components in dependency order:

atmos aws cloudformation stackset update --all -s plat-ue2-dev
atmos aws cloudformation stackset update --affected --base origin/main

Flags​

--stack, -s (required)
Atmos stack.
--target (optional)
The kind: aws/stackset provision target to use. Required when more than one is declared.
--auto-approve (optional)
Skip the interactive confirmation prompt. Without it, stackset update prompts for confirmation on a TTY before updating the StackSet.
--all (optional)
Update StackSets for all aws/cloudformation components in dependency order.
--affected (optional)
Update StackSets for affected aws/cloudformation components and their dependencies.
--include-dependents (optional)
With --affected, include dependent aws/cloudformation components.
--tags (optional)
Filter by tags (comma-separated, matches any): --tags=production,tier-1. Composes with --all/--affected to narrow the selected set further; cannot be combined with a single component argument.
--labels (optional)
Filter by labels (comma-separated key=value or key:value pairs, matches all): --labels=cost-center=platform,compliance=sox. Composes with --all/--affected/--tags; cannot be combined with a single component argument.

Behavior​

The UpdateStackSet operation is polled every 3 seconds until it reaches a terminal status (SUCCEEDED/FAILED/STOPPED), and the command times out after 30 minutes if it hasn't.

note

stackset update does not fire before/after hook events — only apply, diff, and delete do.