Aktualisieren Sie Ihre Stapelvorlage - AWS CloudFormation

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.

Aktualisieren Sie Ihre Stapelvorlage

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 Versionskontrollsystem gespeichert haben, verwenden Sie eine Kopie dieser Vorlage als Ausgangspunkt. Ansonsten können Sie eine Kopie der Vorlage von CloudFormation erhalten.

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

Sie können eine CloudFormation Stack-Vorlage mit einem Texteditor oder Infrastructure Composeraktualisieren.

So aktualisieren Sie eine vorhandene Stack-Vorlage mithilfe von Infrastructure Composer

  1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die CloudFormation-Konsole unter https://console.aws.amazon.com/cloudformation.

  2. Wählen Sie auf der Seite Stapel den Namen des zu aktualisierenden Stapels.

  3. Wählen Sie die Registerkarte Vorlage und dann Ansicht im Infrastructure Composer.

    CloudFormation öffnet die Vorlage im Infrastructure Composer.

  4. Aktualisieren Sie Ihre Vorlage mit einer der folgenden Methoden:

    • Canvas interface: Hier können Sie aus der Palette Ressourcen ziehen und ablegen. Konfigurieren Sie die Ressourcen, indem Sie auf eine Karte doppelklicken, um das Fenster Ressourceneigenschaften zu öffnen. Verbinden Sie Ressourcen nach Bedarf. Ausführliche Anweisungen zur Verwendung der Canvas-Oberfläche finden Sie unter Wie man in AWS-Infrastruktur-Composerkomponiert.

    • SchnittstelleVorlage : Wechseln Sie von der Schnittstelle Canvas zur Schnittstelle Template . Nehmen Sie Inline-Aktualisierungen am Code der Vorlage vor. Wechseln Sie je nach Bedarf zwischen den Formaten JSON und YAML.

  5. Wählen Sie Validieren um die Vorlage auf Syntaxfehler zu überprüfen.

  6. Wenn Sie bereit sind, Änderungen in CloudFormation zu exportieren, wählen Sie Vorlage aktualisieren.

So aktualisieren Sie eine vorhandene Stapelvorlage mit der Option AWS CLI.

  1. Um die Vorlage für den Stack zu erhalten, den Sie aktualisieren möchten, verwenden Sie den CLI-Befehl get-template .

  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 Aktualisierungen 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. Zum Beispiel müssen Änderungen an der Eigenschaft AllocatedStorage für eine RDS-Datenbankinstance größer sein als der aktuelle Wert. Wenn Ihre Aktualisierung gegen diese Regeln verstößt, wird dieser Teil fehlschlagen.

  • Die Aktualisierung einer Ressource kann sich auch auf andere auswirken, die auf sie verweisen. Wenn Sie Funktionen wie Die Funktion Ref oder Die Funktion Fn::GetAtt verwenden, um eine Eigenschaft basierend auf einer anderen Ressource festzulegen, aktualisiert CloudFormation auch die referenzierende Ressource, wenn sich die referenzierte Ressource ändert.

  • Informationen über die Auswirkungen der Aktualisierung bestimmter Ressourceneigenschaften finden Sie in der Referenz AWS Ressource und Eigenschaftstypen. Für jede Eigenschaft werden die Auswirkungen eines Updates einer der folgenden sein:

  • Sie können die JSON- oder YAML-Syntax Ihrer Vorlage überprüfen, indem Sie den CLI-Befehl validate-template verwenden oder Ihre Vorlage in der Konsole angeben. Die Konsole führt die Validierung automatisch durch. Diese Methoden überprüfen jedoch nur die Syntax Ihrer Vorlage und nicht, ob die Eigenschaftswerte, die Sie für eine Ressource angegeben haben, für diese Ressource gültig sind. Für komplexere Validierungen oder zur Überprüfung von Best Practices können Sie auch zusätzliche Tools wie CloudFormation Linter (cfn-lint) und CloudFormation Rain (rain fmt)verwenden.

Anmerkung

Manchmal lässt CloudFormation bestimmte Änderungen, die Sie vornehmen möchten, nicht zu und teilt Ihnen mit, dass die Änderung nicht zulässig ist. Diese Meldung kann jedoch asynchron auftreten, da Ressourcen von CloudFormation standardmäßig in einer nicht-deterministischen Reihenfolge erstellt und aktualisiert werden.