View a markdown version of this page

Migrieren Sie bestehende Ressourcen und AWS CloudFormation Vorlagen zum AWS CDK - AWS Cloud-Entwicklungskit (AWS CDK) v2

Das ist der AWS CDK v2-Entwicklerhandbuch. Für das ältere CDK v1 wurde am 1. Juni 2022 der Wartungsservice aufgenommen 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 bestehende Ressourcen und AWS CloudFormation Vorlagen zum AWS CDK

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

Benutze das AWS Cloud-Entwicklungskit (AWS CDK) Befehlszeilenschnittstelle (AWS CDK (CLI) zur Migration bereitgestellt AWS Ressourcen, bereitgestellt AWS CloudFormation Stapel und lokal AWS CloudFormation Vorlagen für AWS CDK.

Wie funktioniert die Migration

Benutze das AWS CDK CLI cdk migrate Befehl zum Migrieren aus den folgenden Quellen:

  • Bereitgestellt AWS Ressourcen.

  • Eingesetzt AWS CloudFormation Stapel.

  • Lokal AWS CloudFormation Vorlagen.

Bereitgestellt AWS Ressourcen

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

Das AWS CDK CLI verwendet IaC-Generator Dienst zum Suchen nach Ressourcen in Ihrem AWS Umgebung zum Sammeln von Ressourcendetails. Weitere Informationen zum IAC-Generator finden Sie unter Generieren von Vorlagen für vorhandene Ressourcen in der AWS CloudFormation Benutzerleitfaden.

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

Bereitgestellt AWS CloudFormation Stapel

Sie können eine einzelne migrieren AWS CloudFormation zu einem neuen stapeln AWS CDK-App. Das AWS CDK CLI ruft das ab AWS CloudFormation Vorlage Ihres Stacks und erstellen Sie eine neue CDK-App. Die CDK-App wird aus einem einzigen Stack bestehen, der Ihren migrierten Stack enthält AWS CloudFormation Stapel.

Lokal AWS CloudFormation Vorlagen

Sie können von einem lokalen Standort migrieren AWS CloudFormation Vorlage. 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 AWS CloudFormation um Ihre Ressourcen bereitzustellen oder zu aktualisieren.

Vorteile von CDK Migrate

Ressourcen migrieren in AWS CDK war in der Vergangenheit ein manueller Prozess, der Zeit und Fachwissen in folgenden Bereichen erforderte AWS CloudFormation und AWS CDK, um überhaupt anzufangen. Mit CDK Migrate ist der AWS CDK CLI erleichtert Ihnen einen Großteil des Migrationsaufwands in einem Bruchteil der Zeit. Mit CDK Migrate können Sie schnell mit der Verwendung von beginnen AWS CDK zur Entwicklung und Verwaltung neuer und vorhandener Anwendungen auf AWS.

Überlegungen

Allgemeine Überlegungen

CDK Migrate im Vergleich zu CDK Import

Das cdk import Der 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 die Verwendung cdk import um eine oder mehrere Ressourcen gleichzeitig in eine neue oder bestehende CDK-App zu importieren. Weitere Informationen finden Sie unter Importiere vorhandene Ressourcen in einen Stack.

Das cdk migrate Befehl wird von bereitgestellten Ressourcen migriert, bereitgestellt AWS CloudFormation stapelweise oder lokal AWS CloudFormation Vorlagen in eine neue CDK-App. Während der Migration AWS CDK CLI verwendet cdk import um Ihre Ressourcen in die neue CDK-App zu importieren. Das AWS CDK CLI generiert auch L1-Konstrukte für jede Ressource für Sie. Wir empfehlen die Verwendung cdk migrate beim Import von einer unterstützten Migrationsquelle in eine neue AWS CDK-App.

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 AWS CloudFormation Stapel, Sie können nur einen einzigen migrieren AWS CloudFormation In der neuen CDK-App zu einem einzigen Stapel stapeln.

Vermögenswerte migrieren

Projektressourcen, wie AWS Lambda-Code wird 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 unter Unterstützung für Ressourcentypen in der AWS CloudFormation Benutzerleitfaden.

  • 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.

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

  • Stellen Sie die CDK-App auf dieselbe Weise bereit AWS Konto und AWS Region der migrierten Ressource.

Überlegungen bei der Migration von einem AWS CloudFormation Muster

CDK Migrate unterstützt die Migration einzelner Vorlagen

Bei der Migration AWS CloudFormation Vorlagen, Sie können 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 einem AWS CloudFormation Vorlage, die intrinsische Funktionen verwendet, die AWS CDK CLI wird versuchen, Ihre Logik in die CDK-App zu migrieren, und zwar mit Fn Klasse. Weitere Informationen finden Sie unter Klasse Fn in der AWS Cloud-Entwicklungskit (AWS API-Referenz (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 unter Überlegungen in der AWS CloudFormation Benutzerleitfaden.

Voraussetzungen

Vor der Verwendung der cdk migrate Befehl, schließen Sie alle Einrichtungsschritte in Erste Schritte mit dem AWS CDK.

Beginnen Sie mit CDK Migrate

Führen Sie zunächst den AWS CDK CLI cdk migrate Befehl aus einem Verzeichnis Ihrer Wahl. 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önnen cdk migrate, siehe cdk migrieren.

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 Stapel anzugeben, der innerhalb von erstellt wird AWS CDK-App nach der Migration. Der Stack-Name wird auch als Name Ihres verwendet AWS CloudFormation Stapel bei der Bereitstellung.

Sprache

Verwenden --language um die Programmiersprache der neuen CDK-App anzugeben.

AWS Konto und AWS Region

Die AWS CDK CLI ruft ab AWS Konto und AWS Regionsinformationen aus Standardquellen. Weitere Informationen finden Sie unter Umgebungen für die AWS CDK. Du kannst verwenden --account und --region Optionen mit cdk migrate um andere Werte bereitzustellen.

Ausgabeverzeichnis Ihres neuen CDK-Projekts

In der Standardeinstellung ist das AWS CDK CLI erstellt ein neues CDK-Projekt in Ihrem Arbeitsverzeichnis und verwendet den Wert, den Sie mit angeben --stack-name um den Projektordner zu benennen. Wenn derzeit ein Ordner mit dem gleichen Namen existiert, wird AWS CDK CLI überschreibt diesen Ordner.

Sie können einen anderen Ausgabepfad für den neuen CDK-Projektordner mit dem --output-path Option.

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 AWS Region.

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

Abhängig von Ihrer Migrationsquelle können Sie zusätzliche Optionen zur Anpassung der cdk migrate Befehl.

Migrieren Sie von einem AWS CloudFormation stapeln

Um von einem bereitgestellten zu migrieren AWS CloudFormation Stapel, stellen Sie das bereit --from-stack Option. Geben Sie den Namen Ihres Deployments an AWS CloudFormation stapeln mit --stack-name. Im Folgenden wird ein Beispiel gezeigt:

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

Das AWS CDK CLI wird Folgendes tun:

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

  2. Führen Sie aus cdk init um eine neue CDK-App zu initialisieren.

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

Wenn Sie von einem Deployed migrieren AWS CloudFormation Stapel, der AWS CDK CLI versucht, die logischen IDs der bereitgestellten Ressourcen mit den bereitgestellten abzugleichen AWS CloudFormation Stack-Name für die migrierten Ressourcen und den Stack in der neuen CDK-App.

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

Migrieren Sie von einem AWS CloudFormation Muster

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

Um von einem lokalen Standort zu migrieren AWS CloudFormation Vorlage, verwenden Sie die --from-path Option und geben Sie einen Pfad zur lokalen Vorlage an. Sie müssen auch die erforderlichen Angaben machen --stack-name Option. 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 Ihr lokales ab AWS CloudFormation Vorlage.

  2. Lauf cdk init um eine neue CDK-App zu initialisieren.

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

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

  • Aktualisieren Sie eine AWS CloudFormation stapeln — Wenn das Lokal AWS CloudFormation Die Vorlage wurde zuvor bereitgestellt, Sie können die bereitgestellte aktualisieren AWS CloudFormation stapeln.

  • Stellen Sie ein neues bereit AWS CloudFormation stapeln — Wenn das Lokal AWS CloudFormation Die Vorlage wurde nie bereitgestellt, oder wenn Sie einen neuen Stack aus einer zuvor bereitgestellten Vorlage erstellen möchten, können Sie eine neue bereitstellen AWS CloudFormation Stapel.

Migrieren Sie von einem AWS SAM-Vorlage

Um von einem zu migrieren AWS Serverloses Anwendungsmodell (AWS SAM-Vorlage), Sie müssen sie zuerst in eine konvertieren AWS CloudFormation Vorlage oder Bereitstellung, um eine zu erstellen AWS CloudFormation stapeln.

Um eine zu konvertieren AWS SAM-Vorlage zu AWS CloudFormation, du kannst das verwenden AWS GLEICHER CLIP sam validate --debug Befehl. Möglicherweise müssen Sie einstellen lint zu false in deinem samconfig.toml Datei, bevor Sie diesen Befehl ausführen.

Um in eine zu konvertieren AWS CloudFormation Stapel, stellen Sie das bereit AWS SAM-Vorlage unter Verwendung der AWS SAM-CLIP. Migrieren Sie dann vom bereitgestellten Stack.

Migrieren Sie von den bereitgestellten Ressourcen

Um von bereitgestellten Daten zu migrieren AWS Ressourcen, stellen Sie die zur Verfügung --from-scan Option. Sie müssen auch die erforderlichen Angaben machen --stack-name Option. Im Folgenden wird ein Beispiel gezeigt:

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

Die AWS CDK CLI wird Folgendes tun:

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

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

  3. Initialisieren Sie eine neue CDK-App und migrieren Sie Ihre Vorlage — Das AWS CDK CLI läuft cdk init um ein neues zu initialisieren AWS CDK-App und migriert Ihre AWS CloudFormation Vorlage in die CDK-App als einzelner Stapel.

Verwenden Sie Filter

In der Standardeinstellung ist der AWS CDK CLI scannt das gesamte AWS Umgebung und Migration von Ressourcen bis zur maximalen Kontingentgrenze des IaC-Generators. Sie können Filter mit dem bereitstellen AWS CDK-CLI zur Angabe von Kriterien, 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 für Ressourcentypen in der AWS CloudFormation Benutzerleitfaden.

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, aber sie können nicht vom IaC-Generator gelesen werden oder AWS CloudFormation um den Wert zu erhalten. 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 erforderlich, um Ihre Ressource zu konfigurieren. Zum Beispiel S3Bucket, ImageUri, und ZipFile Eigenschaften für einen AWS::Lambda::Function Ressourcen sind sich gegenseitig ausschließende Eigenschaften, die nur zum Schreiben bestimmt sind. 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. Zum Beispiel Body Eigentum eines AWS::ApiGateway::RestApi Die Ressource akzeptiert einen Objekt- oder Zeichenfolgentyp.

  • UNSUPPORTED_PROPERTIES — Dies sind nur schreibgeschützte Eigenschaften, die nicht unter die anderen beiden 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 dazu, wie der IaC-Generator sie beim Suchen nach bereitgestellten Ressourcen und beim Erstellen von Objekten verwaltet AWS CloudFormation Vorlagen finden Sie unter IaC-Generator und Eigenschaften, die nur geschrieben werden können in der AWS CloudFormation Benutzerleitfaden.

Nach der Migration müssen Sie in der neuen CDK-App Eigenschaftswerte angeben, die nur geschrieben werden können. Das AWS CDK CLI wird eine anhängen Warnungen Abschnitt zu den CDK-Projekten ReadMe Datei zur Dokumentation aller schreibgeschützten Eigenschaften, die 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 nach Überschriften angeordnet, die die logische ID der Ressource identifizieren, der sie zugeordnet 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 Eigenschaften, die nur zum Schreiben verwendet werden sollen, mithilfe von Warnungen Abschnitt Ihres CDK-Projekts ReadMe datei. Hier können Sie die Ressourcen in Ihrer CDK-App notieren, die schreibgeschützte Eigenschaften enthalten können, und die erkannten Eigenschaftstypen identifizieren, die nur zum Schreiben verwendet werden können.

    1. Für MUTUALLY_EXCLUSIVE_PROPERTIES, legen Sie fest, welche sich gegenseitig ausschließende Eigenschaft in Ihrem konfiguriert werden soll AWS CDK-App.

    2. Für MUTUALLY_EXCLUSIVE_TYPES, legen Sie fest, welchen akzeptierten Typ Sie für die Konfiguration der Eigenschaft verwenden werden.

    3. Für UNSUPPORTED_PROPERTIES, stellen Sie fest, ob die Eigenschaft optional oder erforderlich ist. Konfigurieren Sie dann nach Bedarf.

  2. Verwenden Sie die Anweisungen von IaC-Generator und Eigenschaften, die nur geschrieben werden können um zu referenzieren, was die Warnungstypen bedeuten.

  3. In Ihrer CDK-App werden Eigenschaftswerte, die nur durch Schreiben aufgelöst werden können, auch in der Props Abschnitt Ihrer App. Geben Sie hier die richtigen Werte ein. Beschreibungen der Eigenschaften und Anleitungen finden Sie im AWS CDK API-Referenz.

    Das Folgende ist ein Beispiel für 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 eine migrate.json Datei in Ihrem AWS CDK-Projekt während der Migration. Diese Datei enthält Referenzinformationen zu Ihren bereitgestellten Ressourcen. Wenn Sie Ihre CDK-App zum ersten Mal bereitstellen, wird AWS CDK CLI verwendet diese Datei, um auf Ihre bereitgestellten Ressourcen zu verweisen, und ordnet Ihre Ressourcen den neuen zu AWS CloudFormation stapeln und löscht die Datei.

Verwalte und stelle deine CDK-App bereit

Bei der Migration zu AWS CDK, die neue CDK-App ist 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

Benutze das cdk synth Befehl, um den Stack in Ihrer CDK-App zu einem zu synthetisieren AWS CloudFormation Vorlage.

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

Um mehr zu erfahren über cdk synth, siehe Synthetisieren Sie Stapel.

Führe einen Unterschied durch

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

Weitere Informationen zu cdk diff finden Sie unter Stapel vergleichen.

Bootstrappen Sie Ihre Umgebung

Wenn Sie die Bereitstellung von einem AWS Verwenden Sie zum ersten Mal eine Umgebung cdk bootstrap um deine Umgebung vorzubereiten. Weitere Informationen finden Sie unter AWS CDK-Bootstrapping.

Stellen Sie Ihre CDK-App bereit

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

Je nachdem, von wo aus Sie migriert haben, können Sie das Deployment durchführen, um ein neues zu erstellen AWS CloudFormation ein vorhandenes stapeln oder aktualisieren AWS CloudFormation stapeln.

Bereitstellen, um ein neues zu erstellen AWS CloudFormation stapeln

Wenn Sie von bereitgestellten Ressourcen migriert haben, AWS CDK CLI erstellt automatisch eine neue AWS CloudFormation Stapel bei der Bereitstellung. Ihre bereitgestellten Ressourcen werden in der neuen Version enthalten AWS CloudFormation stapeln.

Wenn Sie von einem lokalen Unternehmen migriert sind AWS CloudFormation Vorlage, die nie bereitgestellt wurde, die AWS CDK CLI erstellt automatisch eine neue AWS CloudFormation Stapel bei der Bereitstellung.

Wenn Sie von einem Deployed migriert haben AWS CloudFormation stapelweise oder lokal AWS CloudFormation Vorlage, die zuvor bereitgestellt wurde, können Sie bereitstellen, um eine neue zu erstellen AWS CloudFormation stapeln. Gehen Sie wie folgt vor, um einen neuen Stapel zu erstellen:

  • Auf einem neuen bereitstellen AWS Umgebung. Dies besteht aus der Verwendung eines anderen AWS Konto oder Bereitstellung auf einem anderen AWS Region.

  • Wenn Sie einen neuen Stack auf demselben bereitstellen möchten AWS In der Umgebung des migrierten Stacks oder der migrierten Vorlage 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 ein vorhandenes zu aktualisieren AWS CloudFormation stapeln

Wenn Sie von einem Deployed migriert sind AWS CloudFormation stapelweise oder lokal AWS CloudFormation Vorlage, die zuvor bereitgestellt wurde, können Sie bereitstellen, um die vorhandene zu aktualisieren AWS CloudFormation stapeln.

Stellen Sie sicher, dass der Stack-Name in Ihrer CDK-App mit dem Stack-Namen der bereitgestellten App übereinstimmt AWS CloudFormation Stapel und Deployment auf dasselbe AWS Umgebung.