Ceci est le guide du développeur du 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.
Réaliser des actions programmatiques à l'aide de la bibliothèque du kit d'outils CDK
Comprendre la bibliothèque du kit d'outils CDK
La bibliothèque du kit d'outils CDK vous permet d'effectuer des actions CDK par programmation via du code au lieu d'utiliser des commandes CLI. Vous pouvez utiliser cette bibliothèque pour créer des outils personnalisés, créer des applications CLI spécialisées et intégrer les fonctionnalités du CDK dans vos flux de travail de développement.
- Gérez le cycle de vie de votre infrastructure grâce au contrôle programmatique
-
La bibliothèque du kit d'outils CDK fournit des interfaces de programmation pour les actions CDK suivantes :
-
Synthèse : générez des AWS CloudFormation modèles et des artefacts de déploiement.
-
Déploiement : provisionnez ou mettez à jour l'infrastructure à l'aide CloudFormation de modèles.
-
Refactoriser - Préservez les ressources déployées lors de la refactorisation du code CDK, par exemple en renommant des constructions ou en les déplaçant entre des piles.
-
Liste : permet d'afficher des informations sur les piles et leurs dépendances.
-
Surveiller - Surveillez les applications CDK pour détecter les modifications locales.
-
Annulation : redonne aux piles leur dernier état stable.
-
Détruire : supprimez les piles de CDK et les ressources associées.
-
- Améliorez et personnalisez la gestion de votre infrastructure
-
-
Contrôle par le code : intégrez la gestion de l'infrastructure directement dans vos applications et créez des pipelines de déploiement réactifs.
-
Gérez les assemblages cloud : créez, inspectez et transformez les définitions de votre infrastructure avant le déploiement.
-
Personnalisez les déploiements : configurez les paramètres, le comportement de restauration et la surveillance en fonction de vos besoins.
-
Préservez les ressources lors de la refactorisation : détectez et préservez automatiquement les ressources lorsque vous refactorisez le code CDK.
-
Gérez les erreurs avec précision : implémentez une gestion structurée des erreurs avec des informations de diagnostic détaillées.
-
Personnalisez les communications : configurez des indicateurs de progression personnalisés et enregistrez
IoHostles mises en œuvre. -
Connectez-vous avec AWS : configurez les profils, les régions et les flux d'authentification par programmation.
-
Choisir quand utiliser la bibliothèque du kit d'outils CDK
La bibliothèque du kit d'outils CDK est particulièrement utile lorsque vous devez :
-
Automatisez les déploiements d'infrastructures dans le cadre de CI/CD pipelines.
-
Créez des outils de déploiement personnalisés adaptés aux besoins de votre organisation.
-
Intégrez les actions du CDK dans les applications ou plateformes existantes.
-
Créez des flux de travail de déploiement spécialisés avec des étapes de validation ou d'approbation personnalisées.
-
Mettez en œuvre des modèles de gestion d'infrastructure avancés dans plusieurs environnements.
-
Automatisez les opérations de refactorisation pour préserver les ressources lorsque vous refactorisez le code CDK.
Utilisation de la bibliothèque du kit d'outils CDK
L'exemple suivant montre comment créer et déployer un compartiment S3 simple à l'aide de la bibliothèque CDK Toolkit :
// Import required packages import { Toolkit } from '@aws-cdk/toolkit-lib'; import { App, Stack } from 'aws-cdk-lib'; import * as s3 from 'aws-cdk-lib/aws-s3'; // Create and configure the CDK Toolkit const toolkit = new Toolkit(); // Create a cloud assembly source with an inline app const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => { const app = new App(); const stack = new Stack(app, 'SimpleStorageStack'); // Create an S3 bucket in the stack new s3.Bucket(stack, 'MyFirstBucket', { versioned: true }); return app.synth(); }); // Deploy the stack await toolkit.deploy(cloudAssemblySource);
- Ce que vous pouvez faire ensuite
-
-
Automatisez les déploiements : déclenchez les déploiements par programmation et ajoutez des étapes de déploiement. pre/post
-
Intégration aux systèmes : connectez-vous aux CI/CD flux de travail, aux outils personnalisés et aux solutions de surveillance.
-
Contrôlez les détails du déploiement : configurez des options précises pour la sélection des piles et les déploiements multi-environnements.
-
Améliorez la fiabilité : mettez en œuvre une gestion des erreurs adaptée à la production et un suivi de la progression du déploiement.
-
Automatisez le refactoring : détectez et préservez les ressources lorsque vous refactorisez le code CDK.
-
Étapes suivantes
Pour commencer à utiliser la bibliothèque de boîtes à outils CDK, voir Commencer à utiliser la bibliothèque de boîtes à outils CDK.
En savoir plus
Pour en savoir plus sur la bibliothèque du kit d'outils CDK, consultez ce qui suit :
-
ReadMe
dans le package @aws -cdk/toolkit-lib npm.