cdk diff - AWS Cloud Development Kit (AWS CDK) v2
用量引數選項範例

這是 AWS CDK v2 開發人員指南。較舊的 CDK v1 於 2022 年 6 月 1 日進入維護，並於 2023 年 6 月 1 日結束支援。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

cdk diff

執行 diff 以查看 AWS CDK 堆疊之間的基礎設施變更。

此命令通常用於比較本機CDK應用程式中堆疊目前狀態與已部署堆疊之間的差異。不過，您也可以將部署的堆疊與任何本機 AWS CloudFormation 範本進行比較。

用量

$ cdk diff <arguments> <options>

引數

CDK 堆疊 ID

您應用程式執行 diff 時CDK堆疊的建構 ID。

類型：字串

必要：否

選項

如需適用於所有 的全域選項清單 CDK CLI 命令，請參閱 全域選項。

--change-set BOOLEAN

指定是否建立變更集以分析資源替代。

當 時true， CDKCLI 會建立 AWS CloudFormation 變更集，以顯示將對堆疊所做的確切變更。此輸出包含要更新還是取代資源。的 CDK CLI 會使用部署角色而非查詢角色來執行此動作。

當 false時，會比較 CloudFormation 範本來執行更快速但不準確的差異。偵測到任何需要資源取代的屬性變更，都會顯示為資源取代，即使變更完全取代，例如以硬式編碼 取代資源參考ARN。

預設值：true

--context-lines NUMBER

要包含在任意 diff 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

僅因更廣泛的安全變更而有所差異。

預設值：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