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.
Migrieren Sie bereitgestellte AWS Ressourcen, AWS CloudFormation Stacks und CloudFormation Vorlagen in ein neues AWS CDK Projekt.
Mit diesem Befehl wird eine neue CDK-App erstellt, die einen einzelnen Stapel enthält, der mit dem Wert benannt ist, den Sie angeben. --stack-name Sie können die Migrationsquelle mit --from-scan--from-stack, oder --from-path konfigurieren.
Weitere Informationen zur Verwendung finden cdk migrate Sie unterMigrieren Sie vorhandene Ressourcen und AWS CloudFormation Vorlagen auf das AWS CDK.
Anmerkung
Der cdk migrate Befehl ist experimentell und könnte in future grundlegende Änderungen haben.
Verwendung
$cdk migrate<options>
Optionen
Für eine Liste der globalen Optionen, die mit allen CDKs funktionieren CLI Befehle finden Sie unterGlobale Optionen.
Erforderliche Optionen
--stack-nameSTRING-
Der Name des AWS CloudFormation Stacks, der nach der Migration in der CDK-App erstellt wird.
Erforderlich: Ja
Bedingte Optionen
--from-pathPATH-
Der Pfad zu der AWS CloudFormation Vorlage, die migriert werden soll. Geben Sie diese Option an, um eine lokale Vorlage anzugeben.
Erforderlich: Bedingt. Erforderlich, wenn von einer lokalen AWS CloudFormation Vorlage migriert wird.
--from-scanSTRING-
Wenn Sie bereitgestellte Ressourcen aus einer AWS Umgebung migrieren, geben Sie mit dieser Option an, ob ein neuer Scan gestartet werden soll oder ob AWS CDK CLI sollte den letzten erfolgreichen Scan verwenden.
Erforderlich: Bedingt. Erforderlich bei der Migration von bereitgestellten AWS Ressourcen.
Zulässige Werte:
most-recent,new --from-stackBOOLEAN-
Stellen Sie diese Option bereit, um von einem bereitgestellten AWS CloudFormation Stack zu migrieren. Wird verwendet
--stack-name, um den Namen des bereitgestellten AWS CloudFormation Stacks anzugeben.Erforderlich: Bedingt. Erforderlich, wenn von einem bereitgestellten AWS CloudFormation Stack migriert wird.
Optionale Optionen
--accountSTRING-
Das Konto, von dem die AWS CloudFormation Stack-Vorlage abgerufen werden soll.
Required: No
Standard: Das AWS CDK CLI ruft Kontoinformationen aus Standardquellen ab.
--compressBOOLEAN-
Stellen Sie diese Option bereit, um das generierte CDK-Projekt in ein zu komprimieren ZIP file.
Required: No
--filterARRAY-
Wird verwendet, wenn bereitgestellte Ressourcen von einem AWS Konto migriert werden und. AWS-Region Diese Option gibt einen Filter an, mit dem bestimmt wird, welche bereitgestellten Ressourcen migriert werden sollen.
Diese Option akzeptiert ein Array von Schlüssel-Wert-Paaren, wobei key für den Filtertyp und value für den zu filternden Wert steht.
Die folgenden Schlüssel werden akzeptiert:
-
resource-identifier— Ein Bezeichner für die Ressource. Der Wert kann die logische oder physische ID der Ressource sein. Beispiel,resource-identifier="ClusterName". -
resource-type-prefix— Das Präfix AWS CloudFormation für den Ressourcentyp. Geben Sie beispielsweiseresource-type-prefix="AWS::DynamoDB::"an, dass alle Amazon DynamoDB-Ressourcen gefiltert werden sollen. -
tag-key— Der Schlüssel eines Ressourcen-Tags. Beispiel,tag-key="myTagKey". -
tag-value— Der Wert eines Ressourcen-Tags. Beispiel,tag-value="myTagValue".
Stellen Sie mehrere Schlüssel-Wert-Paare für die
ANDbedingte Logik bereit. Das folgende Beispiel filtert nach jeder DynamoDB-Ressource, die mitmyTagKeydem Tag-Schlüssel gekennzeichnet ist:.--filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"Geben Sie die
--filterOption fürORbedingte Logik mehrmals in einem einzigen Befehl an. Das folgende Beispiel filtert nach jeder Ressource, die eine DynamoDB-Ressource ist oder mit dermyTagKeyals Tag-Schlüssel gekennzeichnet ist:.--filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey"Required: No
-
--help, -hBOOLEAN-
Zeigt Befehlsreferenzinformationen für den
cdk migrateBefehl an. --languageSTRING-
Die Programmiersprache, die für das CDK-Projekt verwendet werden soll, das während der Migration erstellt wurde.
Required: No
Gültige Werte:
typescript,python,,javacsharp,go.Standardwert:
typescript --output-pathPATH-
Der Ausgabepfad für das migrierte CDK-Projekt.
Required: No
Standard: Standardmäßig ist AWS CDK CLI verwendet Ihr aktuelles Arbeitsverzeichnis.
--regionSTRING-
Das AWS-Region , aus dem die AWS CloudFormation Stack-Vorlage abgerufen werden soll.
Required: No
Standard: Das AWS CDK CLI bezieht AWS-Region Informationen aus Standardquellen.
Beispiele
Einfaches Beispiel für die Migration von einem Stack CloudFormation
Migrieren Sie von einem bereitgestellten CloudFormation Stack in einer bestimmten AWS Umgebung mithilfe von--from-stack. Geben Sie --stack-name einen Namen für Ihren neuen CDK-Stack an. Im Folgenden finden Sie ein Beispiel für die Migration myCloudFormationStack zu einer neuen CDK-App, die TypeScript:
$cdk migrate --language typescript --from-stack --stack-name 'myCloudFormationStack'
Einfaches Beispiel für die Migration von einer lokalen Vorlage CloudFormation
Migrieren Sie von einer lokalen JSON- oder CloudFormation YAML-Vorlage mit. --from-path Geben Sie --stack-name an, ob Sie Ihrem neuen CDK-Stack einen Namen geben möchten. Im Folgenden finden Sie ein Beispiel, das eine neue CDK-App erstellt TypeScript das beinhaltet einen myCloudFormationStack Stapel aus einer lokalen template.json Datei:
$cdk migrate --stack-name "myCloudFormationStack" --language typescript --from-path "./template.json"
Einfaches Beispiel für die Migration von bereitgestellten Ressourcen AWS
Migrieren Sie bereitgestellte AWS Ressourcen aus einer bestimmten AWS Umgebung, die keinem CloudFormation Stack zugeordnet sind, mithilfe von--from-scan. Das CDK CLI nutzt die IaC generator Dienst, um nach Ressourcen zu suchen und eine Vorlage zu generieren. Dann das CDK CLI verweist auf die Vorlage, um die neue CDK-App zu erstellen. Im Folgenden finden Sie ein Beispiel, das eine neue CDK-App erstellt TypeScript mit einem neuen myCloudFormationStack Stack, der migrierte Ressourcen AWS enthält:
$cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"
