Automatisches Importieren von AWS Ressourcen in einen CloudFormation Stack - AWS CloudFormation
Fehlerbehebung

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.

Automatisches Importieren von AWS Ressourcen in einen CloudFormation Stack

Sie können jetzt benannte Ressourcen automatisch importieren, wenn Sie Stacks erstellen oder aktualisieren CloudFormation . Eine benannte Ressource ist eine Ressource mit einem benutzerdefinierten Namen. Weitere Informationen finden Sie unter Namenstyp in der CloudFormation Vorlagenreferenz.

Wenn Sie den automatischen Import starten, CloudFormation sucht es nach vorhandenen Ressourcen, die Ihrer Vorlage entsprechen, und importiert sie während der Bereitstellung. Bei verschachtelten Stapeln erstellen Sie den Änderungssatz vom Stammstapel aus.

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.

Um eine Ressource zu importieren, müssen sie die folgenden Voraussetzungen erfüllen:

  • Die Ressource muss einen statischen benutzerdefinierten Namen haben, der in Ihrer Vorlage definiert ist. Dynamische Namen (mit !Ref oder anderen Funktionen) werden derzeit nicht unterstützt.

  • Die Ressource muss einen DeletionPolicy von Retain oder RetainExceptOnCreatehaben.

  • Die Ressource darf nicht bereits zu einem anderen CloudFormation Stapel gehören.

  • Der Ressourcentyp muss CloudFormation Importvorgänge unterstützen. Weitere Informationen finden Sie unter Unterstützung für Ressourcentypen.

  • Die primäre ID für den Ressourcentyp muss in der Vorlage enthalten sein. Primäre Eigenschaften IDs mit Schreibschutz werden nicht unterstützt. Um herauszufinden, wie die primäre ID für einen Typ lautet, suchen Sie im Ressourcenschema nach der Eigenschaft primaryIdentifier . Weitere Informationen zu dieser Eigenschaft finden Sie unter primaryIdentifier.

Beispiel Beispiel Auto-Import

Das folgende Beispiel verwendet einen Änderungssatz CreateChangeSet, um einen Stack namens my-stack auf der Grundlage einer Vorlagendatei template.yamlzu erstellen, und importiert automatisch die passenden Ressourcen.

aws cloudformation create-change-set \
  --stack-name my-stack \
  --change-set-name CreateChangeSet \
  --change-set-type CREATE \
  --template-body file://template.yaml \
  --import-existing-resources

Fehlerbehebung

Wenn der automatische Import fehlschlägt, gehen Sie wie folgt vor, um das Problem zu beheben:

  • Stellen Sie sicher, dass der Ressourcenname in Ihrer Vorlage genau mit dem Namen der Ressource übereinstimmt

  • Überprüfen Sie, ob die Ressource nicht bereits von einem anderen Stack verwaltet wird

  • Stellen Sie sicher, dass der Ressourcentyp Importvorgänge unterstützt

  • Stellen Sie sicher, dass Ihre Vorlage alle erforderlichen Eigenschaften für den Ressourcentyp enthält