Wählen Sie Ihre Cookie-Einstellungen aus

Wir verwenden essentielle Cookies und ähnliche Tools, die für die Bereitstellung unserer Website und Services erforderlich sind. Wir verwenden Performance-Cookies, um anonyme Statistiken zu sammeln, damit wir verstehen können, wie Kunden unsere Website nutzen, und Verbesserungen vornehmen können. Essentielle Cookies können nicht deaktiviert werden, aber Sie können auf „Anpassen“ oder „Ablehnen“ klicken, um Performance-Cookies abzulehnen.

Wenn Sie damit einverstanden sind, verwenden AWS und zugelassene Drittanbieter auch Cookies, um nützliche Features der Website bereitzustellen, Ihre Präferenzen zu speichern und relevante Inhalte, einschließlich relevanter Werbung, anzuzeigen. Um alle nicht notwendigen Cookies zu akzeptieren oder abzulehnen, klicken Sie auf „Akzeptieren“ oder „Ablehnen“. Um detailliertere Entscheidungen zu treffen, klicken Sie auf „Anpassen“.

Migrieren Sie vorhandene Ressourcen und AWS CloudFormation Vorlagen auf das AWS CDK

Fokusmodus
Migrieren Sie vorhandene Ressourcen und AWS CloudFormation Vorlagen auf das AWS CDK - AWS Cloud Development Kit (AWS CDK) v2

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.

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.

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

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

Wie funktioniert die Migration

Verwenden Sie die AWS CDK CLI cdk migrateBefehl, um aus den folgenden Quellen zu migrieren:

  • Bereitgestellte AWS Ressourcen.

  • Bereitgestellte AWS CloudFormation Stapel.

  • Lokale AWS CloudFormation Vorlagen.

Eingesetzte 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-Generatordienst, um in Ihrer AWS Umgebung nach Ressourcen zu suchen und Ressourcendetails zu sammeln. Weitere Informationen zum IaC-Generator finden Sie im Benutzerhandbuch unter Generieren von Vorlagen für vorhandene Ressourcen.AWS CloudFormation

Nach dem Sammeln der Ressourcendetails AWS CDK CLI erstellt eine neue CDK-App, die einen einzelnen Stapel mit Ihren migrierten Ressourcen enthält.

Bereitgestellte Stacks AWS CloudFormation

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

Lokale Vorlagen AWS CloudFormation

Sie können von einer lokalen AWS CloudFormation Vorlage aus migrieren. Lokale Vorlagen können bereitgestellte Ressourcen enthalten oder auch nicht. Die AWS CDK CLI erstellt eine neue CDK-App, die einen einzigen Stapel 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 erforderte, AWS CDK bis er überhaupt AWS CloudFormation begonnen werden konnte. Mit CDK Migrate AWS CDK CLI erleichtert Ihnen einen Großteil des Migrationsaufwands in einem Bruchteil der Zeit. Mit CDK Migrate können Sie schnell mit der AWS CDK Entwicklung und Verwaltung neuer und vorhandener Anwendungen beginnen. 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 bestehende CDK-App zu importieren. Weitere Informationen hierzu finden Sie unter Importiere vorhandene 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 AWS CDK CLI verwendetcdk 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 aus 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 einzigen Stack enthalten

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

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

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

Ressourcen migrieren

Projektelemente, wie z. B. 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.

Zustandsbehaftete Ressourcen migrieren

Wenn Sie statusbehaftete Ressourcen wie Datenbanken und Amazon Simple Storage Service (Amazon S3) -Buckets migrieren, 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 statusbehaftete 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 migrierten Ressource bereit.

Überlegungen bei der Migration von einer Vorlage AWS CloudFormation

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 systemeigenen Funktionen

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

Überlegungen bei der Migration von bereitgestellten Ressourcen

Einschränkungen beim Scannen

Beim Scannen Ihrer Umgebung nach Ressourcen unterliegt der IaC-Generator bestimmten Einschränkungen hinsichtlich der Daten, die er abrufen kann, und Beschränkungen bezüglich der Kontingente beim Scannen. Weitere Informationen finden Sie unter Überlegungen im AWS CloudFormation Benutzerhandbuch.

Voraussetzungen

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

Beginnen Sie mit CDK Migrate

Führen Sie zunächst den AWS CDK CLI cdk migrateBefehl aus einem Verzeichnis Ihrer Wahl. Geben Sie je nach Art der Migration, die Sie durchführen, die erforderlichen und optionalen Optionen an.

Eine vollständige Liste und Beschreibung der Optionen, die Sie zusammen verwenden könnencdk migrate, finden Sie untercdk 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

Wird verwendet--language, um die Programmiersprache der neuen CDK-App anzugeben.

AWS Konto und AWS-Region

Das AWS CDK CLI ruft AWS Konto und AWS-Region Informationen aus Standardquellen ab. Weitere Informationen finden Sie unter Umgebungen für die AWS CDK. Sie können die --region Optionen --account und mit verwendencdk migrate, um andere Werte anzugeben.

Ausgabeverzeichnis Ihres neuen CDK-Projekts

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

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

Quelle der Migration

Geben Sie eine Option an, um die Quelle anzugeben, von der 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 Stack aus.

Abhängig von Ihrer Migrationsquelle können Sie zusätzliche Optionen zur Anpassung des cdk migrate Befehls bereitstellen.

Migrieren Sie von einem AWS CloudFormation Stack

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 ein--stack-name. Im Folgenden wird ein Beispiel gezeigt:

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

Der 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, AWS CDK CLI versucht, die bereitgestellte Ressource logisch IDs und den bereitgestellten AWS CloudFormation Stacknamen 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 IDs übereinstimmender Logik werden aktualisiert. Weitere Informationen zur Bereitstellung finden Sie unterVerwalten und implementieren Sie Ihre CDK-App.

Aus einer AWS CloudFormation Vorlage migrieren

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. Ausführencdk 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 Stack 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 einer AWS SAM Vorlage

Um von einer AWS Serverless Application Model (AWS SAM) -Vorlage 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 zu konvertieren AWS CloudFormation, können Sie den AWS SAM CLI sam validate --debugBefehl. Möglicherweise müssen Sie false in Ihrer samconfig.toml Datei lint auf einstellen, bevor Sie diesen Befehl ausführen können.

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

Migrieren Sie von 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 — Das 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 AWS CDK CLI verwendet den IaC-Generator, um eine AWS CloudFormation Vorlage zu erstellen.

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

Verwenden Sie Filter

Standardmäßig ist der AWS CDK CLI scannt die gesamte AWS Umgebung und migriert Ressourcen bis zur maximalen Kontingentgrenze des IaC-Generators. Sie können Filter mit dem bereitstellen AWS CDK CLI 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 ein Fortschrittsbalken angezeigt.

Unterstützte Ressourcentypen

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

Löst Eigenschaften auf, die nur über Schreibzugriff verfügen

Einige unterstützte Ressourcen enthalten schreibgeschützte Eigenschaften. In diese Eigenschaften kann geschrieben werden, um die Eigenschaft zu konfigurieren, sie können jedoch nicht vom IaC-Generator gelesen oder AWS CloudFormation der Wert abgerufen werden. 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 schreibgeschützte Eigenschaften enthalten, und kategorisiert sie in einen der folgenden Typen:

  • 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. Bei den ZipFile Eigenschaften S3BucketImageUri, und einer AWS::Lambda::Function Ressource handelt es sich beispielsweise um sich gegenseitig ausschließende, schreibgeschützte Eigenschaften. Jede von ihnen kann verwendet werden, um Ihre Funktionsressourcen zu spezifizieren, aber Sie müssen eines verwenden.

  • MUTUALLY_EXCLUSIVE_TYPES— Dabei handelt es sich um erforderliche 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 reine Schreibeigenschaften, 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 IaC Generator sie verwaltet, wenn nach bereitgestellten Ressourcen gesucht und AWS CloudFormation Vorlagen erstellt werden, finden Sie unter IaC-Generator und schreibgeschützte Eigenschaften im Benutzerhandbuch.AWS CloudFormation

Nach der Migration müssen Sie in der neuen CDK-App Eigenschaftswerte mit Schreibschutz angeben. Die AWS CDK CLI fügt der ReadMe Datei des CDK-Projekts einen Abschnitt mit Warnungen an, um alle schreibgeschützten Eigenschaften zu dokumentieren, 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 in Überschriften angeordnet, die die logische ID der Ressource angeben, der sie zugeordnet sind.

  • Warnungen werden nach Typ kategorisiert. Diese Typen stammen direkt vom IaC-Generator.

Um Eigenschaften aufzulösen, bei denen nur Schreibzugriff möglich ist
  1. Identifizieren Sie im Abschnitt „Warnungen“ der Datei Ihres CDK-Projekts die Eigenschaften, bei denen nur Schreibzugriff besteht, die behoben werden sollen. ReadMe Hier können Sie sich die Ressourcen in Ihrer CDK-App notieren, die schreibgeschützte Eigenschaften enthalten können, und die erkannten schreibgeschützten Eigenschaftstypen identifizieren.

    1. Legen Sie nämlich festMUTUALLY_EXCLUSIVE_PROPERTIES, welche sich gegenseitig ausschließende Eigenschaft in Ihrer App konfiguriert werden soll. AWS CDK

    2. Stellen Sie MUTUALLY_EXCLUSIVE_TYPES nämlich fest, welchen akzeptierten Typ Sie für die Konfiguration der Eigenschaft verwenden werden.

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

  2. Verschaffen Sie sich anhand der Anweisungen des IaC-Generators und der schreibgeschützten Eigenschaften einen Überblick über die Bedeutung der Warnungstypen.

  3. In deiner CDK-App werden Eigenschaftswerte, die nur mit Schreibzugriff aufgelöst werden sollen, auch im Abschnitt deiner App angegeben. Props Geben Sie hier die richtigen Werte ein. Objektbeschreibungen und Anleitungen finden Sie in der AWS CDK API-Referenz.

    Im Folgenden finden Sie ein Beispiel für den Props Abschnitt innerhalb einer migrierten CDK-App mit zwei Eigenschaften, die nur beim Schreiben verwendet werden müssen, die aufgelöst 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 Eigenschaftswerte für schreibgeschützte Eigenschaften aufgelöst haben, können Sie sich auf die Bereitstellung vorbereiten.

Die Datei migrate.json

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, AWS CDK CLI verwendet 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 ist AWS CDK die neue CDK-App möglicherweise nicht sofort einsatzbereit. In diesem Thema werden 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 über cdk synth finden Sie unter Synthetisieren Sie Stapel.

Führen Sie einen Vergleich durch

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

Weitere Informationen über cdk diff finden Sie unter. Stapel vergleichen

Bootstrap für deine Umgebung

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

Stellen Sie Ihre CDK-App bereit

Wenn Sie eine CDK-App bereitstellen, AWS CDK CLI nutzt den AWS CloudFormation Service, um Ihre Ressourcen bereitzustellen. Ressourcen werden in der CDK-App in einem einzigen Stack gebündelt und als einzelner Stapel bereitgestellt. AWS CloudFormation

Je nachdem, von wo aus Sie migriert haben, können Sie die Bereitstellung verwenden, 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, AWS CDK CLI erstellt 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 AWS CDK CLI erstellt 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 die Bereitstellung durchführen, um einen neuen AWS CloudFormation Stack zu erstellen. Gehen Sie wie folgt vor, um einen neuen Stack zu erstellen:

  • Stellen Sie es in einer neuen AWS Umgebung bereit. Dies besteht aus der Verwendung eines anderen AWS Kontos oder der Bereitstellung in einer anderen AWS-Region.

  • Wenn Sie einen neuen Stack in derselben AWS Umgebung wie der migrierte Stack oder die Vorlage bereitstellen möchten, müssen Sie den Stack-Namen in Ihrer CDK-App auf einen neuen Wert ändern. Sie müssen auch alle logischen IDs 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 Stacknamen des bereitgestellten AWS CloudFormation Stacks übereinstimmt, und stellen Sie die Lösung in derselben AWS Umgebung bereit.

DatenschutzNutzungsbedingungen für die WebsiteCookie-Einstellungen
© 2025, Amazon Web Services, Inc. oder Tochtergesellschaften. Alle Rechte vorbehalten.