View a markdown version of this page

Wie funktionieren die Bühnenbedingungen? - AWS CodePipeline

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.

Wie funktionieren die Bühnenbedingungen?

Für jede Bedingung, die eine Regel angibt, wird die Regel ausgeführt. Wenn die Bedingung fehlschlägt, führt die Stufe das angegebene Ergebnis aus. Optional geben Sie im Rahmen der Regel auch an, welche Ressourcen in bestimmten Fällen verwendet werden CodePipeline sollen. Beispielsweise verwendet die CloudWatchAlarm Regel eine CloudWatch Alarm-Ressource, um die Bedingung zu überprüfen.

Eine Bedingung kann mehreren Regeln entsprechen, und jede Regel kann einen von drei Anbietern angeben.

Der allgemeine Ablauf für die Erstellung von Bedingungen sieht wie folgt aus:

  1. Wählen Sie den Bedingungstyp aus den verfügbaren Bedingungstypen unter CodePipeline. Verwenden Sie beispielsweise den Bedingungstyp Bei Erfolg, um eine Phase so einzurichten, dass nach erfolgreichem Abschluss der Phase eine Reihe von Regeln verwendet werden kann, um Prüfungen durchzuführen, bevor der Vorgang fortgesetzt wird.

  2. Wählen Sie die Regel aus. Die CloudWatchAlarm Regel sucht beispielsweise nach Alarmen und prüft mithilfe von EB, ob ein vorkonfigurierter Alarmschwellenwert vorliegt. Wenn die Überprüfung erfolgreich ist und der Alarm unter dem Schwellenwert liegt, kann die Phase fortgesetzt werden.

  3. Konfigurieren Sie das Ergebnis, z. B. ein Rollback, das verwendet wird, wenn die Regel fehlschlägt.

Bedingungen werden für bestimmte Arten von Ausdrücken verwendet, und für jeden gibt es spezifische Optionen für Ergebnisse, die wie folgt verfügbar sind:

  • Eingabe — Die Bedingungen für die Durchführung von Prüfungen, die, wenn sie erfüllt sind, den Eintritt in eine Phase ermöglichen. Die Regeln sind mit den folgenden Ergebnisoptionen verknüpft: Fehlgeschlagen oder Überspringen

  • Bei Misserfolg — Die Bedingungen, unter denen Prüfungen für die Phase durchgeführt werden, wenn sie fehlschlägt. Regeln verwenden die folgende Ergebnisoption: Rollback

  • Bei Erfolg — Die Bedingungen, unter denen überprüft wird, ob die Phase erfolgreich abgeschlossen ist. Regeln werden mit den folgenden Ergebnisoptionen aktiviert: Rollback oder Fail

Das folgende Diagramm zeigt einen Beispielablauf für den Bedingungstyp „Eingabe“ in CodePipeline. Bedingungen beantworten die Frage: Was sollte passieren, wenn die Bedingung nicht erfüllt ist, d. h., eine Regel schlägt fehl? Im folgenden Ablauf wird eine Eingabebedingung mit einer LambdaInvoke Regel und einer CloudWatchAlarm Regel konfiguriert. Wenn die Regel fehlschlägt, wird das konfigurierte Ergebnis, z. B. Fehlgeschlagen, aktiviert.

Ein Beispiel für den Bedingungstyp „Eintrag“ mit zwei konfigurierten Regeln, einer LambdaInvoke Regel und einer CloudWatchAlarm Regel.

Das folgende Diagramm zeigt einen Beispielablauf für den Bedingungstyp On Failure in CodePipeline. Die Bedingungen beantworten die Frage: Was sollte passieren, wenn die Bedingung erfüllt ist, d. h., alle Regeln haben ihre Prüfungen bestanden? Im folgenden Ablauf wird die Bedingung „Bei Ausfall“ mit einer LambdaInvoke Regel und einer CloudWatchAlarm Regel konfiguriert. Wenn die Regel erfolgreich ist, wird das konfigurierte Ergebnis, z. B. Fehlgeschlagen, aktiviert.

Ein Beispiel für den Bedingungstyp Bei Ausfall mit zwei konfigurierten Regeln, einer LambdaInvoke Regel und einer CloudWatchAlarm Regel.

Das folgende Diagramm zeigt einen Beispielablauf für den Bedingungstyp Bei Erfolg CodePipeline. Die Bedingungen beantworten die Frage: Was sollte passieren, wenn die Bedingung erfüllt ist, d. h., alle Regeln haben ihre Prüfungen bestanden? Im folgenden Ablauf wird die Bedingung „Bei Erfolg“ mit einer LambdaInvoke Regel und einer CloudWatchAlarm Regel konfiguriert. Wenn die Regel erfolgreich ist, wird das konfigurierte Ergebnis, z. B. Fehlgeschlagen, aktiviert.

Ein Beispiel für den Bedingungstyp Bei Erfolg mit zwei konfigurierten Regeln, einer LambdaInvoke Regel und einer CloudWatchAlarm Regel.

Regeln für die Bedingungen einer Phase

Wenn Sie Stufenbedingungen konfigurieren, wählen Sie aus vordefinierten Regeln aus und geben die Ergebnisse für die Regel an. Ein Bedingungsstatus lautet Fehlgeschlagen, wenn eine der Regeln in der Bedingung nicht erfüllt ist, und Erfolgreich, wenn alle Regeln erfolgreich sind. Wie die Kriterien für die Bedingungen „Bei Fehlschlag“ und „Bei Erfolg“ erfüllt werden, hängt vom Typ der Regel ab.

Im Folgenden finden Sie verwaltete Regeln, die Sie den Stufenbedingungen hinzufügen können.

  • Bedingungen können mithilfe der Befehlsregel Befehle angeben, die die Regelkriterien für Bedingungen erfüllen. Weitere Informationen zu dieser Regel finden Sie unterBefehle.

  • Bedingungen können die AWS DeploymentWindow Regel verwenden, um die genehmigten Bereitstellungszeiten für die Zulassung einer Bereitstellung festzulegen. Die Kriterien für die Regel werden anhand eines bereitgestellten Cron-Ausdrucks für ein Bereitstellungsfenster gemessen. Die Regel ist erfolgreich, wenn Datum und Uhrzeit im Bereitstellungsfenster die Kriterien im Cron-Ausdruck für die Regel erfüllen. Weitere Informationen zu dieser Regel finden Sie unter. DeploymentWindow

  • Bedingungen können die AWS Lambda-Regel verwenden, um nach Fehlerzuständen zu suchen, die von konfigurierten Lambda-Funktionen zurückgegeben wurden. Die Regel ist erfüllt, wenn die Prüfung das Ergebnis der Lambda-Funktion erhält. Ein Fehler der Lambda-Funktion erfüllt die Kriterien für „On Failure“ -Bedingungen. Weitere Hinweise zu dieser Regel finden Sie unterLambdaInvoke.

  • Bedingungen können die AWS CloudWatchAlarm Regel verwenden, um nach Alarmen zu suchen, die aufgrund von CloudWatch Ereignissen konfiguriert wurden. Die Regel ist erfüllt, wenn die Prüfung den Alarmstatus OK, ALARM oder INSUFFICIENT_DATA zurückgibt. Für die Bedingungen On Success erfüllen OK und INSUFFICIENT_DATA die Kriterien. ALARM erfüllt die Kriterien für „On Failure“ -Bedingungen. Weitere Hinweise zu dieser Regel finden Sie unterCloudWatchAlarm.

  • Bedingungen können die VariableCheck Regel verwenden, um eine Bedingung zu erstellen, bei der die Ausgabevariable mit einem angegebenen Ausdruck verglichen wird. Die Regel besteht die Prüfung, wenn der Variablenwert die Regelkriterien erfüllt, z. B. wenn der Wert gleich oder größer als eine angegebene Ausgabevariable ist. Weitere Hinweise zu dieser Regel finden Sie unterVariableCheck.