# Manuelles Ausführen eines Workflows

Wenn ein Workflow für die Ausführung auf dem workflow_dispatch Ereignis konfiguriert ist, können Sie den Workflow mithilfe der Registerkarte "Aktionen" auf GitHub, GitHub CLIoder der REST-API ausführen.

> \[!NOTE]
> Auf GitHub Enterprise Server gehostete Runner werden aktuell nicht auf GitHub unterstützt.

## Konfigurieren eines Workflows zur manuellen Ausführung

Um einen Workflow manuell auszuführen, muss der Workflow so konfiguriert sein, dass er auf dem `workflow_dispatch`-Ereignis ausgeführt wird.

Um das `workflow_dispatch`-Ereignis auszulösen, muss sich dein Workflow im Standardbranch befinden. Weitere Informationen zum Konfigurieren des `workflow_dispatch`-Ereignisses findest du unter [Ereignisse zum Auslösen von Workflows](/de/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch).

Um diese Schritte auszuführen, ist Schreibzugriff auf das Repository erforderlich.

## Ausführen eines Workflows

<div class="ghd-tool webui">

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-play" aria-label="play" role="img"><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z"></path></svg> Actions**.

   ![Screenshot: Registerkarten für das Repository „github/docs“. Die Registerkarte „Aktionen“ ist mit einem orangefarbenen Rahmen hervorgehoben.](/assets/images/help/repository/actions-tab-global-nav-update.png)

3. Klicke auf der linken Randleiste auf den Namen des Workflows, den du ausführen möchtest.

   ![Screenshot: Seite „Actions“. Auf der linken Randleiste wird ein Workflowname durch einen dunkelorangefarbenen Rahmen hervorgehoben.](/assets/images/help/repository/actions-select-workflow-2022.png)

4. Klicken Sie über der Liste der Workflowausführungen auf die Schaltfläche **Workflow starten**.

   > \[!NOTE]
   > Damit die Schaltfläche **Run workflow** angezeigt wird, muss deine Workflowdatei den Ereignistrigger `workflow_dispatch` verwenden. Nur Workflowdateien, die den `workflow_dispatch`-Ereignisauslöser verwenden, haben die Möglichkeit, den Workflow manuell mithilfe der Schaltfläche **Workflow ausführen** auszuführen. Weitere Informationen zum Konfigurieren des `workflow_dispatch`-Ereignisses findest du unter [Ereignisse zum Auslösen von Workflows](/de/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch).

   ![Screenshot einer Workflowseite. Über der Liste der Workflowausführungen ist eine Schaltfläche mit der Beschriftung „Workflow ausführen“ in dunklem Orange eingerahmt.](/assets/images/help/actions/actions-workflow-dispatch.png)

5. Wähle das Dropdownmenü **Branch** aus, und klicke auf einen Branch, für den der Workflow ausgeführt werden soll.

6. Wenn der Workflow eine Eingabe erfordert, fülle die Felder aus.

7. Klicke auf **Workflow ausführen**.

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> Weitere Informationen zur GitHub CLI findest du unter [Informationen zu GitHub CLI](/de/enterprise-server@3.22/github-cli/github-cli/about-github-cli).

Um einen Workflow auszuführen, verwende den Unterbefehl `workflow run`. Ersetze den `workflow`-Parameter durch den Namen, die ID oder den Dateinamen des Workflows, den du ausführen möchtest. Beispiel: `"Link Checker"`, `1234567` oder `"link-check-test.yml"`. Wenn Sie keinen Workflow angeben, wird ein interaktives Menü zurückgegeben, GitHub CLI in dem Sie einen Workflow auswählen können.

```shell
gh workflow run WORKFLOW
```

Wenn Ihr Workflow Eingaben akzeptiert, werden Sie aufgefordert, GitHub CLI sie einzugeben. Alternativ kannst du mit `-f` oder `-F` eine Eingabe im `key=value`-Format hinzufügen. Verwenden Sie `-F`, um aus einer Datei zu lesen.

```shell
gh workflow run greet.yml -f name=mona -f greeting=hello -F data=@myfile.txt
```

Du kannst Eingaben auch im JSON-Format übergeben, indem du die Standardeingabe verwendest.

```shell
echo '{"name":"mona", "greeting":"hello"}' | gh workflow run greet.yml --json
```

Um einen Workflow auf einem anderen Branch als dem Standardbranch des Repositorys auszuführen, verwende das `--ref`-Flag.

```shell
gh workflow run WORKFLOW --ref BRANCH
```

Um den Fortschritt der Workflowausführung anzuzeigen, verwende den Unterbefehl `run watch`, und wähle die Ausführung in der interaktiven Liste aus.

```shell
gh run watch
```

</div>

## Ausführen eines Workflows mithilfe der REST-API

Wenn du die REST-API verwendest, konfiguriere `inputs` und `ref` als Anforderungstextparameter. Wenn die Eingaben weggelassen werden, werden die in der Workflowdatei definierten Standardwerte verwendet.

> \[!NOTE]
> Sie können bis zu 10`inputs`für ein `workflow_dispatch` Ereignis definieren.

Weitere Informationen zum Verwenden der REST-API findest du unter [REST-API-Endpunkte für Workflows](/de/enterprise-server@3.22/rest/actions/workflows#create-a-workflow-dispatch-event).