Improve error message for early validation failures

gshpychka · web-flow · commit 012f94014bbd · 2025-12-15T19:33:11.000+02:00
Clarified error message for early validation failures in deployments.
diff --git a/packages/@aws-cdk/toolkit-lib/lib/api/deployments/early-validation.ts b/packages/@aws-cdk/toolkit-lib/lib/api/deployments/early-validation.ts
@@ -26,7 +26,8 @@ export class EarlyValidationReporter implements ValidationReporter {
 
       return `The template cannot be deployed because of early validation errors, but retrieving more details about those
 errors failed (${error}). Make sure you have permissions to call the DescribeEvents API, or re-bootstrap
-your environment with the latest version of the CLI (need at least version 30, current version ${currentVersion ?? 'unknown'}).`;
+your environment by running 'cdk bootstrap' to update the Bootstrap CDK Toolkit stack.
+Bootstrap toolkit stack version 30 or later is needed; current version: ${currentVersion ?? 'unknown'}).`;
     }
 
     let message = `ChangeSet '${changeSetName}' on stack '${stackName}' failed early validation`;

Original file line number	Diff line number	Diff line change
`@@ -26,7 +26,8 @@ export class EarlyValidationReporter implements ValidationReporter {`
`26`	`26`
`27`	`27`	return `The template cannot be deployed because of early validation errors, but retrieving more details about those
`28`	`28`	`errors failed (${error}). Make sure you have permissions to call the DescribeEvents API, or re-bootstrap`
`29`		-your environment with the latest version of the CLI (need at least version 30, current version ${currentVersion ?? 'unknown'}).`;
	`29`	`+your environment by running 'cdk bootstrap' to update the Bootstrap CDK Toolkit stack.`
	`30`	+Bootstrap toolkit stack version 30 or later is needed; current version: ${currentVersion ?? 'unknown'}).`;
`30`	`31`	`}`
`31`	`32`
`32`	`33`	let message = `ChangeSet '${changeSetName}' on stack '${stackName}' failed early validation`;