Rollbacks konfigurieren

Wenn die Aktion AWS CloudFormation Stack bereitstellen fehlschlägt, führt dies standardmäßig AWS CloudFormation dazu, dass der Stack auf den letzten bekannten stabilen Status zurückgesetzt wird. Sie können das Verhalten so ändern, dass Rollbacks nicht nur dann auftreten, wenn die Aktion fehlschlägt, sondern auch, wenn ein bestimmter CloudWatch Amazon-Alarm ausgelöst wird. Weitere Informationen zu CloudWatch Alarmen finden Sie unter Verwenden von CloudWatch Amazon-Alarmen im CloudWatch Amazon-Benutzerhandbuch.

Sie können auch das Standardverhalten so ändern, dass der Stack CloudFormation nicht zurückgesetzt wird, wenn die Aktion fehlschlägt.

Verwenden Sie die folgenden Anweisungen, um Rollbacks zu konfigurieren.

Anmerkung

Sie können ein Rollback nicht manuell starten.

Visual

Bevor Sie beginnen

1. Stellen Sie sicher, dass Sie über einen Workflow verfügen, der eine funktionierende Aktion „ AWS CloudFormation Stack bereitstellen“ beinhaltet. Weitere Informationen finden Sie unter Einen AWS CloudFormation Stack bereitstellen.

2. Stellen Sie sicher, dass Sie in der Rolle, die im Feld Stack-Rolle — optional der Aktion AWS CloudFormation Stack bereitstellen angegeben ist, die CloudWatchFullAccessBerechtigung angeben. Informationen zum Erstellen dieser Rolle mit den entsprechenden Berechtigungen finden Sie unterSchritt 2: AWS Rollen erstellen.

So konfigurieren Sie Rollback-Alarme für die Aktion „Stack bereitstellen“ AWS CloudFormation

1. Öffnen Sie die Konsole unter https://codecatalyst.aws/ CodeCatalyst .

2. Wählen Sie Ihr Projekt.

3. Wählen Sie im Navigationsbereich CI/CD und dann Workflows aus.

4. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

5. Wählen Sie Edit (Bearbeiten) aus.

6. Wählen Sie Visual.

7. Wählen Sie Ihre AWS CloudFormation Stack-Aktion „Deploy“.

8. Wählen Sie im Detailbereich Konfiguration aus.

9. Erweitern Sie unten die Option Erweitert.

10. Wählen Sie unter Alarm überwachen ARNs die Option Alarm hinzufügen aus.

11. Geben Sie Informationen in die folgenden Felder ein.

    • Alarm ARN

      Geben Sie den Amazon-Ressourcennamen (ARN) eines CloudWatch Amazon-Alarms an, der als Rollback-Trigger verwendet werden soll. Beispiel, arn:aws:cloudwatch::123456789012:alarm/MyAlarm. Sie können maximal fünf Rollback-Trigger haben.

      Anmerkung

      Wenn Sie einen CloudWatch Alarm angebenARN, müssen Sie auch zusätzliche Berechtigungen konfigurieren, damit die Aktion darauf zugreifen CloudWatch kann. Weitere Informationen finden Sie unter Rollbacks konfigurieren.

    • Dauer der Überwachung

      Geben Sie einen Zeitraum von 0 bis 180 Minuten an, in dem die angegebenen Alarme CloudFormation überwacht werden. Die Überwachung beginnt, nachdem alle Stack-Ressourcen bereitgestellt wurden. Wenn der Alarm innerhalb der angegebenen Überwachungszeit auftritt, CloudFormation schlägt die Bereitstellung fehl und der gesamte Stack-Vorgang wird rückgängig gemacht.

      Standard: 0. CloudFormation überwacht Alarme nur, während die Stack-Ressourcen bereitgestellt werden, nicht danach.

YAML

Um Rollback-Trigger für die Aktion „Stack bereitstellen“ AWS CloudFormation zu konfigurieren

1. Öffnen Sie die Konsole unter https://codecatalyst.aws/ CodeCatalyst .

2. Wählen Sie Ihr Projekt.

3. Wählen Sie im Navigationsbereich CI/CD und dann Workflows aus.

4. Wählen Sie den Namen eines Workflows, der die Aktion AWS CloudFormation Stack bereitstellen enthält. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

5. Wählen Sie Edit (Bearbeiten) aus.

6. Wählen Sie YAML.

7. Fügen Sie die monitor-timeout-in-minutes Eigenschaften monitor-alarm-arns und im YAML Code hinzu, um Rollback-Trigger hinzuzufügen. Eine Erläuterung der einzelnen Eigenschaften finden Sie unterAktion „ AWS CloudFormation Stack bereitstellen“ YAML.

8. Stellen Sie sicher, dass Sie in der Rolle, die in der role-arn Eigenschaft der Aktion AWS CloudFormation Stack bereitstellen angegeben ist, die CloudWatchFullAccessentsprechende Berechtigung angeben. Informationen zum Erstellen dieser Rolle mit den entsprechenden Berechtigungen finden Sie unterSchritt 2: AWS Rollen erstellen.

Visual

So deaktivieren Sie Rollbacks für die Aktion „Stack bereitstellen“ AWS CloudFormation

1. Öffnen Sie die Konsole unter https://codecatalyst.aws/ CodeCatalyst .

2. Wählen Sie Ihr Projekt.

3. Wählen Sie im Navigationsbereich CI/CD und dann Workflows aus.

4. Wählen Sie den Namen eines Workflows, der die Aktion AWS CloudFormation Stack bereitstellen enthält. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

5. Wählen Sie Edit (Bearbeiten) aus.

6. Wählen Sie Visual.

7. Wählen Sie Ihre AWS CloudFormation Stack-Aktion „Deploy“.

8. Wählen Sie im Detailbereich Konfiguration aus.

9. Erweitern Sie unten die Option Erweitert.

10. Aktivieren Sie „Rollback deaktivieren“.

YAML

Um Rollbacks für die Aktion „Stack bereitstellen“ AWS CloudFormation zu deaktivieren

1. Öffnen Sie die Konsole unter https://codecatalyst.aws/ CodeCatalyst .

2. Wählen Sie Ihr Projekt.

3. Wählen Sie im Navigationsbereich CI/CD und dann Workflows aus.

4. Wählen Sie den Namen eines Workflows, der die Aktion AWS CloudFormation Stack bereitstellen enthält. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.

5. Wählen Sie Edit (Bearbeiten) aus.

6. Wählen Sie YAML.

7. Fügen Sie die disable-rollback: 1 Eigenschaft im YAML Code hinzu, um Rollbacks zu verhindern. Eine Erläuterung dieser Eigenschaft finden Sie unterAktion „ AWS CloudFormation Stack bereitstellen“ YAML.