cdk rollback - AWS Cloud Development Kit (AWS CDK) v2
使用方法引数オプション

これは AWS CDK v2 デベロッパーガイドです。古い v1 CDK は 2022 年 6 月 1 日にメンテナンスを開始し、2023 年 6 月 1 日にサポートを終了しました。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

cdk rollback

AWS Cloud Development Kit (AWS CDK) コマンドラインインターフェイス (CLI) cdk rollback コマンドを使用して、障害が発生したスタックまたは一時停止したスタックを AWS CloudFormation デプロイから最後の安定状態にロールバックします。

注記

このコマンドを使用するには、v23 のブートストラップテンプレートを環境にデプロイする必要があります。詳細については、「ブートストラップテンプレートのバージョン履歴」を参照してください。

を使用してデプロイするとcdk deploy、 CDKCLI は、失敗したデプロイをデフォルトでロールバックします。--no-rollback で を指定するとcdk deploy、 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 を指定することで、リソースのロールバックを強制的に実行できます。

このオプションは、1 つのコマンドで複数回指定できます。以下に例を示します。

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

すべてのリソースのロールバックを強制するには、代わりに --forceオプションを使用します。

--toolkit-stack-name STRING

環境がブートストラップされている既存の CDK Toolkit スタックの名前。

デフォルトでは、 は指定された AWS 環境に という名前のスタックCDKToolkitをcdk bootstrapデプロイします。ブートストラップスタックに別の名前を指定するには、このオプションを使用します。

の CDK CLI はこの値を使用してブートストラップスタックのバージョンを検証します。

--validate-bootstrap-version BOOLEAN

ブートストラップスタックバージョンを検証するかどうかを指定します。この動作をオフに--no-validate-bootsrap-versionするには、 --validate-bootstrap-version=falseまたは を指定します。

デフォルト値: true