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
<a name="toolkit-library-gs"></a>

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

## Voraussetzungen
<a name="toolkit-library-gs-prerequisites"></a>

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

1.  AWS Anmeldeinformationen konfiguriert.

1. Grundlegende Vertrautheit mit dem AWS CDK.

Weitere Informationen finden Sie unter [AWS CDK-Voraussetzungen](prerequisites.md).

## Schritt 1: Installation der CDK Toolkit-Bibliothek
<a name="toolkit-library-gs-install"></a>

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
<a name="toolkit-library-gs-initialize"></a>

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-library-configure.md) Toolkit-Instanz.

## Schritt 3: Erstellen Sie eine Cloud-Assembly-Quelle für Ihre CDK-App
<a name="toolkit-library-gs-ca"></a>

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();
   });
   ```

1.  **Eine vorhandene CDK-App-Datei**:

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

Weitere Informationen finden Sie unter [Cloud-Assembly-Quellen konfigurieren](toolkit-library-configure-ca.md).

## Schritt 4: Definieren Sie programmatische Aktionen für Ihre CDK-App
<a name="toolkit-library-gs-define"></a>

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
<a name="toolkit-library-gs-customize"></a>

Sie können das CDK Toolkit weiter an Ihre Bedürfnisse anpassen und konfigurieren:
+  **Nachrichten und Interaktionen** — Konfigurieren Sie, wie das CDK Toolkit mit Benutzern und Anwendungen kommuniziert. Siehe [Nachrichten und Interaktionen konfigurieren](toolkit-library-configure-messages.md).
+  **Fehlerbehandlung** — Implementieren Sie eine strukturierte Fehlerbehandlung für CDK-Operationen. Siehe [Fehlerbehandlung konfigurieren](toolkit-library-configure.md#toolkit-library-configure-errors).

## Weitere Ressourcen
<a name="toolkit-library-gs-resources"></a>

Weitere Informationen zum CDK Toolkit Library-Paket finden Sie [ReadMe](https://www.npmjs.com/package/@aws-cdk/toolkit-lib)im `npm` Paket *@aws `npm` -cdk/toolkit-lib*.

[API-Referenzinformationen finden Sie in der API-Referenz zur CDK Toolkit Library.](https://docs.aws.amazon.com/cdk/api/toolkit-lib/)