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

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

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

cdk diff

diff を実行して、 AWS CDK スタック間のインフラストラクチャの変更を確認します。

このコマンドは通常、ローカルCDKアプリケーション内のスタックの現在の状態とデプロイされたスタックの違いを比較するために使用します。ただし、デプロイされたスタックを任意のローカル AWS CloudFormation テンプレートと比較することもできます。

使用方法

$ cdk diff <arguments> <options>

引数

CDK スタック ID

差分を実行するアプリケーションからのCDKスタックのコンストラクト ID。

型: 文字列

必須: いいえ

オプション

すべての で動作するグローバルオプションのリスト CDK CLI コマンドについては、「」を参照してくださいグローバルオプション。

--change-set BOOLEAN

リソースの置き換えを分析する変更セットを作成するかどうかを指定します。

の場合true、 CDKCLI は、スタックに加えられる正確な変更を表示する AWS CloudFormation 変更セットを作成します。この出力には、リソースを更新または置き換えるかどうかが含まれます。の CDK CLI は、ルックアップロールの代わりにデプロイロールを使用して、このアクションを実行します。

の場合false、 CloudFormation テンプレートを比較することで、より速く、精度の低い差分が実行されます。リソースの置き換えが必要なプロパティに変更が検出された場合は、リソースリファレンスをハードコードされた に置き換えるなど、変更が純粋に表面的な場合でも、リソースの置き換えとして表示されますARN。

デフォルト値: true

--context-lines NUMBER

任意のJSON差分レンダリングに含めるコンテキスト行の数。

デフォルト値: 3

--exclusively, -e BOOLEAN

diff がリクエストしたスタックのみであり、依存関係は含まれません。

--fail BOOLEAN

差異が検出され1た場合は、 のコードで失敗して終了します。

--help, -h BOOLEAN

cdk diff コマンドのコマンドリファレンス情報を表示します。

--processed BOOLEAN

変換が CloudFormation 既に処理されているテンプレートと比較するかどうかを指定します。

デフォルト値: false

--quiet, -q BOOLEAN

変更が検出されstdoutない場合は、CDKスタック名とデフォルトcdk diffメッセージを に印刷しないでください。

デフォルト値: false

--security-only BOOLEAN

拡張されたセキュリティ変更の diff のみ。

デフォルト値: false

--strict BOOLEAN

cdk diff 動作をより正確または厳密に変更します。true の場合、 CDKCLI は、AWS::CDK::Metadataリソースや読み取り不可能な文字ASCIIを除外しません。

デフォルト値: false

--template STRING

CDK スタックを比較する CloudFormation テンプレートへのパス。

例

という名前の現在デプロイされているスタックとの差異 MyStackName

$ cdk diff MyStackName --app='node bin/main.js'

特定の CloudFormation テンプレートとの差分

$ cdk diff MyStackName --app='node bin/main.js' --template-path='./MyStackNameTemplate.yaml'

ローカルスタックをデプロイされたスタックと差分します。変更が検出されない場合は、stdout に印刷しないでください。

$ cdk diff MyStackName --app='node bin/main.js' --quiet