OpsCanary
awscdk cfnPractitioner

Mastering AWS CloudFormation StackSets: Tracking Deployment Progress Like a Pro

5 min read AWS DevOps BlogNov 20, 2026Reviewed for accuracy
Share
Practitioner — Hands-on experience recommended

In a multi-account AWS environment, managing deployments can become a complex task. AWS CloudFormation StackSets help simplify this by enabling you to deploy the same template across multiple accounts and regions in one go. However, understanding the deployment's progress is essential to ensure everything is on track. The new progress visibility feature addresses this need by providing a detailed, stage-by-stage view of each stack set operation, highlighting which accounts and stack instances require your attention.

When you initiate a stack set operation, you can monitor its overall status as before. The addition of deployment progress means you now have access to granular details under StatusDetails.Stages in the DescribeStackSetOperation and ListStackSetOperations responses. This includes information on each stage of the operation, separate from the overall status. For example, you can see how many accounts have succeeded, failed, or are still pending. This level of detail is invaluable for troubleshooting and ensuring that deployments are proceeding smoothly.

In production, utilizing this progress visibility can significantly enhance your operational efficiency. You can quickly identify bottlenecks or failures in specific accounts or regions, allowing for faster remediation. However, be cautious—if you have a large number of accounts or stack instances, the complexity can increase. Always monitor the specific stage statuses to avoid missing critical updates. The official docs don't call out specific anti-patterns here. Use your judgment based on your scale and requirements.

Key takeaways

  • →Leverage deployment progress to gain visibility into each stack set operation.
  • →Use the `DescribeStackSetOperation` command to access detailed stage statuses.
  • →Monitor `StatusDetails.Stages` for insights into account and stack instance performance.
  • →Identify and address bottlenecks quickly with real-time progress updates.
  • →Separate stage statuses from overall operation status for better clarity.

Why it matters

In production, having real-time visibility into deployment progress can drastically reduce downtime and improve response times to issues. This is crucial for maintaining service reliability across multiple accounts.

Code examples

Bash
aws cloudformation describe-stack-set-operation \
    --stack-set-name demo-operation-progress-visibility \
    --operation-id 01234567-890a-bcde-f012-34567890abcd
JSON
1{
2  "StackSetOperation": {          
3    "OperationId": "01234567-890a-bcde-f012-34567890abcd",
4    "Action": "CREATE",
5    "Status": "RUNNING",
6    "StatusDetails": {
7      "Stages": {
8        "RoleProvisioning": {
9          "Status": "SUCCEEDED",
10          "SucceededAccountsCount": 240,
11          "FailedAccountsCount": 0,
12          "PendingAccountsCount": 0,
13          "CompletedAccountsCount": 240,
14          "PercentageCompleted": 100
15        },
16        "StackInstancesDeployment": {
17          "Status": "IN_PROGRESS",
18          "SucceededStackInstancesCount": 651,
19          "FailedStackInstancesCount": 0,
20          "PendingStackInstancesCount": 69,
21          "CompletedStackInstancesCount": 651,
22          "SkippedStackInstancesCount": 0,
23          "CancelledStackInstancesCount": 0,
24          "PercentageCompleted": 90.4
25        }
26      },
27      "TotalAccountsCount": 240,
28      "TotalStackInstancesCount": 720,
29      "FailedStackInstancesCount": 0
30    },
31    "RegionalStatusDetails": {
32      "eu-west-1": {
33        "Stages": {
34          "RegionalStackInstancesDeployment": {
35            "Status": "IN_PROGRESS",
36            "SucceededStackInstancesCount": 235,
37            "FailedStackInstancesCount": 0

When NOT to use this

The official docs don't call out specific anti-patterns here. Use your judgment based on your scale and requirements.

Want the complete reference?

Read official docs

Test what you just learned

Quiz questions written from this article

Take the quiz →
DigitalOceanSponsor

Simple, affordable cloud — VMs, Kubernetes, and managed databases in minutes. Trusted by 600,000+ developers. Spin up a Droplet in 60 seconds.

Try DigitalOcean →

Get the daily digest

One email. 5 articles. Every morning.

No spam. Unsubscribe anytime.