cdk rollback - AWS Cloud Development Kit (AWS CDK) v2
使用量参数选项

这是 AWS CDK v2 开发者指南。较旧的 CDK v1 于 2022 年 6 月 1 日进入维护阶段，并于 2023 年 6 月 1 日终止支持。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

cdk rollback

使用 AWS Cloud Development Kit (AWS CDK) 命令行界面（CLI）cdk rollback 命令将失败或暂停的堆栈从 AWS CloudFormation 部署回滚到其最后的稳定状态。

注意

要使用此命令，环境中必须部署了 v23 引导模板。有关更多信息，请参阅 引导模板版本历史记录。

使用 cdk deploy 部署时，默认情况下，CDK CLI 将回滚失败的部署。如果使用 cdk deploy 来指定 --no-rollback，则可以使用 cdk rollback 命令手动回滚失败的部署。这将启动回滚到堆栈的最后稳定状态。

使用量

$ cdk rollback <arguments> <options>

参数

CDK 堆栈 ID

应用程序中要回滚的 CDK 堆栈的构造 ID。

类型：字符串

必需：否

选项

有关适用于所有 CDK CLI 命令的全局选项的列表，请参阅全局选项。

--all BOOLEAN

回滚 CDK 应用程序中的所有堆栈。

默认值：false

--force, -f BOOLEAN

使用 cdk rollback 时，某些资源可能无法回滚。提供此选项可强制回滚所有资源。这与为堆栈中的每个资源提供 --orphan 选项的行为相同。

默认值：false

--help, -h BOOLEAN

显示 cdk rollback 命令的命令参考信息。

--orphan LogicalId

使用 cdk rollback 时，某些资源可能无法回滚。发生这种情况时，您可以使用此选项并提供回滚失败的资源的逻辑 ID 来尝试强制回滚资源。

可以在单个命令中多次提供此选项。以下是示例：

$ cdk rollback MyStack --orphan MyLambdaFunction --orphan MyLambdaFunction2

要强制回滚所有资源，请改用 --force 选项。

--toolkit-stack-name STRING

用于引导环境的现有 CDK Toolkit 堆栈的名称。

默认情况下，cdk bootstrap 会将名为 CDKToolkit 的堆栈部署到指定的 AWS 环境中。使用此选项可为引导堆栈提供不同的名称。

CDK CLI 使用此值来验证引导堆栈版本。

--validate-bootstrap-version BOOLEAN

指定是否验证引导堆栈版本。提供 --validate-bootstrap-version=false 或 --no-validate-bootsrap-version 来关闭这种行为。

默认值：true