cdk diff - AWS Cloud Development Kit (AWS CDK) v2
UtilisationArgumentsOptionsExemples

Ceci est le guide du AWS CDK développeur de la version 2. L'ancien CDK v1 est entré en maintenance le 1er juin 2022 et a pris fin le 1er juin 2023.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

cdk diff

Effectuez une comparaison pour voir les changements d'infrastructure entre les AWS CDK piles.

Cette commande est généralement utilisée pour comparer les différences entre l'état actuel des piles dans votre application CDK locale et les piles déployées. Toutefois, vous pouvez également comparer une pile déployée avec n'importe quel AWS CloudFormation modèle local.

Utilisation

$ cdk diff <arguments> <options>

Arguments

ID logique de la pile CDK

L'ID logique de la pile CDK de votre application pour effectuer une différence.

Type : chaîne

Obligatoire : non

Options

Pour obtenir la liste des options globales qui fonctionnent avec toutes les CLI commandes CDK, consultezOptions globales.

--change-set BOOLEAN

Spécifiez s'il faut créer un ensemble de modifications pour analyser les remplacements de ressources.

À true ce moment-là, le CDK CLI créera un ensemble de AWS CloudFormation modifications pour afficher les modifications exactes qui seront apportées à votre pile. Ce résultat indique si les ressources seront mises à jour ou remplacées. Le CDK CLI utilise le rôle de déploiement au lieu du rôle de recherche pour effectuer cette action.

Lorsquefalse, une différence plus rapide mais moins précise est effectuée en comparant des modèles. CloudFormation Toute modification détectée dans les propriétés nécessitant le remplacement de ressources sera affichée comme un remplacement de ressource, même si la modification est purement esthétique, comme le remplacement d'une référence de ressource par un ARN codé en dur.

Valeur par défaut : true

--context-lines NUMBER

Nombre de lignes de contexte à inclure dans un rendu différentiel JSON arbitraire.

Valeur par défaut : 3

--exclusively, -e BOOLEAN

Différenciez uniquement les piles demandées et n'incluez pas les dépendances.

--fail BOOLEAN

Échec et sortie avec un code indiquant 1 si des différences sont détectées.

--help, -h BOOLEAN

Afficher les informations de référence relatives à la cdk diff commande.

--processed BOOLEAN

Spécifiez s'il faut effectuer une comparaison avec le modèle avec les CloudFormation transformations déjà traitées.

Valeur par défaut : false

--quiet, -q BOOLEAN

N'imprimez pas le nom de la pile CDK ni le cdk diff message par défaut stdout lorsqu'aucune modification n'est détectée.

Valeur par défaut : false

--security-only BOOLEAN

Ne différentiez que pour les modifications de sécurité étendues.

Valeur par défaut : false

--strict BOOLEAN

Modifiez cdk diff le comportement pour qu'il soit plus précis ou plus strict. Lorsque c'est vrai, le CDK CLI ne filtre pas les AWS::CDK::Metadata ressources ni les caractères non ASCII illisibles.

Valeur par défaut : false

--template STRING

Le chemin d'accès au CloudFormation modèle avec lequel comparer une pile de CDK.

Exemples

Différence par rapport à la pile actuellement déployée nommée MyStackName

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

Différencier par rapport à un modèle spécifique CloudFormation 

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

Différenciez une pile locale avec sa pile déployée. Ne pas imprimer sur la sortie standard si aucune modification n'est détectée

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