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.
Import AWS Ressourcen in einen CloudFormation Stapel mit einem Ressourcenimport
Mit der Funktion zum Importieren von Ressourcen können Sie vorhandene importieren AWS Ressourcen in einen neuen oder vorhandenen CloudFormation Stack. Diese Funktion ist nützlich, wenn Sie damit beginnen möchten, Ressourcen CloudFormation zu verwalten, die außerhalb von erstellt wurden CloudFormation, ohne sie löschen und neu erstellen zu müssen.
CloudFormation bietet zwei Optionen für den Import vorhandener Ressourcen in einen Stack:
-
Der IaC-Generator ist ein Tool, das Ihre vorhandenen Ressourcen automatisch scannt und auf der Grundlage ihres aktuellen Status eine CloudFormation Vorlage generiert. Diese Vorlage kann dann verwendet werden, um diese Ressourcen in einen Stapel zu importieren.
-
Der Ressourcenimport ist ein manueller Prozess, bei dem Sie die vorhandenen Ressourcen in Ihrer CloudFormation Vorlage beschreiben und sie dann in einen Stapel importieren. Bei diesem Ansatz müssen Sie die Ressourceneigenschaften und Konfigurationen in der Vorlage manuell angeben.
Die Ressourcenimportfunktion ermöglicht nicht nur die CloudFormation Verwaltung vorhandener Ressourcen, sondern kann auch in den folgenden Szenarien nützlich sein:
-
Verschieben von Ressourcen zwischen Stacks — Sie können Ressourcen von einem Stapel in einen anderen importieren, sodass Sie Ihre Infrastruktur nach Bedarf neu organisieren können.
-
Verschachtelung vorhandener Stacks — Sie können einen vorhandenen Stack als verschachtelten Stack innerhalb eines anderen Stacks importieren, was modulare und wiederverwendbare Infrastrukturdesigns ermöglicht.
CloudFormation unterstützt den Import einer Vielzahl von Ressourcen. Weitere Informationen finden Sie unter Unterstützung für Ressourcentypen.
Themen
- Übersicht
- Ressourcen-Identifikatoren
- Validierung
- Statuscodes
- Überlegungen
- Weitere Ressourcen
- Erstellen eines Stacks aus vorhandenen Ressourcen
- Importieren vorhandener Ressourcen in einen Stack
- Verschieben von Ressourcen zwischen Stacks
- Verschachteln eines vorhandenen Stacks
- Wiederherstellen eines Importvorgangs
Übersicht
Während eines Importvorgangs erstellen Sie einen Änderungssatz, der Ihre vorhandenen Ressourcen in einen Stack importiert oder einen neuen Stack aus Ihren vorhandenen Ressourcen erstellt. Während des Imports geben Sie Folgendes an.
-
Eine Vorlage, die den gesamten Stack beschreibt, einschließlich der ursprünglichen Stack-Ressourcen und der zu importierenden Ressourcen. Jede zu importierende Ressource muss eine habenDeletionPolicy Attribut.
-
Identifikatoren für die Ressourcen, die Sie importieren, mit denen Sie die logischen Elemente IDs in der Vorlage den vorhandenen Ressourcen zuordnen CloudFormation können.
Anmerkung
CloudFormation unterstützt mithilfe des Ressourcenimports nur eine Verschachtelungsebene. Dies bedeutet, dass Sie keinen Stack in einen untergeordneten Stack importieren oder einen Stack importieren können, der untergeordnete Stacks enthält.
Ressourcen-Identifikatoren
Sie geben zwei Werte an, um jede Ressource zu identifizieren, die Sie importieren.
-
Eine Bezeichnereigenschaft. Dies ist eine Ressourceneigenschaft, die verwendet werden kann, um jeden Ressourcentyp zu identifizieren. Beispielsweise kann eine
AWS::S3::Bucket-Ressource mit ihremBucketNameidentifiziert werden.Die Ressourceneigenschaft, mit der Sie die Ressource identifizieren, die Sie importieren, hängt vom Ressourcentyp ab. Sie finden die Ressourceneigenschaft in der CloudFormation Konsole. Nachdem Sie eine Vorlage erstellt haben, die die zu importierende Ressource enthält, können Sie den Importvorgang starten, in dem Sie die Kennungseigenschaften für die Ressourcen finden, die Sie importieren. Für einige Ressourcentypen gibt es möglicherweise mehrere Möglichkeiten, sie zu identifizieren, und Sie können in den Dropdownlisten auswählen, welche Eigenschaft verwendet werden soll.
Alternativ können Sie die Identifier-Eigenschaften für die Ressourcen, die Sie importieren, abrufen, indem Sie den get-template-summaryCLIBefehl aufrufen und S3 URL der Stack-Vorlage als Wert für die
--template-urlOption angeben. -
Ein Bezeichnerwert. Dies ist der tatsächliche Eigenschaftswert der Ressource. Beispielsweise könnte der tatsächliche Wert für die
BucketName-EigenschaftMyS3Bucketsein.Sie können den Wert der Identifier-Eigenschaft von der Servicekonsole für die Ressource abrufen.
Ressourcenimportvalidierung
CloudFormation Führt während eines Importvorgangs die folgenden Validierungen durch.
-
Die zu importierende Ressource ist vorhanden.
-
Die Eigenschaften und Konfigurationswerte für jede zu importierende Ressource entsprechen dem Ressourcentypschema, das die akzeptierten Eigenschaften, erforderlichen Eigenschaften und unterstützten Eigenschaftswerte definiert.
-
Die erforderlichen Eigenschaften werden in der Vorlage angegeben. Die erforderlichen Eigenschaften für jeden Ressourcentyp sind in der aufgeführt. AWS Referenz zu Ressourcen- und Eigenschaftstypen
-
Die zu importierende Ressource gehört nicht zu einem anderen Stack in derselben Region.
CloudFormation überprüft nicht, ob die Vorlagenkonfiguration mit der tatsächlichen Konfiguration der Ressourceneigenschaften übereinstimmt.
Wichtig
Stellen Sie sicher, dass die in der Vorlage definierten Ressourcen und ihre Eigenschaften mit der beabsichtigten Konfiguration des Ressourcen-Imports übereinstimmen, um unerwartete Änderungen zu vermeiden.
Statuscodes für den Ressourcenimport
In dieser Tabelle werden die verschiedenen Statustypen beschrieben, die mit der Ressourcenimportfunktion verwendet werden.
| Status des Importvorgangs | Beschreibung |
|---|---|
|
|
Der Importvorgang wird ausgeführt. |
|
|
Der Importvorgang wurde für alle Ressourcen im Stack abgeschlossen. |
|
|
Der Rollback-Importvorgang wird zur vorherigen Vorlagenkonfiguration zurückgesetzt. |
|
|
Der Import-Rollback-Vorgang ist fehlgeschlagen. |
|
|
Der Import wird zur vorherigen Vorlagenkonfiguration zurückgesetzt. |
Überlegungen während eines Importvorgangs
-
Nachdem der Import abgeschlossen ist und bevor nachfolgende Stack-Vorgänge ausgeführt werden, empfehlen wir, die Abweichungserkennung für importierte Ressourcen auszuführen. Die Abweichungserkennung stellt sicher, dass die Vorlagenkonfiguration mit der tatsächlichen Konfiguration übereinstimmt. Weitere Informationen finden Sie unter Drift auf einem ganzen CloudFormation Stack erkennen.
-
Importvorgänge lassen keine neuen Ressourcenerstellungen, Ressourcenlöschungen oder Änderungen an Eigenschaftskonfigurationen zu.
-
Jede zu importierende Ressource muss über ein
DeletionPolicy-Attribut verfügen, damit der Importvorgang erfolgreich ausgeführt werden kann. DieDeletionPolicykann auf einen beliebigen Wert gesetzt werden. Nur die Ressourcen, die Sie importieren, benötigen eineDeletionPolicy. Ressourcen, die bereits Teil des Stacks sind, benötigen keineDeletionPolicy. -
Sie können die gleiche Ressource nicht in mehrere Stacks importieren.
-
Mithilfe der
cloudformation:ImportResourceTypesIAM Richtlinienbedingung können Sie steuern, mit welchen Ressourcentypen Benutzer während eines Importvorgangs arbeiten können. Weitere Informationen finden Sie unter CloudFormation Bedingungen. -
Die CloudFormation Stack-Limits gelten beim Import von Ressourcen. Weitere Informationen zu Grenzwerten finden Sie unter CloudFormation Kontingente verstehen.
Weitere Ressourcen
Informationen zur Behebung von Stack-Drift bei einem Ressourcenimport finden Sie unterBeheben von Abweichungen mit einer Importoperation.
