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.
Commencer à utiliser le AWS CDK
Commencez avec le AWS Cloud Development Kit (AWS CDK) en créant une Compte AWS, en configurant l'interface de ligne de AWS CDK commande (AWS CDK CLI) et en créant votre première application CDK.
Prérequis
Avant de commencer à utiliser le AWS CDK, 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.
Étape 1 : créer un Compte AWS utilisateur administratif
Si vous ou votre organisation débutez dans ce AWS domaine, vous devez vous inscrire à un Compte AWS et créer un utilisateur administratif. Pour obtenir des instructions, consultez la section Configuration avec IAM dans le guide de l'utilisateur d'IAM.
Vous pouvez gérer l'IAM à l'aide de différentes méthodes, par exemple via la AWS console, le AWS Command Line Interface (AWS CLI) ou via les interfaces d'application (APIs) dans le fichier associéSDKs. Lorsque vous utilisez IAM avec le AWS CDK CLI, vous utiliserez principalement le AWS CLI pour configurer et gérer les informations d'identification de sécurité. Pour en savoir plus, consultez AWS Command Line Interface (CLI) et Kits de développement logiciel (SDKs) dans le guide de l'utilisateur IAM.
Une fois que vous avez créé un utilisateur administratif, vous pouvez commencer à l'utiliser en AWS CDK installant le CDKCLI. Toutefois, nous vous recommandons de déterminer d'abord votre méthode de gestion des utilisateurs, conformément aux meilleures pratiques d'IAM qui consistent à appliquer des autorisations de moindre privilège. Plutôt que d'utiliser votre utilisateur administratif pour tout, vous créez des utilisateurs IAM et n'accordez que les autorisations requises pour effectuer une tâche.
Étape 2 : Déterminez votre méthode de gestion des utilisateurs
Une fois que vous avez créé votre Compte AWS utilisateur administratif, vous devez déterminer votre méthode de gestion des utilisateurs. Pour en savoir plus sur les différentes méthodes de gestion des utilisateurs, voir Présentation de la gestion des AWS identités : utilisateurs dans le guide de l'utilisateur IAM.
Si votre organisation dispose d'une méthode de gestion des utilisateurs, suivez ses instructions. Dans le cas contraire, nous vous recommandons AWS IAM Identity Center de l'utiliser pour créer et gérer des utilisateurs. Avec IAM Identity Center, vous pouvez gérer les Comptes AWS utilisateurs et les autorisations à partir d'un service géré de manière centralisée. Vous pouvez également utiliser un fournisseur d'identité pour authentifier les utilisateurs et fournir des informations d'identification temporaires à utiliser avec le CLI CDK. Il s'agit d'une bonne pratique en matière de sécurité IAM. Pour une présentation d'IAM Identity Center, voir Qu'est-ce qu'IAM Identity Center ? dans le guide de AWS IAM Identity Center l'utilisateur.
En tant qu'utilisateur, vous devez configurer les informations d'identification de sécurité dans votre environnement de développement local pour le CDKCLI. Nous vous recommandons d'utiliser install et d'utiliser le AWS Command Line Interface (AWS CLI) pour ce faire.
Étape 3 : installez le AWS CLI
En tant qu'utilisateur, vous l'utilisez AWS CLI pour créer et gérer des fichiers de configuration et d'identification sur votre machine locale. Ces fichiers sont utilisés pour stocker, gérer et générer des informations d'identification de sécurité à utiliser avec le CDKCLI.
Pour l'installer AWS CLI, voir Installation ou mise à jour vers la dernière version du AWS CLI Guide de l'AWS Command Line Interface utilisateur.
Pour en savoir plus sur ces fichiers, consultez la section Configuration et paramètres des fichiers d'identification dans le Guide de l'AWS Command Line Interface utilisateur.
Après avoir installé le AWS CLI, vous configurerez les informations d'identification de sécurité lors d'une étape ultérieure.
Étape 4 : prérequis pour l'installation Node.js et le langage de programmation
Tous les AWS CDK développeurs, quel que soit le langage de programmation pris en charge que vous utiliserez, ont besoin de la version Node.js
Important
Les versions 13.0.0 à 13.6.0 de Node.js ne sont pas compatibles avec le AWS CDK en raison de problèmes de compatibilité liés à ses dépendances.
Les autres prérequis en matière de langage de programmation dépendent du langage que vous utiliserez pour développer des AWS CDK applications :
Pour des informations plus détaillées, consultez la section Conditions requises pour votre langue :
Obsolète d'un langage tiers
Chaque version linguistique n'est prise en charge que jusqu'à ce qu'elle le soit EOL (fin de vie) et est sujette à modification avec préavis.
Étape 5 : installez le AWS CDKCLI
Utilisez le Gestionnaire de Node packages pour installer le CDK. CLI 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 CDK AWS CDK, pensez à installer une version correspondante du CDK CLI dans des projets CDK individuels. Pour ce faire, supprimez l'-goption de la npm install commande. Utilisez-le ensuite npx aws-cdk pour invoquer le CDK. CLI Cela exécutera une version locale si elle existe. Dans le cas contraire, c'est la version installée globalement qui sera utilisée.
Note
Si une erreur d'autorisation s'affiche et que vous disposez d'un accès administrateur sur votre système, essayezsudo npm install -g
aws-cdk.
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
Si vous recevez un message d'erreur, essayez de le désinstaller AWS CDK CLI en exécutant ce qui suit :
$npm uninstall -g aws-cdk
Répétez ensuite les étapes pour réinstaller le AWS CDK CLI.
Étape 6 : Configuration des informations d'identification de sécurité pour le CDK CLI
Lorsque vous développez avec le AWS CDK dans votre environnement local, vous utiliserez principalement le CDK CLI pour interagir avec AWS. Ces interactions incluent le déploiement de piles CDK, l'exécution de diffs de piles, l'importation de ressources dans le CDK, etc.
Pour effectuer ces actions, vous devez configurer les informations d'identification de sécurité pour le CDK CLI sur votre machine locale. Cela permet de AWS savoir qui vous êtes et de quelles autorisations vous disposez. Pour de plus amples informations, consultez Configurez les informations d'identification de sécurité pour AWS CDKCLI.
Étape 7 : Bootstrap votre environnement AWS
Les piles CDK sont déployées dans AWS des environnements. Avant de pouvoir déployer une pile CDK dans un environnement, celui-ci doit d'abord être amorcé.
Pour démarrer votre environnement, utilisez la commande CDK. CLI cdk bootstrap Pour obtenir des instructions, veuillez consulter Comment démarrer votre environnement.
Étape 8 : (Facultatif) Installez des AWS CDK outils supplémentaires
Il s'AWS Toolkit for Visual Studio Code
Étape 9 : Créez votre première application CDK
Vous êtes maintenant prêt à commencer à utiliser le en AWS CDK créant votre première application CDK. Pour obtenir des instructions, consultez Tutoriel : Créez votre première AWS CDK application.