Commencer à utiliser la bibliothèque du kit d'outils CDK - AWS Kit de développement Cloud (AWS CDK) v2
PrérequisÉtape 1 : Installation de la bibliothèque du kit d'outils CDKÉtape 2 : Initialisation de la bibliothèque du kit d'outils CDKÉtape 3 : Création d'une source d'assemblage cloud pour votre application CDKÉtape 4 : Définition des actions programmatiques pour votre application CDKÉtape 5 : Personnaliser davantage le kit d'outils CDKRessources supplémentaires

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.

Commencer à utiliser la bibliothèque du kit d'outils CDK

Commencez par utiliser la bibliothèque AWS CDK Toolkit pour exécuter par programmation des actions CDK, telles que la synthèse et le déploiement, dans votre code.

Prérequis

  1. Version prise en charge de Node.js installée.

  2. AWS informations d'identification configurées.

  3. Connaissance de base du AWS CDK.

Pour plus d'informations, consultez la section Conditions préalables au AWS CDK.

Étape 1 : Installation de la bibliothèque du kit d'outils CDK

Installez le package CDK Toolkit Library dans l'environnement de développement de votre projet en exécutant ce qui suit :

npm install --save @aws-cdk/toolkit-lib

Étape 2 : Initialisation de la bibliothèque du kit d'outils CDK

Créez une instance de CDK Toolkit pour effectuer des actions programmatiques sur votre application CDK.

import { Toolkit } from '@aws-cdk/toolkit-lib';

const toolkit = new Toolkit({
    // Optional configuration options go here
});

Vous pouvez personnaliser l'instance du CDK Toolkit lors de sa création. Pour obtenir des instructions, consultez Configurer votre instance du CDK Toolkit.

Étape 3 : Création d'une source d'assemblage cloud pour votre application CDK

Une source d'assemblage dans le cloud fournit des instructions pour générer des CloudFormation modèles à partir de votre application CDK. Vous pouvez en créer un de plusieurs manières. Voici quelques exemples :

  1. Une fonction de création d'assemblages en ligne :

    import * as cdk from 'aws-cdk-lib';

const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => {
  const app = new cdk.App();
  new MyStack(app, 'MyStack');
  return app.synth();
});

  2. Un fichier d'application CDK existant :

    const cloudAssemblySource = await toolkit.fromCdkApp("ts-node app.ts");

Pour plus d'informations, consultez la section Configurer les sources d'assemblage dans le cloud.

Étape 4 : Définition des actions programmatiques pour votre application CDK

Maintenant que vous avez créé une instance CDK Toolkit et une source d'assemblage cloud, vous pouvez commencer à définir des actions programmatiques. Voici un exemple de base qui crée un déploiement de la MyStack pile :

import { StackSelectionStrategy } from '@aws-cdk/toolkit-lib';

await toolkit.deploy(cloudAssemblySource, {
  stacks: {
    strategy: StackSelectionStrategy.PATTERN_MUST_MATCH, // Deploy only stacks that exactly match the provided patterns
    patterns: ["MyStack"],
  },
});

Étape 5 : Personnaliser davantage le kit d'outils CDK

Vous pouvez configurer et personnaliser le kit CDK en fonction de vos besoins :

Ressources supplémentaires

Pour plus d'informations sur le package CDK Toolkit Library, consultez le npm ReadMepackage @aws -cdk/toolkit-libnpm.

Pour obtenir des informations de référence sur les API, consultez la référence de l'API de la bibliothèque CDK Toolkit.