AWS CDK CLI Référence des commandes   - AWS Cloud Development Kit (AWS CDK) v2
UtilisationCommandesOptions globalesFourniture et configuration d'optionsPasser des options sur la ligne de commande

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.

AWS CDK CLI Référence des commandes  

Cette section contient des informations de référence de commande pour l'interface de ligne de AWS Cloud Development Kit (AWS CDK) commande (CLI). Le CDK CLI est également connu sous le nom de CDK boîte à outils.

Utilisation

$ cdk <command> <arguments> <options>

Commandes

acknowledge, ack

Accusez réception d'un avis par numéro de problème et empêchez-le de s'afficher à nouveau.

bootstrap

Préparez un AWS environnement pour les CDK déploiements en déployant la pile CDK bootstrap, nomméeCDKToolkit, dans l' AWS environnement.

context

Gérez les valeurs de contexte mises en cache pour votre CDK application.

deploy

Déployez une ou plusieurs CDK piles dans votre AWS environnement.

destroy

Supprimez une ou plusieurs CDK piles de votre AWS environnement.

diff

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

docs, doc

Ouvrez CDK la documentation dans votre navigateur.

doctor

Inspectez et affichez des informations utiles sur votre CDK projet local et votre environnement de développement.

import

Utilisez les importations de AWS CloudFormation ressources pour importer AWS des ressources existantes dans une CDK pile.

init

Créez un nouveau CDK projet à partir d'un modèle.

list, ls

Répertoriez toutes les CDK piles et leurs dépendances à partir d'une CDK application.

metadata

Afficher les métadonnées associées à une CDK pile.

migrate

Migrez AWS les ressources, AWS CloudFormation les piles et les AWS CloudFormation modèles vers un nouveau CDK projet.

notices

Affichez les avis relatifs à votre CDK candidature.

synthesize, synth

Synthétisez une CDK application pour produire un assemblage cloud, y compris un AWS CloudFormation modèle pour chaque pile.

watch

Surveillez en permanence les modifications apportées à un CDK projet local afin d'effectuer des déploiements et des hotswaps.

Options globales

Les options suivantes sont compatibles avec tous CDK CLI commandes.

--app, -a STRING

Fournissez la commande pour exécuter votre application ou votre répertoire d'assemblage cloud.

Obligatoire : oui

--asset-metadata BOOLEAN

Incluez aws:asset:* AWS CloudFormation des métadonnées pour les ressources qui utilisent des actifs.

Obligatoire : non

Valeur par défaut : true

--build STRING

Commande permettant d'exécuter une version de pré-synthèse.

Obligatoire : non

--ca-bundle-path STRING

Chemin d'accès à un certificat CA à utiliser lors de la validation des HTTPS demandes.

Si cette option n'est pas disponible, CDK CLI sera lu à partir de la variable d'AWS_CA_BUNDLEenvironnement.

Obligatoire : oui

--ci BOOLEAN

Indiquez que CDK CLI les commandes sont exécutées dans un environnement d'intégration continue (CI).

Cette option modifie le comportement du CDK CLI pour mieux s'adapter aux opérations automatisées typiques des pipelines CI.

Lorsque vous fournissez cette option, les journaux sont envoyés à la stdout place destderr.

Obligatoire : non

Valeur par défaut : false

--context, -c ARRAY

Ajoutez des paramètres de chaîne contextuels sous forme de paires clé-valeur.

--debug BOOLEAN

Activez les informations de débogage détaillées. Cette option produit une sortie détaillée qui inclut beaucoup plus de détails sur ce que CDK CLI agit dans les coulisses.

Obligatoire : non

Valeur par défaut : false

--ec2creds, -i BOOLEAN

Forcer le CDK CLI pour essayer de récupérer les informations d'identification de l'EC2instance Amazon.

Par défaut, le CDK CLI devine le statut de l'EC2instance Amazon.

Obligatoire : non

Valeur par défaut : false

--help, -h BOOLEAN

Afficher les informations de référence de commande pour CDK CLI.

Obligatoire : non

Valeur par défaut : false

--ignore-errors BOOLEAN

Ignorez les erreurs de synthèse, qui produiront probablement une sortie non valide.

Obligatoire : non

Valeur par défaut : false

--json, -j BOOLEAN

À utiliser JSON plutôt que YAML pour les AWS CloudFormation modèles imprimés sur une sortie standard (stdout).

Obligatoire : non

Valeur par défaut : false

--lookups BOOLEAN

Effectuez des recherches contextuelles.

La synthèse échouera si cette valeur est valide false et que des recherches de contexte doivent être effectuées.

Obligatoire : non

Valeur par défaut : true

--no-color BOOLEAN

Supprimez la couleur et les autres styles de la sortie de la console.

Obligatoire : non

Valeur par défaut : false

--notices BOOLEAN

Afficher les avis pertinents.

Obligatoire : non

Valeur par défaut : false

--output, -o STRING

Spécifiez le répertoire vers lequel l'assemblage cloud synthétisé doit être généré.

Obligatoire : oui

Valeur par défaut : cdk.out

--path-metadata BOOLEAN

Incluez aws::cdk::path AWS CloudFormation des métadonnées pour chaque ressource.

Obligatoire : non

Valeur par défaut : true

--plugin, -p ARRAY

Nom ou chemin d'un node package qui étend les CDK fonctionnalités. Cette option peut être fournie plusieurs fois en une seule commande.

Vous pouvez configurer cette option dans le cdk.json fichier du projet ou ~/.cdk.json sur votre machine de développement locale :

{
   // ...
   "plugin": [
      "module_1",
      "module_2"
   ],
   // ...
}

Obligatoire : non

--profile STRING

Spécifiez le nom du AWS profil, contenant les informations relatives à votre AWS environnement, à utiliser avec CDK CLI.

Obligatoire : oui

--proxy STRING

Utilisez le proxy indiqué.

Si cette option n'est pas disponible, CDK CLI sera lu à partir de la variable d'HTTPS_PROXYenvironnement.

Obligatoire : oui

Valeur par défaut : Lire à partir de la variable d'HTTPS_PROXYenvironnement.

--role-arn, -r STRING

Le ARN IAM rôle que joue le CDK CLI assumera lors de l'interaction avec AWS CloudFormation.

Obligatoire : non

--staging BOOLEAN

Copiez les actifs dans le répertoire de sortie.

Spécifiez false pour empêcher la copie des actifs dans le répertoire de sortie. Cela permet AWS SAM CLI pour référencer les fichiers source d'origine lors du débogage local.

Obligatoire : non

Valeur par défaut : true

--strict BOOLEAN

Ne créez pas de piles contenant des avertissements.

Obligatoire : non

Valeur par défaut : false

--trace BOOLEAN

Imprimer une trace pour les avertissements relatifs à la pile.

Obligatoire : non

Valeur par défaut : false

--verbose, -v COUNT

Afficher les journaux de débogage. Vous pouvez spécifier cette option plusieurs fois pour augmenter la verbosité.

Obligatoire : non

--version BOOLEAN

Afficher le CDK CLI numéro de version.

Obligatoire : non

Valeur par défaut : false

--version-reporting BOOLEAN

Incluez la AWS::CDK::Metadata ressource dans des AWS CloudFormation modèles synthétisés.

Obligatoire : non

Valeur par défaut : true

Fourniture et configuration d'options

Vous pouvez transmettre des options via des arguments de ligne de commande. Pour la plupart des options, vous pouvez les configurer dans un fichier cdk.json de configuration. Lorsque vous utilisez plusieurs sources de configuration, CDK CLI respecte la priorité suivante :

  1. Valeurs de ligne de commande — Toute option fournie sur la ligne de commande remplace les options configurées dans les fichiers. cdk.json

  2. Fichier de configuration du projet : cdk.json fichier situé dans le répertoire de votre CDK projet.

  3. Fichier de configuration utilisateur : cdk.json fichier situé ~/.cdk.json sur votre ordinateur local.

Passer des options sur la ligne de commande

Transmission de valeurs booléennes

Pour les options qui acceptent une valeur booléenne, vous pouvez les spécifier de la manière suivante :

  • Utilisation true et false valeurs — Fournissez la valeur booléenne avec la commande. Voici un exemple :

    $ cdk deploy --watch=true
$ cdk deploy --watch=false

  • Fournir la contrepartie de l'option : modifiez le nom de l'option en ajoutant no pour spécifier une false valeur. Voici un exemple :

    $ cdk deploy --watch
$ cdk deploy --no-watch

  • Pour les options dont la valeur par défaut est true oufalse, vous n'êtes pas obligé de fournir l'option, sauf si vous souhaitez modifier la valeur par défaut.