Aktualisiere deine Stack-Vorlage

Um die Ressourcen oder Eigenschaften in einem CloudFormation Stack zu ändern, müssen Sie die Vorlage des Stacks aktualisieren. Beginnen Sie mit der vorhandenen Vorlage für diesen Stapel und nehmen Sie Ihre Änderungen daran vor. Wenn Sie die Vorlage in einem Quellcodeverwaltungssystem gespeichert haben, verwenden Sie eine Kopie davon als Ausgangspunkt. Andernfalls können Sie eine Kopie der Vorlage von erhalten CloudFormation.

Wenn Sie nur die Parameter oder Einstellungen des Stacks ändern möchten (z. B. das SNS Amazon-Thema eines Stacks), können Sie die vorhandene Vorlage wiederverwenden, ohne eine Kopie zu erhalten.

Sie können eine CloudFormation Stack-Vorlage mithilfe Application Composer eines Texteditors aktualisieren.

Um eine vorhandene Stack-Vorlage mit Application Composer zu aktualisieren

1. Wählen Sie auf der Seite Stacks der CloudFormation Konsole den Namen des Stacks aus, den Sie aktualisieren möchten.

2. Wählen Sie im Bereich mit den Stack-Details für den ausgewählten Stack die Registerkarte Vorlage und dann in Application Composer anzeigen aus.

3. CloudFormation öffnet die Vorlage in Application Composer. Hier können Sie Ressourcen (Karten) aus der Palette Ressourcen per Drag-and-Drop ziehen, konfigurieren und verbinden. Weitere Informationen finden Sie unter So verfassen Sie AWS Application Composer.

Um eine bestehende Stack-Vorlage zu aktualisieren, verwenden Sie AWS CLI

1. Verwenden Sie den CLI Befehl get-template, um die Vorlage für den Stack abzurufen, den Sie aktualisieren möchten.

2. Kopieren Sie die Vorlage, fügen Sie sie in eine Textdatei ein und ändern und speichern Sie sie. Kopieren Sie nur die Vorlage. Der Befehl umschließt die Vorlage in Anführungszeichen, kopiert aber nicht die Anführungszeichen am Anfang und Ende der Vorlage. Die Vorlage selbst beginnt mit einer offenen Klammer und endet mit der letzten engen Klammer. Geben Sie Änderungen an den Stack-Ressourcen in dieser Datei an.

Beachten Sie die folgenden Punkte, wenn Sie Änderungen an Ihrer Vorlage vornehmen:

• Sie können keinen Parameter hinzufügen, ändern oder löschen, der von einer Ressource verwendet wird, die keine Updates unterstützt.

• Für die meisten Ressourcen ist das Ändern des logischen Namens einer Ressource gleichbedeutend mit dem Löschen dieser Ressource und ersetzt sie durch eine neue. Alle anderen Ressourcen, die von der umbenannten Ressource abhängen, müssen ebenfalls aktualisiert werden und können dazu führen, dass sie ersetzt werden. Bei anderen Ressourcen müssen Sie eine Update initiieren, um eine Eigenschaft (nicht nur den logischen Namen) zu aktualisieren.

• Für einige Ressourcen gelten möglicherweise Einschränkungen hinsichtlich der Werte, die Sie für bestimmte Eigenschaften festlegen können. Beispielsweise müssen Änderungen an der AllocatedStorage Eigenschaft für eine RDS Datenbankinstanz größer als der aktuelle Wert sein. Wenn Ihr Update gegen diese Regeln verstößt, schlägt dieser Teil fehl.

• Die Aktualisierung einer Ressource kann sich auch auf andere auswirken, die darauf verweisen. Wenn Sie Funktionen wie Ref oder verwendenGetAtt, um eine Eigenschaft festzulegen, die auf einer anderen Ressource basiert, CloudFormation wird auch die referenzierende Ressource aktualisiert, wenn sich die referenzierte ändert.

• Informationen zu den Auswirkungen der Aktualisierung bestimmter Ressourceneigenschaften finden Sie im AWS Referenz zu Ressourcentypen. Für jede Eigenschaft werden die Auswirkungen eines Updates einer der folgenden sein:

  • Aktualisierung erfordert: Keine Unterbrechung

  • Aktualisierung erfordert: Einige Unterbrechungen

  • Aktualisierung erfordert: Austausch

• Sie können die YAML Syntax JSON oder Ihrer Vorlage überprüfen, indem Sie den validate-templateCLIBefehl oder indem Sie Ihre Vorlage auf der Konsole angeben. Die Konsole führt die Validierung automatisch durch. Diese Methoden überprüfen jedoch nur die Syntax Ihrer Vorlage und überprüfen nicht, ob die Eigenschaftswerte, die Sie für eine Ressource angegeben haben, für diese Ressource gültig sind. Für komplexere Validierungen oder um nach bewährten Methoden zu suchen, können Sie auch zusätzliche Tools wie CloudFormation Linter (cfn-lint) und CloudFormation Rain (rain fmt) verwenden.

Anmerkung

Manchmal CloudFormation werden bestimmte Änderungen, die Sie vornehmen möchten, nicht zugelassen, und es wird Ihnen mitgeteilt, dass die Änderung nicht zulässig ist. Diese Meldung kann jedoch asynchron auftreten, da Ressourcen standardmäßig CloudFormation in einer nicht deterministischen Reihenfolge erstellt und aktualisiert werden.