Erste Schritte mit der CDK Toolkit Library - AWS Cloud Development Kit (AWS CDK) v2
VoraussetzungenSchritt 1: Installation der CDK Toolkit-BibliothekSchritt 2: Initialisierung der CDK Toolkit LibrarySchritt 3: Erstellen Sie eine Cloud-Assembly-Quelle für Ihre CDK-AppSchritt 4: Definieren Sie programmatische Aktionen für Ihre CDK-AppSchritt 5: Das CDK Toolkit weiter anpassenWeitere Ressourcen

Dies ist der AWS CDK v2-Entwicklerhandbuch. Das ältere CDK v1 wurde am 1. Juni 2022 in die Wartung aufgenommen und der Support wurde am 1. Juni 2023 eingestellt.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erste Schritte mit der CDK Toolkit Library

Beginnen Sie mit der Verwendung der AWS CDK Toolkit-Bibliothek, um CDK-Aktionen wie Synthese und Bereitstellung programmgesteuert in Ihrem Code auszuführen.

Voraussetzungen

  1. Unterstützte Version von Node.js ist installiert.

  2. AWS Anmeldeinformationen konfiguriert.

  3. Grundlegende Vertrautheit mit dem AWS CDK.

Weitere Informationen finden Sie unter AWS CDK-Voraussetzungen.

Schritt 1: Installation der CDK Toolkit-Bibliothek

Installieren Sie das CDK Toolkit Library-Paket in der Entwicklungsumgebung Ihres Projekts, indem Sie den folgenden Befehl ausführen:

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

Schritt 2: Initialisierung der CDK Toolkit Library

Erstellen Sie eine CDK Toolkit-Instanz, um programmatische Aktionen in Ihrer CDK-App auszuführen.

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

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

Sie können die CDK Toolkit-Instanz während der Erstellung anpassen. Anweisungen finden Sie unter Konfiguration Ihrer CDK Toolkit-Instanz.

Schritt 3: Erstellen Sie eine Cloud-Assembly-Quelle für Ihre CDK-App

Eine Cloud-Assembly-Quelle enthält Anweisungen zum Generieren von CloudFormation Vorlagen aus Ihrer CDK-App. Sie können eine auf verschiedene Arten erstellen. Im Folgenden sind einige Beispiele aufgeführt:

  1. Eine Inline-Assembly Builder-Funktion:

    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. Eine vorhandene CDK-App-Datei:

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

Weitere Informationen finden Sie unter Cloud-Assembly-Quellen konfigurieren.

Schritt 4: Definieren Sie programmatische Aktionen für Ihre CDK-App

Nachdem Sie nun eine CDK Toolkit-Instanz und eine Cloud-Assembly-Quelle erstellt haben, können Sie mit der Definition programmatischer Aktionen beginnen. Im Folgenden finden Sie ein grundlegendes Beispiel, das eine Bereitstellung des Stacks erstellt: MyStack

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"],
  },
});

Schritt 5: Das CDK Toolkit weiter anpassen

Sie können das CDK Toolkit weiter an Ihre Bedürfnisse anpassen und konfigurieren:

Weitere Ressourcen

Weitere Informationen zum CDK Toolkit Library-Paket finden Sie ReadMeim npm Paket @aws npm -cdk/toolkit-lib.

API-Referenzinformationen finden Sie in der API-Referenz zur CDK Toolkit Library.