Beispiele: Trigger in Workflows - Amazon CodeCatalyst

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.

Beispiele: Trigger in Workflows

Die folgenden Beispiele zeigen, wie verschiedene Arten von Triggern zu einer CodeCatalyst Amazon-Workflow-Definitionsdatei hinzugefügt werden.

Weitere Informationen zu Auslösern finden Sie unter Automatisches Starten einer Workflow-Ausführung mithilfe von Triggern.

Beispiel: Ein einfacher Code-Push-Trigger

Das folgende Beispiel zeigt einen Trigger, der immer dann eine Workflow-Ausführung startet, wenn Code in einen beliebigen Branch in Ihrem Quell-Repository übertragen wird.

Wenn dieser Trigger aktiviert ist, CodeCatalyst startet eine Workflow-Ausführung mit den Dateien in dem Branch, in den Sie pushen (das ist der Ziel-Branch).

Wenn Sie beispielsweise einen Commit per Push ausführenmain, CodeCatalyst wird ein Workflow-Lauf gestartet, bei dem die Workflow-Definitionsdatei und andere Quelldateien verwendet werden. main

Ein weiteres Beispiel: Wenn Sie einen Commit per Push auf übertragenfeature-branch-123, CodeCatalyst wird ein Workflow-Lauf gestartet, bei dem die Workflow-Definitionsdatei und andere Quelldateien verwendet werden. feature-branch-123

Triggers: - Type: PUSH
Anmerkung

Wenn Sie möchten, dass ein Workflow-Lauf erst gestartet wird, wenn Sie einen Push to ausführenmain, finden Sie weitere Informationen unter. Beispiel: Ein einfacher „Push to Main“ -Trigger

Beispiel: Ein einfacher „Push to Main“ -Trigger

Das folgende Beispiel zeigt einen Trigger, der immer dann eine Workflow-Ausführung startet, wenn Code an den Branch main — und nur an den Branch — in Ihrem Quell-Repository übertragen wird. main

Triggers: - Type: PUSH Branches: - main

Beispiel: Ein einfacher Pull-Request-Trigger

Das folgende Beispiel zeigt einen Trigger, der einen Workflow-Lauf startet, wenn ein Pull-Request in Ihrem Quell-Repository erstellt oder überarbeitet wird.

Wenn dieser Trigger aktiviert ist, CodeCatalyst startet er einen Workflow-Lauf unter Verwendung der Workflow-Definitionsdatei und anderer Quelldateien in dem Branch, aus dem Sie abrufen (d. h. dem Quell-Branch).

Wenn Sie beispielsweise eine Pull-Anfrage mit einem Quell-Branch feature-123 und einem Ziel-Branch mit dem Namen erstellenmain, wird ein Workflow-Lauf CodeCatalyst gestartet, der die Workflow-Definitionsdatei und andere Quelldateien verwendet. feature-123

Triggers: - Type: PULLREQUEST Events: - OPEN - REVISION

Beispiel: Ein einfacher Zeitplan-Trigger

Das folgende Beispiel zeigt einen Trigger, der jeden Montag bis Freitag um Mitternacht (UTC+0) eine Workflow-Ausführung startet.

Wenn dieser Trigger aktiviert ist, wird für jeden Branch in Ihrem Quell-Repository, der eine Workflow-Definitionsdatei mit diesem Trigger enthält, eine einzelne Workflow-Ausführung CodeCatalyst gestartet.

Wenn Sie beispielsweise drei Zweige in Ihrem Quell-Repository haben,, main release-v1feature-123, und jeder dieser Zweige eine Workflow-Definitionsdatei mit dem folgenden Trigger enthält, werden drei Workflow-Läufe CodeCatalyst gestartet: eine mit den Dateien inmain, eine weitere mit den Dateien in release-v1 und eine weitere mit den Dateien infeature-123.

Triggers: - Type: SCHEDULE Expression: "0 0 ? * MON-FRI *"

Weitere Beispiele für Cron-Ausdrücke, die Sie in der Expression Eigenschaft verwenden können, finden Sie unterExpression.

Beispiel: Ein Trigger mit einem Zeitplan und Zweigen

Das folgende Beispiel zeigt einen Trigger, der jeden Tag um 18:15 Uhr (UTC+0) eine Workflow-Ausführung startet.

Wenn dieser Trigger aktiviert ist, CodeCatalyst startet er eine Workflow-Ausführung unter Verwendung der Dateien in der main Verzweigung und startet zusätzliche Läufe für jeden Zweig, der mit beginnt. release-

Wenn Sie beispielsweise bugfix-2 in Ihrem Quell-Repository Zweige mit dem Namen main release-v1bugfix-1,, und haben, werden zwei Workflow-Ausführungen CodeCatalyst gestartet: eine mit den Dateien in main und eine weitere mit den Dateien inrelease-v1. Es werden keine Workflow-Läufe für die bugfix-1 Zweige bugfix-1 und gestartet.

Triggers: - Type: SCHEDULE Expression: "15 18 * * ? *" Branches: - main - release\-.*

Weitere Beispiele für Cron-Ausdrücke, die Sie in der Expression Eigenschaft verwenden können, finden Sie unterExpression.

Beispiel: Ein Trigger mit einem Zeitplan, einem Push und Verzweigungen

Das folgende Beispiel zeigt einen Trigger, der jeden Tag um Mitternacht (UTC+0) und immer dann, wenn Code an die main Filiale gesendet wird, eine Workflow-Ausführung startet.

In diesem Beispiel:

  • Eine Workflow-Ausführung beginnt jeden Tag um Mitternacht. Der Workflow-Lauf verwendet die Workflow-Definitionsdatei und andere Quelldateien im main Zweig.

  • Ein Workflow-Lauf wird auch immer dann gestartet, wenn Sie einen Commit an den main Branch weiterleiten. Der Workflow-Lauf verwendet die Workflow-Definitionsdatei und andere Quelldateien im Zielzweig (main).

Triggers: - Type: SCHEDULE Expression: "0 0 * * ? *" Branches: - main - Type: PUSH Branches: - main

Weitere Beispiele für Cron-Ausdrücke, die Sie in der Expression Eigenschaft verwenden können, finden Sie unterExpression.

Beispiel: Ein Trigger mit einem Zug und Verzweigungen

Das folgende Beispiel zeigt einen Trigger, der einen Workflow-Lauf startet, wenn jemand eine Pull-Anfrage öffnet oder ändert, bei der ein Ziel-Branch aufgerufen wirdmain. Der in der Triggers Konfiguration angegebene Branch lautet zwarmain, aber der Workflow-Lauf verwendet die Workflow-Definitionsdatei und andere Quelldateien im Quell-Branch (dem Branch, aus dem Sie abrufen).

Triggers: - Type: PULLREQUEST Branches: - main Events: - OPEN - REVISION

Beispiel: Ein Trigger mit einem Pull, Branches und einem Ereignis CLOSED ''

Das folgende Beispiel zeigt einen Trigger, der eine Workflow-Ausführung immer dann startet, wenn eine Pull-Anfrage für einen Branch geschlossen wird, der mit beginntmain.

In diesem Beispiel:

  • Wenn Sie einen Pull-Request mit einem Ziel-Branch schließen, der mit beginntmain, wird automatisch ein Workflow-Lauf gestartet, der die Workflow-Definitionsdatei und andere Quelldateien im (jetzt geschlossenen) Quellzweig verwendet.

  • Wenn du dein Quell-Repository so konfiguriert hast, dass Branches automatisch gelöscht werden, nachdem eine Pull-Anfrage zusammengeführt wurde, haben diese Branches nie die Möglichkeit, in den CLOSED Status zu wechseln. Das bedeutet, dass zusammengeführte Branches den CLOSED Pull-Request-Trigger nicht aktivieren. Die einzige Möglichkeit, den CLOSED Trigger in diesem Szenario zu aktivieren, besteht darin, den Pull-Request zu schließen, ohne ihn zusammenzuführen.

Triggers: - Type: PULLREQUEST Branches: - main.* Events: - CLOSED

Beispiel: Ein Trigger mit einem Push, Branches und Dateien

Das folgende Beispiel zeigt einen Trigger, der eine Workflow-Ausführung startet, wenn eine Änderung an der filename.txt Datei oder einer beliebigen Datei im src Verzeichnis im main Branch vorgenommen wird.

Wenn dieser Trigger aktiviert ist, wird ein Workflow-Lauf CodeCatalyst gestartet, der die Workflow-Definitionsdatei und andere Quelldateien in der main Verzweigung verwendet.

Triggers: - Type: PUSH Branches: - main FilesChanged: - filename.txt - src\/.*

Beispiel: Ein manueller Trigger

Um einen manuellen Trigger zu konfigurieren, lassen Sie den Triggers Abschnitt aus der Workflow-Definitionsdatei weg. Ohne diesen Abschnitt sind Benutzer gezwungen, den Workflow manuell zu starten, indem sie in der CodeCatalyst Konsole auf die Schaltfläche Ausführen klicken. Weitere Informationen finden Sie unter Manuelles Starten einer Workflow-Ausführung.

Beispiel: Trigger in einem CI/CD-Multi-Workflow-Setup

In diesem Beispiel wird beschrieben, wie Trigger eingerichtet werden, wenn Sie separate CodeCatalyst Amazon-Workflows für Continuous Integration (CI) und Continuous Deployment (CD) verwenden möchten.

In diesem Szenario richten Sie zwei Workflows ein:

  • ein CI-Workflow — dieser Workflow erstellt und testet Ihre Anwendung, wenn eine Pull-Anfrage erstellt oder überarbeitet wird.

  • ein CD-Workflow — dieser Workflow erstellt Ihre Anwendung und stellt sie bereit, wenn eine Pull-Anfrage zusammengeführt wird.

Die Definitionsdatei des CI-Workflows würde in etwa so aussehen:

Triggers: - Type: PULLREQUEST Branches: - main Events: - OPEN - REVISION Actions: BuildAction: instructions-for-building-the-app TestAction: instructions-for-test-the-app

Der Triggers Code gibt an, dass ein Workflow-Lauf automatisch gestartet werden soll, wenn ein Softwareentwickler einen Pull-Request erstellt (oder einen ändert), in dem er darum bittet, seinen Feature-Branch mit dem main Branch zusammenzuführen. CodeCatalyst startet die Workflow-Ausführung unter Verwendung des Quellcodes im Quellzweig (der Feature-Branch).

Die Definitionsdatei des CD-Workflows würde in etwa so aussehen:

Triggers: - Type: PUSH Branches: - main Actions: BuildAction: instructions-for-building-the-app DeployAction: instructions-for-deploying-the-app

Der Triggers Code gibt an, dass der Workflow automatisch gestartet werden soll, wenn eine Zusammenführung mit main stattfindet. CodeCatalyst startet die Workflow-Ausführung unter Verwendung des Quellcodes in der main Verzweigung.