View a markdown version of this page

Migrieren Sie vorhandene Ressourcen und AWS CloudFormation Vorlagen zum AWS CDK - AWS Cloud-Entwicklungskit (AWS CDK) v2
Wie funktioniert die MigrationVorteile von CDK MigrateÜberlegungenVoraussetzungenErste Schritte mit CDK MigrateMigrieren Sie von einem AWS CloudFormation stapelnMigrieren Sie von einem AWS CloudFormation VorlageMigrieren Sie von den bereitgestellten RessourcenVerwalten und implementieren Sie Ihre CDK-App

Dies ist das AWS CDK v2 Developer Guide. Für das ältere CDK v1 wurde am 1. Juni 2022 die Wartung abgeschlossen und der Support endete am 1. Juni 2023.

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.

Migrieren Sie vorhandene Ressourcen und AWS CloudFormation Vorlagen zum AWS CDK

Die CDK Migrate-Funktion befindet sich in der Vorabversion für AWS CDK und kann sich ändern.

Verwenden Sie die Befehlszeilenschnittstelle (AWS CDK CLI) des AWS Cloud Development Kit (AWS CDK), um bereitgestellte AWS Ressourcen, bereitgestellte AWS CloudFormation Stacks und lokale Vorlagen zu CDK zu migrieren. AWS CloudFormation AWS

Wie funktioniert die Migration

Verwenden Sie den AWS cdk migrate CDK-CLI-Befehl, um aus den folgenden Quellen zu migrieren:

  • Bereitgestellte AWS Ressourcen.

  • Bereitgestellte AWS CloudFormation Stapel.

  • Lokale AWS CloudFormation Vorlagen.

Bereitgestellte AWS Ressourcen

Sie können bereitgestellte AWS Ressourcen aus einer bestimmten Umgebung (AWS Konto und AWS Region) migrieren, die keinem AWS CloudFormation Stack zugeordnet sind.

Die AWS CDK-CLI verwendet den IaC-Generator-Service, um nach Ressourcen in Ihrer AWS Umgebung zu suchen und Ressourcendetails zu sammeln. Weitere Informationen zum IaC-Generator finden Sie unter Generieren von Vorlagen für vorhandene Ressourcen im Benutzerhandbuch. AWS CloudFormation

Nach dem Erfassen der Ressourcendetails erstellt die AWS CDK-CLI eine neue CDK-App, die einen einzelnen Stack enthält, der Ihre migrierten Ressourcen enthält.

Bereitgestellte Stapel AWS CloudFormation

Sie können einen einzelnen AWS CloudFormation Stack in eine neue AWS CDK-App migrieren. Die AWS CDK-CLI ruft die AWS CloudFormation Vorlage Ihres Stacks ab und erstellt eine neue CDK-App. Die CDK-App wird aus einem einzelnen Stack bestehen, der Ihren migrierten Stack enthält. AWS CloudFormation

Lokale Vorlagen AWS CloudFormation

Sie können von einer lokalen AWS CloudFormation Vorlage migrieren. Lokale Vorlagen können bereitgestellte Ressourcen enthalten oder auch nicht. Die AWS CDK-CLI erstellt eine neue CDK-App, die einen einzelnen Stack mit Ihren Ressourcen enthält.

Nach der Migration können Sie Ihre CDK-App verwalten, ändern und bereitstellen, um Ihre Ressourcen bereitzustellen oder AWS CloudFormation zu aktualisieren.

Vorteile von CDK Migrate

Die Migration von Ressourcen zu AWS CDK war in der Vergangenheit ein manueller Prozess, der Zeit und Fachwissen mit AWS CDK erforderte, um AWS CloudFormation überhaupt zu beginnen. Mit CDK Migrate erleichtert Ihnen die AWS CDK CLI einen Großteil des Migrationsaufwands in einem Bruchteil der Zeit. Mit CDK Migrate können Sie schnell mit der Verwendung des AWS CDK beginnen, um neue und bestehende Anwendungen zu entwickeln und zu verwalten. AWS

Überlegungen

Allgemeine Überlegungen

CDK Migrate im Vergleich zu CDK Import

Der cdk import Befehl kann bereitgestellte Ressourcen in eine neue oder bestehende CDK-App importieren. Beim Import muss jede Ressource manuell als L1-Konstrukt in Ihrer App definiert werden. Wir empfehlen cdk import die Verwendung, um eine oder mehrere Ressourcen gleichzeitig in eine neue oder vorhandene CDK-App zu importieren. Weitere Informationen finden Sie unter Importieren vorhandener Ressourcen in einen Stack.

Der cdk migrate Befehl migriert von bereitgestellten Ressourcen, bereitgestellten AWS CloudFormation Stacks oder lokalen AWS CloudFormation Vorlagen in eine neue CDK-App. Während der Migration verwendet die AWS CDK-CLI, cdk import um Ihre Ressourcen in die neue CDK-App zu importieren. Die AWS CDK-CLI generiert auch L1-Konstrukte für jede Ressource für Sie. Wir empfehlen die Verwendungcdk migrate, wenn Sie aus einer unterstützten Migrationsquelle in eine neue AWS CDK-App importieren.

CDK Migrate erstellt nur L1-Konstrukte

Die neu erstellte CDK-App wird nur L1-Konstrukte enthalten. Sie können Ihrer App nach der Migration Konstrukte auf höherer Ebene hinzufügen.

CDK Migrate erstellt CDK-Apps, die einen einzelnen Stack enthalten

Die neu erstellte CDK-App wird einen einzelnen Stack enthalten.

Bei der Migration bereitgestellter Ressourcen sind alle migrierten Ressourcen in der neuen CDK-App in einem einzigen Stack enthalten.

Bei der Migration von AWS CloudFormation Stacks können Sie in der neuen CDK-App nur einen einzelnen AWS CloudFormation Stack in einen einzelnen Stack migrieren.

Assets migrieren

Projektressourcen wie AWS Lambda-Code werden nicht direkt in die neue CDK-App migriert. Nach der Migration können Sie Asset-Werte angeben, um sie in die CDK-App aufzunehmen.

Migration von Stateful-Ressourcen

Bei der Migration von Stateful-Ressourcen wie Datenbanken und Amazon Simple Storage Service (Amazon S3) -Buckets möchten Sie in den meisten Fällen die vorhandene Ressource migrieren, anstatt eine neue Ressource zu erstellen.

Gehen Sie wie folgt vor, um statusbehaftete Ressourcen zu migrieren und beizubehalten:

  • Stellen Sie sicher, dass Ihre Stateful-Ressource den Import unterstützt. Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Unterstützung von Ressourcentypen.

  • Stellen Sie nach der Migration sicher, dass die logische ID der migrierten Ressource in der neuen CDK-App mit der logischen ID der bereitgestellten Ressource übereinstimmt.

  • Wenn Sie von einem AWS CloudFormation Stack migrieren, stellen Sie sicher, dass der Stack-Name in der neuen CDK-App mit dem Stack übereinstimmt. AWS CloudFormation

  • Stellen Sie die CDK-App mit demselben AWS Konto und derselben AWS Region der migrierten Ressource bereit.

Überlegungen bei der Migration von einem AWS CloudFormation Vorlage

CDK Migrate unterstützt die Migration einzelner Vorlagen

Bei der Migration von AWS CloudFormation Vorlagen können Sie eine einzelne Vorlage für die Migration auswählen. Verschachtelte Vorlagen werden nicht unterstützt.

Migrieren von Vorlagen mit intrinsischen Funktionen

Bei der Migration von einer AWS CloudFormation Vorlage, die intrinsische Funktionen verwendet, versucht die AWS CDK-CLI, Ihre Logik mit der Klasse in die CDK-App zu migrieren. Fn Weitere Informationen finden Sie unter Klasse Fn in der API-Referenz für das AWS Cloud Development Kit (AWS CDK).

Überlegungen bei der Migration von bereitgestellten Ressourcen

Einschränkungen beim Scannen

Wenn Sie Ihre Umgebung nach Ressourcen durchsuchen, gelten für den IaC-Generator bestimmte Einschränkungen hinsichtlich der Daten, die abgerufen werden können, und für das Scannen gelten Kontingentbeschränkungen. Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Überlegungen.

Voraussetzungen

Bevor Sie den cdk migrate Befehl verwenden, führen Sie alle Einrichtungsschritte unter Erste Schritte mit dem AWS CDK durch.

Erste Schritte mit CDK Migrate

Führen Sie zunächst den AWS cdk migrate CDK-CLI-Befehl in einem Verzeichnis Ihrer Wahl aus. Geben Sie je nach Art der Migration, die Sie durchführen, erforderliche und optionale Optionen an.

Eine vollständige Liste und Beschreibung der Optionen, die Sie verwenden könnencdk migrate, finden Sie unter cdk migrate.

Im Folgenden sind einige wichtige Optionen aufgeführt, die Sie möglicherweise bereitstellen möchten.

Stack name

Die einzige erforderliche Option ist--stack-name. Verwenden Sie diese Option, um einen Namen für den Stack anzugeben, der nach der Migration in der AWS CDK-App erstellt wird. Der Stack-Name wird bei der Bereitstellung auch als Name Ihres AWS CloudFormation Stacks verwendet.

Sprache

--languageDient zur Angabe der Programmiersprache der neuen CDK-App.

AWS Konto und Region AWS

Die AWS CDK-CLI ruft AWS Konto- und AWS Regionsinformationen aus Standardquellen ab. Weitere Informationen finden Sie unter Umgebungen für das AWS CDK. Sie können --account and --region options with verwendencdk migrate, um andere Werte anzugeben.

Ausgabeverzeichnis Ihres neuen CDK-Projekts

Standardmäßig erstellt die AWS CDK-CLI ein neues CDK-Projekt in Ihrem Arbeitsverzeichnis und verwendet den von Ihnen angegebenen Wert, um den Projektordner --stack-name zu benennen. Wenn derzeit ein Ordner mit demselben Namen existiert, überschreibt die AWS CDK-CLI diesen Ordner.

Mit der Option können Sie einen anderen Ausgabepfad für den neuen CDK-Projektordner angeben. --output-path

Quelle der Migration

Bieten Sie eine Option an, um die Quelle anzugeben, von der aus Sie migrieren.

  • --from-path— Migrieren Sie von einer lokalen AWS CloudFormation Vorlage.

  • --from-scan— Migrieren Sie von bereitgestellten Ressourcen in einem AWS Konto und einer AWS Region.

  • --from-stack— Migrieren Sie von einem AWS CloudFormation Stack.

Abhängig von Ihrer Migrationsquelle können Sie zusätzliche Optionen bereitstellen, um den cdk migrate Befehl anzupassen.

Migrieren Sie von einem AWS CloudFormation stapeln

Um von einem bereitgestellten AWS CloudFormation Stack zu migrieren, geben Sie die --from-stack Option an. Geben Sie den Namen Ihres bereitgestellten AWS CloudFormation Stacks mit an--stack-name. Im Folgenden wird ein Beispiel gezeigt:

$ cdk migrate --from-stack --stack-name "myCloudFormationStack"

Die AWS CDK-CLI wird Folgendes tun:

  1. Rufen Sie die AWS CloudFormation Vorlage Ihres bereitgestellten Stacks ab.

  2. Führen Sie auscdk init, um eine neue CDK-App zu initialisieren.

  3. Erstellen Sie in der CDK-App einen Stack, der Ihren migrierten Stack enthält. AWS CloudFormation

Wenn Sie von einem bereitgestellten AWS CloudFormation Stack migrieren, versucht die AWS CDK-CLI, die logischen IDs der bereitgestellten Ressourcen und den Namen des bereitgestellten AWS CloudFormation Stacks den migrierten Ressourcen und dem Stack in der neuen CDK-App zuzuordnen.

Nach der Migration können Sie Ihre CDK-App normal verwalten und ändern. Bei der Bereitstellung AWS CloudFormation wird die Bereitstellung aufgrund des passenden AWS CloudFormation Stack-Namens als AWS CloudFormation Stack-Update identifiziert. Ressourcen mit passenden logischen IDs werden aktualisiert. Weitere Informationen zur Bereitstellung finden Sie unter Verwalten und Bereitstellen Ihrer CDK-App.

Migrieren Sie von einem AWS CloudFormation Vorlage

CDK Migrate unterstützt die Migration von AWS CloudFormation Vorlagen, die in oder formatiert sind. JSON YAML

Um von einer lokalen AWS CloudFormation Vorlage zu migrieren, verwenden Sie die --from-path Option und geben Sie einen Pfad zur lokalen Vorlage an. Sie müssen auch die erforderliche --stack-name Option angeben. Im Folgenden wird ein Beispiel gezeigt:

$ cdk migrate --from-path "./template.json" --stack-name "myCloudFormationStack"

Die AWS CDK-CLI wird Folgendes tun:

  1. Rufen Sie Ihre lokale AWS CloudFormation Vorlage ab.

  2. Führen Sie auscdk init, um eine neue CDK-App zu initialisieren.

  3. Erstellen Sie in der CDK-App einen Stack, der Ihre migrierte Vorlage enthält. AWS CloudFormation

Nach der Migration können Sie Ihre CDK-App normal verwalten und ändern. Bei der Bereitstellung haben Sie die folgenden Optionen:

  • AWS CloudFormation Stapel aktualisieren — Wenn die lokale AWS CloudFormation Vorlage zuvor bereitgestellt wurde, können Sie den bereitgestellten AWS CloudFormation Stack aktualisieren.

  • Einen neuen AWS CloudFormation Stack bereitstellen — Wenn die lokale AWS CloudFormation Vorlage nie bereitgestellt wurde oder wenn Sie einen neuen Stack aus einer zuvor bereitgestellten Vorlage erstellen möchten, können Sie einen neuen AWS CloudFormation Stack bereitstellen.

Migrieren Sie von einem AWS SAM-Vorlage

Um von einer AWS SAM-Vorlage ( AWS Serverless Application Model) zu migrieren, müssen Sie sie zuerst in eine AWS CloudFormation Vorlage konvertieren oder bereitstellen, um einen AWS CloudFormation Stack zu erstellen.

Um eine AWS SAM-Vorlage in eine zu konvertieren AWS CloudFormation, können Sie den AWS sam validate --debug SAM-CLI-Befehl verwenden. Möglicherweise müssen Sie false in Ihrer samconfig.toml Datei lint auf auf setzen, bevor Sie diesen Befehl ausführen.

Um in einen AWS CloudFormation Stack zu konvertieren, stellen Sie die AWS SAM-Vorlage mithilfe der AWS SAM-CLI bereit. Migrieren Sie dann vom bereitgestellten Stack.

Migrieren Sie von den bereitgestellten Ressourcen

Um von bereitgestellten AWS Ressourcen zu migrieren, geben Sie die --from-scan Option an. Sie müssen auch die erforderliche --stack-name Option angeben. Im Folgenden wird ein Beispiel gezeigt:

$ cdk migrate --from-scan --stack-name "myCloudFormationStack"

Die AWS CDK-CLI wird Folgendes tun:

  1. Scannen Sie Ihr Konto nach Ressourcen- und Immobiliendetails — Die AWS CDK-CLI verwendet den IaC-Generator, um Ihr Konto zu scannen und Details zu sammeln.

  2. Generieren Sie eine AWS CloudFormation Vorlage — Nach dem Scannen verwendet die AWS CDK CLI den IaC-Generator, um eine Vorlage zu erstellen. AWS CloudFormation

  3. Initialisieren Sie eine neue CDK-App und migrieren Sie Ihre Vorlage — Die AWS CDK-CLI wird ausgeführt, um eine neue CDK-App cdk init zu initialisieren, und migriert Ihre AWS CloudFormation Vorlage als einzelner Stack in die AWS CDK-App.

Verwenden Sie Filter

Standardmäßig scannt die AWS CDK-CLI die gesamte AWS Umgebung und migriert Ressourcen bis zur maximalen Kontingentgrenze des IaC-Generators. Sie können mit der AWS CDK-CLI Filter bereitstellen, um Kriterien festzulegen, nach denen Ressourcen von Ihrem Konto zur neuen CDK-App migriert werden. Weitere Informationen hierzu finden Sie unter --filter .

Mit dem IaC-Generator nach Ressourcen suchen

Abhängig von der Anzahl der Ressourcen in Ihrem Konto kann das Scannen einige Minuten dauern. Während des Scanvorgangs wird eine Fortschrittsleiste angezeigt.

Unterstützte Ressourcentypen

Die AWS CDK-CLI migriert Ressourcen, die vom IaC-Generator unterstützt werden. Eine vollständige Liste finden Sie unter Unterstützung von Ressourcentypen im AWS CloudFormation Benutzerhandbuch.

Auflösen von schreibgeschützten Eigenschaften

Einige unterstützte Ressourcen enthalten Eigenschaften, die nur zum Schreiben verwendet werden können. In diese Eigenschaften kann geschrieben werden, um die Eigenschaft zu konfigurieren, sie können jedoch nicht vom IaC-Generator gelesen werden oder AWS CloudFormation um den Wert abzurufen. Beispielsweise kann eine Eigenschaft, die zur Angabe eines Datenbankkennworts verwendet wird, aus Sicherheitsgründen schreibgeschützt sein.

Beim Scannen von Ressourcen während der Migration erkennt der IaC-Generator Ressourcen, die möglicherweise nur schreibgeschützte Eigenschaften enthalten, und ordnet sie einem der folgenden Typen zu:

  • MUTUALLY_EXCLUSIVE_PROPERTIES— Dabei handelt es sich um schreibgeschützte Eigenschaften für eine bestimmte Ressource, die austauschbar sind und einem ähnlichen Zweck dienen. Eine der sich gegenseitig ausschließenden Eigenschaften ist für die Konfiguration Ihrer Ressource erforderlich. Die ZipFile Eigenschaften, S3BucketImageUri, und für eine AWS::Lambda::Function Ressource schließen sich beispielsweise gegenseitig aus und sind schreibgeschützt. Jeder von ihnen kann verwendet werden, um Ihre Funktionsressourcen zu spezifizieren, Sie müssen jedoch eines verwenden.

  • MUTUALLY_EXCLUSIVE_TYPES— Dies sind nur schreibgeschützte Eigenschaften, die mehrere Konfigurationstypen akzeptieren. Beispielsweise akzeptiert die Body Eigenschaft einer AWS::ApiGateway::RestApi Ressource einen Objekt- oder Zeichenfolgentyp.

  • UNSUPPORTED_PROPERTIES— Dies sind nur schreibgeschützte Eigenschaften, die nicht unter die beiden anderen Kategorien fallen. Es handelt sich entweder um optionale Eigenschaften oder um erforderliche Eigenschaften, die eine Reihe von Objekten akzeptieren.

Weitere Informationen zu schreibgeschützten Eigenschaften und wie der IaC-Generator sie verwaltet, wenn nach bereitgestellten Ressourcen gesucht und AWS CloudFormation Vorlagen erstellt werden, finden Sie im Benutzerhandbuch unter IaC-Generator- und schreibgeschützte Eigenschaften. AWS CloudFormation

Nach der Migration müssen Sie in der neuen CDK-App Eigenschaftswerte angeben, die nur zum Schreiben verwendet werden können. Die AWS CDK-CLI fügt der ReadMe CDK-Projektdatei einen Abschnitt „Warnungen“ an, um alle Eigenschaften zu dokumentieren, die nur schreibgeschützt sind und vom IaC-Generator identifiziert wurden. Im Folgenden wird ein Beispiel gezeigt:

# Welcome to your CDK TypeScript project
...
## Warnings
### Write-only properties
Write-only properties are resource property values that can be written to but can't be read by AWS CloudFormation or CDK Migrate. For more information, see [IaC generator and write-only properties](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC-write-only-properties.html).

Write-only properties discovered during migration are organized here by resource ID and categorized by write-only property type. Resolve write-only properties by providing property values in your CDK app. For guidance, see [Resolve write-only properties](https://docs.aws.amazon.com/cdk/v2/guide/migrate.html#migrate-resources-writeonly).
### MyLambdaFunction
- **UNSUPPORTED_PROPERTIES**:
  - SnapStart/ApplyOn: Applying SnapStart setting on function resource type.Possible values: [PublishedVersions, None]
This property can be replaced with other types
  - Code/S3ObjectVersion: For versioned objects, the version of the deployment package object to use.
This property can be replaced with other exclusive properties
- **MUTUALLY_EXCLUSIVE_PROPERTIES**:
  - Code/S3Bucket: An Amazon S3 bucket in the same AWS Region as your function. The bucket can be in a different AWS account.
This property can be replaced with other exclusive properties
  - Code/S3Key: The Amazon S3 key of the deployment package.
This property can be replaced with other exclusive properties

  • Warnungen sind unter Überschriften angeordnet, die die logische ID der Ressource identifizieren, mit der sie verknüpft sind.

  • Warnungen werden nach Typ kategorisiert. Diese Typen kommen direkt vom IAC-Generator.

So lösen Sie Eigenschaften auf, die nur zum Schreiben verwendet werden können

  1. Identifizieren Sie im Abschnitt „Warnungen“ in der Datei Ihres CDK-Projekts die schreibgeschützten Eigenschaften, die aufgelöst werden sollen. ReadMe Hier können Sie sich die Ressourcen in Ihrer CDK-App notieren, die möglicherweise nur schreibgeschützte Eigenschaften enthalten, und die erkannten Eigenschaftstypen identifizieren, die nur zum Schreiben verwendet werden können.

    1. Bestimmen Sie beispielsweiseMUTUALLY_EXCLUSIVE_PROPERTIES, welche sich gegenseitig ausschließende Eigenschaft in Ihrer CDK-App konfiguriert werden soll. AWS

    2. Ermitteln Sie zum BeispielMUTUALLY_EXCLUSIVE_TYPES, welchen akzeptierten Typ Sie für die Konfiguration der Eigenschaft verwenden werden.

    3. Stellen Sie beispielsweise festUNSUPPORTED_PROPERTIES, ob die Eigenschaft optional oder erforderlich ist. Konfigurieren Sie dann nach Bedarf.

  2. Verwenden Sie die Anweisungen des IaC-Generators und die schreibgeschützten Eigenschaften, um zu erfahren, was die Warnungstypen bedeuten.

  3. In Ihrer CDK-App werden die zu lösenden Eigenschaftswerte, die nur schreibgeschützt sind, auch im Abschnitt Ihrer App angegeben. Props Geben Sie hier die richtigen Werte ein. Eigenschaftsbeschreibungen und Anleitungen finden Sie in der AWS CDK-API-Referenz.

    Im Folgenden finden Sie ein Beispiel für den Props Abschnitt in einer migrierten CDK-App mit zwei Eigenschaften, die nur zum Schreiben verwendet werden müssen:

    export interface MyTestAppStackProps extends cdk.StackProps {
  /**
   * The Amazon S3 key of the deployment package.
   */
  readonly lambdaFunction00asdfasdfsadf008grk1CodeS3Keym8P82: string;
  /**
   * An Amazon S3 bucket in the same AWS Region as your function. The bucket can be in a different AWS account.
   */
  readonly lambdaFunction00asdfasdfsadf008grk1CodeS3Bucketzidw8: string;
}

    Sobald Sie alle schreibgeschützten Eigenschaftswerte aufgelöst haben, können Sie sich auf die Bereitstellung vorbereiten.

Die migrate.json-Datei

Die AWS CDK-CLI erstellt während der Migration eine migrate.json Datei in Ihrem AWS CDK-Projekt. Diese Datei enthält Referenzinformationen zu Ihren bereitgestellten Ressourcen. Wenn Sie Ihre CDK-App zum ersten Mal bereitstellen, verwendet die AWS CDK-CLI diese Datei, um auf Ihre bereitgestellten Ressourcen zu verweisen, ordnet Ihre Ressourcen dem neuen AWS CloudFormation Stack zu und löscht die Datei.

Verwalten und implementieren Sie Ihre CDK-App

Bei der Migration zu AWS CDK ist die neue CDK-App möglicherweise nicht sofort einsatzbereit. In diesem Thema werden die Maßnahmen beschrieben, die Sie bei der Verwaltung und Bereitstellung Ihrer neuen CDK-App berücksichtigen sollten.

Bereiten Sie sich auf die Bereitstellung vor

Vor der Bereitstellung müssen Sie Ihre CDK-App vorbereiten.

Synthetisieren Sie Ihre App

Verwenden Sie den cdk synth Befehl, um den Stack in Ihrer CDK-App zu einer Vorlage zu synthetisieren. AWS CloudFormation

Wenn Sie von einem bereitgestellten AWS CloudFormation Stack oder einer Vorlage migriert haben, können Sie die synthetisierte Vorlage mit der migrierten Vorlage vergleichen, um Ressourcen- und Eigenschaftswerte zu überprüfen.

Weitere Informationen dazu finden Sie unter Synthetisieren von cdk synth Stacks.

Führe einen Unterschied durch

Wenn Sie von einem bereitgestellten AWS CloudFormation Stack migriert haben, können Sie den Befehl cdk diff verwenden, um mit dem Stack in Ihrer neuen CDK-App zu vergleichen.

Weitere Informationen zu cdk diff finden Sie unter Stacks vergleichen. Stapel vergleichen

Bootstrappen Sie Ihre Umgebung

Wenn Sie die Bereitstellung zum ersten Mal von einer AWS Umgebung aus durchführen, verwenden Sie diese Option, cdk bootstrap um Ihre Umgebung vorzubereiten. Weitere Informationen finden Sie unter AWS CDK-Bootstrapping.

Stellen Sie Ihre CDK-App bereit

Wenn Sie eine CDK-App bereitstellen, verwendet die AWS CDK-CLI den AWS CloudFormation Dienst zur Bereitstellung Ihrer Ressourcen. Ressourcen werden in der CDK-App in einem einzigen Stack gebündelt und als einzelner Stack bereitgestellt. AWS CloudFormation

Je nachdem, von wo aus Sie migriert haben, können Sie die Bereitstellung durchführen, um einen neuen AWS CloudFormation Stack zu erstellen oder einen vorhandenen Stack zu aktualisieren. AWS CloudFormation

Bereitstellen, um einen neuen AWS CloudFormation Stack zu erstellen

Wenn Sie von bereitgestellten Ressourcen migriert haben, erstellt die AWS CDK-CLI bei der Bereitstellung automatisch einen neuen AWS CloudFormation Stack. Ihre bereitgestellten Ressourcen werden in den neuen AWS CloudFormation Stack aufgenommen.

Wenn Sie von einer lokalen AWS CloudFormation Vorlage migriert haben, die nie bereitgestellt wurde, erstellt die AWS CDK-CLI bei der Bereitstellung automatisch einen neuen AWS CloudFormation Stack.

Wenn Sie von einem bereitgestellten AWS CloudFormation Stack oder einer lokalen AWS CloudFormation Vorlage migriert haben, die zuvor bereitgestellt wurde, können Sie eine Bereitstellung durchführen, um einen neuen Stack zu erstellen. AWS CloudFormation Gehen Sie wie folgt vor, um einen neuen Stack zu erstellen:

  • In einer neuen AWS Umgebung bereitstellen. Dies besteht darin, ein anderes AWS Konto zu verwenden oder die Bereitstellung in einer anderen AWS Region durchzuführen.

  • Wenn Sie einen neuen Stack in derselben AWS Umgebung wie der migrierte Stack oder die migrierte Vorlage bereitstellen möchten, müssen Sie den Stacknamen in Ihrer CDK-App auf einen neuen Wert ändern. Sie müssen auch alle logischen IDs der Ressourcen in Ihrer CDK-App ändern. Anschließend können Sie die Bereitstellung in derselben Umgebung durchführen, um einen neuen Stack und neue Ressourcen zu erstellen.

Bereitstellen, um einen vorhandenen AWS CloudFormation Stack zu aktualisieren

Wenn Sie von einem bereitgestellten AWS CloudFormation Stack oder einer lokalen AWS CloudFormation Vorlage migriert haben, die zuvor bereitgestellt wurde, können Sie eine Bereitstellung durchführen, um den vorhandenen AWS CloudFormation Stack zu aktualisieren.

Stellen Sie sicher, dass der Stack-Name in Ihrer CDK-App mit dem Stack-Namen des bereitgestellten AWS CloudFormation Stacks übereinstimmt, und stellen Sie ihn in derselben AWS Umgebung bereit.