atmos aws cloudformation stackset create

Create a CloudFormation StackSet (CreateStackSet) from the resolved kind: aws/stackset provision target's accounts/regions/ permission_model/role settings, plus the component's own template/parameters/capabilities/tags. When the target declares both accounts and regions, stackset create also creates the initial stack instances (CreateStackInstances) across that account/region matrix and waits for the operation to finish — the only verb that creates instances.

Experimental

atmos aws cloudformation stackset create --help

Usage

atmos aws cloudformation stackset create <component> --stack <stack> [options]

atmos aws cloudformation stackset create vpc -s plat-ue2-dev

Skip the interactive confirmation prompt:

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

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

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

Create StackSets for all or affected components in dependency order:

atmos aws cloudformation stackset create --all -s plat-ue2-dev
atmos aws cloudformation stackset create --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 create prompts for confirmation on a TTY before creating the StackSet.

--all (optional)

Create StackSets for all aws/cloudformation components in dependency order.

--affected (optional)

Create 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

If the resolved target declares only accounts or only regions (not both), stackset create stops after creating the StackSet itself — no instances are created. Creating instances later requires deleting and re-creating the StackSet with both fields set; there is no separate "add instances" verb.

The CreateStackInstances 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 create does not fire before/after hook events — only apply, diff, and delete do.