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.

Commencer à utiliser le AWS CDK

Commencez avec le AWS Cloud Development Kit (AWS CDK) en installant et en configurant l'interface de ligne de AWS CDK commande (AWS CDK CLI). Utilisez ensuite le CDK CLI pour créer votre première CDK application, démarrer votre AWS environnement et déployer votre application.

Prérequis

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 AWS CDK prérequis.

Nous vous recommandons d'avoir une compréhension de base de ce que AWS CDK c'est. Pour plus d’informations, consultez Qu'est-ce que c'est AWS CDK ? et Apprenez les concepts AWS CDK de base.

Installer la CLI  AWS CDK

Utilisez le Gestionnaire de Node packages pour installer le CDKCLI. Nous vous recommandons de l'installer globalement à l'aide de la commande suivante :

$ npm install -g aws-cdk

Pour installer une version spécifique du CDKCLI, utilisez la structure de commande suivante :

$ npm install -g aws-cdk@X.YY.Z

Si vous souhaitez utiliser plusieurs versions du AWS CDK, pensez à installer une version correspondante du CDK CLI dans des CDK projets individuels. Pour ce faire, supprimez l'-goption de la npm install commande. Ensuite, utilisez npx aws-cdk pour invoquer le CDKCLI. Cela exécutera une version locale si elle existe. Dans le cas contraire, c'est la version installée globalement qui sera utilisée.

Résoudre les problèmes liés à une installation CDK CLI

Si une erreur d'autorisation s'affiche et que vous disposez d'un accès administrateur sur votre système, exécutez la commande suivante :

$ sudo npm install -g aws-cdk

Si vous recevez un message d'erreur, essayez de le désinstaller CDK CLI en exécutant ce qui suit :

$ npm uninstall -g aws-cdk

Répétez ensuite les étapes pour réinstaller le CDKCLI.

Vérifier la réussite de CDK CLI l'installation

Exécutez la commande suivante pour vérifier la réussite de l'installation. Le numéro de version AWS CDK CLI doit être affiché :

$ cdk --version

Configurez le AWS CDKCLI

Après l'avoir installé CDKCLI, 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 d'identification de sécurité sur votre ordinateur local, vous utilisez le AWS CLI. La façon dont vous configurez les informations d'identification de sécurité dépend de la façon dont vous gérez les utilisateurs. Pour obtenir des instructions, reportez-vous à la section Authentification et identifiants d'accès dans le guide de AWS Command Line Interface l'utilisateur.

Le CDK CLI utilisera automatiquement les informations d'identification de sécurité que vous avez configurées avec le AWS CLI. Par exemple, si vous êtes un utilisateur d'IAMIdentity Center, vous pouvez utiliser la aws configure sso commande pour configurer les informations d'identification de sécurité. Si vous êtes un IAM utilisateur, vous pouvez utiliser la aws configure commande. Il vous AWS CLI guidera dans la configuration des informations de sécurité sur votre machine locale et enregistrera les informations nécessaires dans vos credentials fichiers config and. Ensuite, lorsque vous utilisez le CDKCLI, par exemple pour déployer une application aveccdk deploy, ils CDK CLI utiliseront vos informations d'identification de sécurité configurées.

Tout comme le AWS CLI, ils CDK CLI utiliseront votre default profil par défaut. Vous pouvez définir un profil à l'aide de l'CDKCLI--profileoption. Pour plus d'informations sur l'utilisation des informations d'identification de sécurité avec le CDKCLI, consultezConfigurez les informations d'identification de sécurité pour AWS CDKCLI.

(Facultatif) Installez des AWS CDK outils supplémentaires

Il s'AWS Toolkit for Visual Studio Codeagit d'un plug-in open source pour Visual Studio Code qui vous permet de créer, de déboguer et de déployer des applications sur AWS. La boîte à outils fournit une expérience intégrée pour le développement AWS CDK d'applications. Il inclut la fonctionnalité AWS CDK Explorer pour répertorier vos AWS CDK projets et parcourir les différents composants de l'CDKapplication. Pour obtenir des instructions, veuillez consulter les sections suivantes :

Créez votre première CDK application

Vous êtes maintenant prêt à commencer à utiliser le AWS CDK en créant votre première CDK application. Pour obtenir des instructions, consultez Tutoriel : Créez votre première AWS CDK application.