Ceci est le guide du AWS CDK développeur de la version 2. L'ancienne CDK version 1 est entrée 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.Lorsque
false
, 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éfautstdout
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 lesAWS::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