cdk import - AWS Cloud Development Kit (AWS CDK) v2
VerwendungArgumenteOptionen

Dies ist der AWS CDK v2-Entwicklerhandbuch. Die ältere CDK Version 1 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.

cdk import

Verwenden Sie AWS CloudFormation Ressourcenimporte, um vorhandene AWS Ressourcen in einen CDK Stapel zu importieren.

Mit diesem Befehl können Sie vorhandene Ressourcen, die mit anderen Methoden erstellt wurden, verwenden und mit der Verwaltung beginnen AWS CDK.

Wenn Sie erwägen, Ressourcen in die CDK Verwaltung zu verlagern, ist es manchmal akzeptabel, neue Ressourcen zu erstellen, z. B. mit IAM Rollen, Lambda-Funktionen und Ereignisregeln. Bei anderen Ressourcen, wie z. B. statusbehafteten Ressourcen wie Amazon S3 S3-Buckets und DynamoDB-Tabellen, kann das Erstellen neuer Ressourcen Auswirkungen auf Ihren Service haben. Sie können sie verwendencdk import, um vorhandene Ressourcen mit minimaler Unterbrechung Ihrer Dienste zu importieren. Eine Liste der unterstützten AWS Ressourcen finden Sie im AWS CloudFormation Benutzerhandbuch unter Unterstützung für Ressourcentypen.

Um eine vorhandene Ressource in einen CDK Stack zu importieren

  1. Führen Sie a auscdk diff, um sicherzustellen, dass Ihr CDK Stack keine ausstehenden Änderungen enthält. Wenn Sie eine ausführencdk import, sind die einzigen Änderungen, die bei einem Importvorgang zulässig sind, das Hinzufügen neuer Ressourcen, die importiert werden.

  2. Fügen Sie Konstrukte für die Ressourcen hinzu, die Sie in Ihren Stack importieren möchten. Fügen Sie beispielsweise Folgendes für einen Amazon S3 S3-Bucket hinzu:

    new s3.Bucket(this, 'ImportedS3Bucket', {});

    Fügen Sie keine weiteren Änderungen hinzu. Sie müssen außerdem sicherstellen, dass der aktuelle Status der Ressource exakt modelliert wird. Achten Sie beim Bucket-Beispiel darauf, dass Sie AWS KMS Schlüssel, Lebenszyklusrichtlinien und alles andere, was für den Bucket relevant ist, angeben. Andernfalls führen nachfolgende Aktualisierungsvorgänge möglicherweise nicht zu Ihren Erwartungen.

  3. Führen Sie cdk import. Wenn die CDK App mehrere Stapel enthält, übergeben Sie einen bestimmten Stacknamen als Argument.

  4. Das CDK CLI fordert Sie auf, die tatsächlichen Namen der Ressourcen einzugeben, die Sie importieren. Nachdem Sie diese Informationen eingegeben haben, beginnt der Import.

  5. Wenn die cdk import Meldung erfolgreich ist, wird die Ressource von der verwaltetCDK. Alle nachfolgenden Änderungen an der Konstruktkonfiguration werden auf der Ressource widergespiegelt.

Diese Funktion hat derzeit folgende Einschränkungen:

  • Das Importieren von Ressourcen in verschachtelte Stacks ist nicht möglich.

  • Es wird nicht überprüft, ob die von Ihnen angegebenen Eigenschaften für die importierte Ressource korrekt und vollständig sind. Versuchen Sie, nach dem Import einen Vorgang zur Erkennung von Abweichungen zu starten.

  • Ressourcen, die von anderen Ressourcen abhängig sind, müssen alle zusammen oder einzeln in der richtigen Reihenfolge importiert werden. Andernfalls schlägt die CloudFormation Bereitstellung mit ungelösten Verweisen fehl.

  • Dieser Befehl verwendet die Anmeldeinformationen für die Bereitstellungsrolle, die zum Lesen des verschlüsselten Staging-Buckets erforderlich sind. Dazu ist Version 12 der Bootstrap-Vorlage erforderlich, die die erforderlichen IAM Berechtigungen für die Bereitstellungsrolle enthält.

Verwendung

$ cdk import <arguments> <options>

Argumente

CDKStack-ID

Die Konstrukt-ID des CDK Stacks aus Ihrer App, in den Ressourcen importiert werden sollen. Dieses Argument kann in einem einzigen Befehl mehrfach angegeben werden.

Typ: Zeichenfolge

Required: No

Optionen

Für eine Liste globaler Optionen, die mit allen funktionieren CDK CLI Befehle finden Sie unterGlobale Optionen.

--change-set-name STRING

Der Name des zu erstellenden CloudFormation Änderungssatzes.

--execute BOOLEAN

Geben Sie an, ob der Änderungssatz ausgeführt werden soll.

Standardwert: true

--force, -f BOOLEAN

Standardmäßig ist der CDK CLI beendet den Prozess, wenn der Template-Diff Aktualisierungen oder Löschungen beinhaltet. Geben Sie true an, dass dieses Verhalten außer Kraft gesetzt werden soll, und fahren Sie immer mit dem Import fort.

--help, -h BOOLEAN

Zeigt die Befehlsreferenzinformationen für den cdk import Befehl an.

--record-resource-mapping, -r STRING

Verwenden Sie diese Option, um eine Zuordnung vorhandener physischer Ressourcen zu den CDK Ressourcen zu generieren, die importiert werden. Die Zuordnung wird in den von Ihnen angegebenen Dateipfad geschrieben. Es werden keine eigentlichen Importvorgänge ausgeführt.

--resource-mapping, -m STRING

Verwenden Sie diese Option, um eine Datei anzugeben, die Ihre Ressourcenzuweisung definiert. Die CDK CLI verwendet diese Datei, um physische Ressourcen Ressourcen für den Import zuzuordnen, anstatt Sie interaktiv zu fragen.

Diese Option kann von Skripten aus ausgeführt werden.

--rollback BOOLEAN

Setzen Sie den Stack bei einem Fehler in den stabilen Zustand zurück.

Um dies zu spezifizierenfalse, können Sie --no-rollback oder verwenden-R.

Geben Sie false an, ob die Iteration schneller erfolgen soll. Bereitstellungen, die Ressourcen ersetzen, schlagen immer fehl.

Standardwert: true

--toolkit-stack-name STRING

Der Name des CDK Toolkit-Stacks, der erstellt werden soll.

cdk bootstrapStellt standardmäßig einen Stack mit dem Namen CDKToolkit in der angegebenen AWS Umgebung bereit. Verwenden Sie diese Option, um einen anderen Namen für Ihren Bootstrap-Stack anzugeben.

Der CDK CLI verwendet diesen Wert, um Ihre Bootstrap-Stack-Version zu überprüfen.