# Workflows

Erhalten Sie eine allgemeine Übersicht über GitHub Actions Workflows, einschließlich Triggern, Syntax und erweiterten Features.

## Informationen zu Workflows

Ein **Workflow** ist ein konfigurierbarer automatisierter Prozess zur Ausführung eines oder mehrerer Aufträge. Workflows werden durch eine im Repository eingecheckte YAML-Datei definiert. Die Auslösung ihrer Ausführung erfolgt durch ein Ereignis in deinem Repository, manuell oder nach einem definierten Zeitplan.

Workflows werden im `.github/workflows`-Verzeichnis in einem Repository definiert. Ein Repository kann mehrere Workflows enthalten, die jeweils unterschiedliche Aufgaben ausführen können, wie:

* Erstellen und Testen von Pull Requests
* Bereitstellen deiner Anwendung bei jeder Erstellung eines Release
* Hinzufügen einer Bezeichnung, wenn ein neues Issue geöffnet wird

## Grundlagen des Workflows

Ein Workflow muss die folgenden grundlegenden Komponenten enthalten:

1. Ein oder mehrere *Ereignisse*, die den Workflow auslösen
2. Ein oder mehrere *Aufträge*, die jeweils auf einer *Runner-Maschine* ausgeführt werden und eine Reihe von einem oder mehreren *Schritten* ausführen.
3. Jeder Schritt kann entweder ein Skript ausführen, das du definierst, oder eine Aktion. Mit dieser wiederverwendbaren Erweiterung kannst du deinen Workflow vereinfachen.

Weitere Informationen zu diesen grundlegenden Komponenten findest du unter [Grundlegendes zu GitHub Actions](/de/enterprise-server@3.22/actions/get-started/understand-github-actions#the-components-of-github-actions).

![Diagramm eines Ereignisses, das Runner 1 veranlasst, Auftrag 1 auszuführen, was wiederum Runner 2 veranlasst, Auftrag 2 auszuführen. Jeder der Aufträge ist in mehrere Schritte unterteilt.](/assets/images/help/actions/overview-actions-simple.png)

## Workflowtrigger

Workflowtrigger sind Ereignisse, die dazu führen, dass ein Workflow ausgeführt wird. Dabei kann es sich um folgende Ereignisse handeln:

* Ereignisse, die im Repository deines Workflows auftreten
* Ereignisse, die außerhalb von GitHub auftreten und auf `repository_dispatch` ein GitHub-Ereignis auslösen
* Geplante Zeiten
* Handbuch

Du kannst deinen Workflow so konfigurieren, dass er ausgeführt wird, wenn ein Push an den Standardzweig deines Repositorys durchgeführt, ein Release erstellt oder ein Issue geöffnet wird.

Workflowtrigger werden mit dem Schlüssel `on` definiert. Weitere Informationen finden Sie unter [Workflowsyntax für GitHub Actions](/de/enterprise-server@3.22/actions/reference/workflows-and-actions/workflow-syntax#on).

Die folgenden Schritte laufen ab, um einen Workflow-Lauf auszulösen:

1. In deinem Repository tritt ein Ereignis auf. Dem Ereignis sind ein Commit-SHA und ein Git-Verweis zugeordnet.
2. GitHub durchsucht das `.github/workflows` Verzeichnis im Stammverzeichnis Ihres Repositorys nach Workflowdateien, die im zugeordneten Commit SHA- oder Git-Verweis des Ereignisses vorhanden sind.
3. Für alle Workflows, die über `on:`-Werte verfügen, die mit dem auslösenden Ereignis übereinstimmen, wird eine Workflowausführung ausgelöst. Bei einigen Ereignissen muss die Workflowdatei außerdem im Standardbranch des Repositorys vorhanden sein, damit eine Ausführung möglich ist.

Bei jeder Ausführung des Workflows wird die Workflowversion verwendet, die im zugehörigen Commit-SHA oder Git-Verweis des Ereignisses enthalten ist. Wenn ein Workflow ausgeführt wird, setzt GitHub die Umgebungsvariablen `GITHUB_SHA` (Commit-SHA) und `GITHUB_REF` (Git-Referenz) in der Runner-Umgebung fest. Weitere Informationen finden Sie unter [Speichern von Informationen in Variablen](/de/enterprise-server@3.22/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables).

Weitere Informationen finden Sie unter [Auslösen eines Workflows](/de/enterprise-server@3.22/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow).

## Nächste Schritte

Informationen zum Erstellen deines ersten Workflows findest du unter [Erstellen eines Beispielworkflows](/de/enterprise-server@3.22/actions/tutorials/create-an-example-workflow).