Bedingte Ausführung und Job-Abhängigkeiten

Nicht jeder Schritt sollte bei jedem Lauf ausgeführt werden. Vielleicht soll ein Bereitstellungsschritt nur auf dem Branch main laufen oder ein Benachrichtigungsschritt nur dann, wenn ein Fehler aufgetreten ist.

Mit GitHub Actions können Sie jedem Schritt und jedem Job eine if-Bedingung hinzufügen und so steuern, ob er ausgeführt wird.

Fügen Sie einem Schritt einen Schlüssel if: hinzu. Der Schritt wird nur ausgeführt, wenn der Ausdruck zu true ausgewertet wird.

Ausdrücke innerhalb von if benötigen nicht den Wrapper ${{ }}, er ist jedoch zulässig.

Bedingungen werden aus Kontextobjekten gelesen, die den Lauf beschreiben:

• github — Ereignis, Ref, Akteur, SHA
• env — Umgebungsvariablen
• job und steps — Status vorheriger Arbeiten
• runner — Betriebssystem und Architektur

Beispielsweise zeigt github.event_name, ob ein Push oder ein pull_request den Lauf ausgelöst hat.

Standardmäßig wird ein Schritt übersprungen, wenn ein vorheriger Schritt fehlgeschlagen ist. Um dieses Verhalten zu überschreiben, verwenden Sie die Statusfunktionen:

• success() — wahr, wenn kein vorheriger Schritt fehlgeschlagen ist (Standardverhalten)
• failure() — wahr, wenn ein vorheriger Schritt fehlgeschlagen ist
• always() — wird unabhängig vom Ergebnis ausgeführt
• cancelled() — wahr, wenn der Lauf abgebrochen wurde

Ein häufiges Muster ist ein Bereinigungsschritt, der auch dann ausgeführt werden muss, wenn frühere Schritte fehlgeschlagen sind. Verwenden Sie if: always().

Dadurch wird garantiert, dass temporäre Ressourcen, Container oder Testberichte unabhängig vom Ergebnis verarbeitet werden.

Mit dem Schlüsselwort needs wartet ein Job auf andere Jobs. Ohne dieses Schlüsselwort werden Jobs parallel ausgeführt.

Ein in needs aufgeführter Job muss erfolgreich beendet sein, bevor der abhängige Job startet.

Ein Job kann von mehreren Jobs abhängen, indem Sie eine Liste an needs übergeben. Er wartet auf alle diese Jobs.

So erstellen Sie Fan-in-Muster, bei denen ein abschließender Job erst ausgeführt wird, wenn alle parallelen Jobs erfolgreich waren.

Der Schlüssel if funktioniert auch für Jobs, nicht nur für Schritte. Eine Bedingung auf Job-Ebene entscheidet, ob der gesamte Job ausgeführt wird.

Hier wird der Deploy-Job nur bei Pushes auf main ausgeführt, hängt aber weiterhin von den Tests ab.

Jobs können Daten über outputs an nachgelagerte Jobs übergeben. Ein abhängiger Job liest sie über den needs-Kontext.

Dadurch kann eine Bedingung von einem zuvor berechneten Wert abhängen, beispielsweise davon, ob sich eine Version geändert hat.

Sie können Ausdrücke mit && (und), || (oder) und ! (nicht) kombinieren.

Dieses Beispiel wird nur bei einem erfolgreichen Push auf main ausgeführt, der nicht aus einem Fork stammt.

Achtung: Ein Job mit needs wird übersprungen, wenn eine Abhängigkeit fehlschlägt. Damit ein abschließender Bericht-Job unabhängig vom Ergebnis ausgeführt wird, kombinieren Sie needs mit if: always().

Darin können Sie needs.<job>.result untersuchen, um zu entscheiden, was gemeldet werden soll.

Sie haben gelernt, den Ablauf eines Workflows mit Bedingungen und Abhängigkeiten zu steuern.

• if steuert die Ausführung von Schritten und Jobs anhand von Ausdrücken
• Statusfunktionen wie failure() und always() überschreiben das Überspringen nach einem Fehler
• needs erstellt Reihenfolgen und Fan-in-Muster
• Job-outputs liefern Werte für spätere Bedingungen

Mit diesen grundlegenden Bausteinen können Sie präzise und effiziente Pipelines erstellen.