Il s'agit du guide du développeur AWS CDK v2. 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.
Démarrage avec le plugin AWS CDK
Commencez à utiliser le AWS Cloud Development Kit (AWS CDK) en installant et en configurant l'interface de ligne de commande AWS CDK (AWS CDK CLI). Ensuite, utilisez la CLI CDK pour créer votre première application CDK, démarrer votre AWS environnement et déployer votre application.
Conditions préalables
Avant de commencer à utiliser le AWS CDK, remplissez tous les prérequis. Ces prérequis sont obligatoires pour ceux qui débutent AWS ou découvrent la programmation. Pour obtenir des instructions, consultez la section Prérequis du AWS CDK.
Nous vous recommandons d'avoir une compréhension de base de ce qu'est le AWS CDK. Pour plus d'informations, consultez Qu'est-ce que le AWS CDK ? et découvrez les concepts de base du AWS CDK.
Installer la AWS CLI CDK
Utilisez le gestionnaire de Node packages pour installer la CLI CDK. Nous vous recommandons de l'installer globalement à l'aide de la commande suivante :
$ npm install -g aws-cdk
Pour installer une version spécifique de la CLI CDK, utilisez la structure de commande suivante :
$ npm install -g aws-cdk@X.YY.Z
Si vous souhaitez utiliser plusieurs versions du AWS CDK, envisagez d'installer une version correspondante de l'interface de ligne de commande du CDK dans des projets CDK individuels. Pour ce faire, supprimez l'-goption de la npm install commande. Ensuite, utilisez npx aws-cdk pour invoquer la CLI CDK. Cela exécutera une version locale si elle existe. Dans le cas contraire, la version installée globalement sera utilisée.
- Résoudre les problèmes d'installation d'une CLI CDK
-
Si vous obtenez une erreur d'autorisation et que vous disposez d'un accès administrateur sur votre système, exécutez les opérations suivantes :
$ sudo npm install -g aws-cdkSi un message d'erreur s'affiche, essayez de désinstaller la CLI CDK en exécutant la commande suivante :
$ npm uninstall -g aws-cdkRépétez ensuite les étapes pour réinstaller la CLI CDK.
Vérifier la réussite de l'installation de la CLI CDK
Exécutez la commande suivante pour vérifier la réussite de l'installation. La CLI AWS CDK doit afficher le numéro de version :
$ cdk --version
Configurez le AWS CLI CDK
Après avoir installé la CLI CDK, vous pouvez commencer à l'utiliser pour développer des applications sur votre machine locale. Pour interagir avec AWS, par exemple, déployer des applications, vous devez disposer d'informations d'identification de sécurité configurées sur votre machine locale avec les autorisations nécessaires pour effectuer toutes les actions que vous initiez.
Pour configurer les informations de sécurité sur votre machine locale, vous utilisez l' AWS interface de ligne de commande. La manière dont vous configurez les informations de sécurité dépend de la manière dont vous gérez les utilisateurs. Pour obtenir des instructions, consultez la section Authentification et informations d'accès dans le Guide de l'utilisateur de l'interface de ligne de AWS commande.
La CLI CDK utilisera automatiquement les informations d'identification de sécurité que vous configurez avec la AWS CLI. Par exemple, si vous utilisez IAM Identity Center, vous pouvez utiliser la aws configure sso commande pour configurer les informations d'identification de sécurité. Si vous êtes un utilisateur IAM, vous pouvez utiliser la aws configure commande. L' AWS interface de ligne de commande vous guidera dans la configuration des informations de sécurité sur votre machine locale et enregistrera les informations nécessaires dans vos config credentials fichiers. Ensuite, lorsque vous utilisez la CLI CDK, par exemple pour déployer une application aveccdk deploy, la CLI CDK utilise vos informations d'identification de sécurité configurées.
Tout comme la AWS CLI, la CLI CDK utilisera votre default profil par défaut. Vous pouvez spécifier un profil à l'aide de l'--profileoption CDK CLI. Pour plus d'informations sur l'utilisation des informations d'identification de sécurité avec la CLI CDK, voir Configurer les informations d'identification de sécurité pour la CLI AWS CDK.
(Facultatif) Installer des éléments supplémentaires AWS Outils CDK
Le AWS Toolkit for Visual Studio Code
Créez votre première application CDK
Vous êtes maintenant prêt à commencer à utiliser le AWS CDK en créant votre première application CDK. Pour obtenir des instructions, consultez Tutoriel : Création de votre première application AWS CDK.
