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

Dies ist der AWS CDK v2-Entwicklerhandbuch. Das ältere CDK v1 wurde am 1. Juni 2022 gewartet 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-Stack zu importieren.

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

Wenn Sie erwägen, Ressourcen in das CDK-Management 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, AWS KMS Schlüssel, Lebenszyklusrichtlinien und alles andere, was für den Bucket relevant ist, anzugeben. Andernfalls führen nachfolgende Aktualisierungsvorgänge möglicherweise nicht zu Ihren Erwartungen.

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

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

  5. Bei cdk import erfolgreicher Meldung wird die Ressource vom CDK verwaltet. 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

Logische ID des CDK-Stacks

Die logische 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

Eine Liste der globalen Optionen, die mit allen CLI CDK-Befehlen funktionieren, finden Sie unterGlobale Optionen.

--change-set-name STRING

Der Name des zu CloudFormation erstellenden Änderungssatzes.

--execute BOOLEAN

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

Standardwert: true

--force, -f BOOLEAN

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

--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. Das CDK verwendet CLI diese Datei, um physische Ressourcen Ressourcen für den Import zuzuordnen, anstatt Sie interaktiv danach 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