aws-cdk 2.1016.0 → 2.1017.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -30,6 +30,7 @@ The AWS CDK Toolkit provides the `cdk` command-line interface that can be used t
30
30
  | [`cdk acknowledge`](#cdk-acknowledge) | Acknowledge (and hide) a notice by issue number |
31
31
  | [`cdk notices`](#cdk-notices) | List all relevant notices for the application |
32
32
  | [`cdk refactor`](#cdk-refactor) | Moves resources between stacks or within the same stack |
33
+ | [`cdk drift`](#cdk-drift) | Detect drifts in the given CloudFormation stack(s) |
33
34
 
34
35
  - [Bundling](#bundling)
35
36
  - [MFA Support](#mfa-support)
@@ -1191,6 +1192,29 @@ If you want to undo a refactor, you can use the `--revert` option in
1191
1192
  conjunction with the `--mapping-file` option. It will apply the mapping in
1192
1193
  reverse order (source becomes destination and vice versa).
1193
1194
 
1195
+ ### `cdk drift`
1196
+
1197
+ Checks if there is any drift in your stack or stacks. If you need the command
1198
+ to return a non-zero if any differences are found, you need to use the `--fail`
1199
+ command line option.
1200
+
1201
+ ```console
1202
+ $ # Detect drift against the currently-deployed stack
1203
+ $ cdk drift
1204
+
1205
+ $ # Detect drift against a specific stack
1206
+ $ cdk drift MyStackName
1207
+ ```
1208
+
1209
+ Note that there are some resources that do not support drift detection. You can
1210
+ see which of these resources were left unchecked with the `--verbose` command line
1211
+ option.
1212
+
1213
+ ```console
1214
+ $ # Detect drift against the currently-deployed stack with the verbose flag enabled
1215
+ $ cdk drift --verbose
1216
+ ```
1217
+
1194
1218
  ## Notices
1195
1219
 
1196
1220
  CDK Notices are important messages regarding security vulnerabilities, regressions, and usage of unsupported