Skip to main content

Manuelles Ausführen eines Workflows

Wenn ein Workflow für die Ausführung im Falle des workflow_dispatch-Ereignisses konfiguriert ist, kannst du den Workflow über die Registerkarte „Aktionen“ in GitHub, die GitHub CLI oder die REST-API ausführen.

Tool navigation

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.

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

Ausführen eines Workflows

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Namen deines Repositorys auf Aktionen.

    Screenshot: Registerkarten für das Repository „github/docs“. Die Registerkarte „Aktionen“ ist mit einem orangefarbenen Rahmen hervorgehoben.

  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.

  4. Wählen Sie über der Liste der Workflowausführungen Workflow ausführen aus.

    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.

    Screenshot einer Workflowseite. Über der Liste der Workflowausführungen ist eine Schaltfläche mit der Beschriftung „Workflow ausführen“ in dunklem Orange eingerahmt.

  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.

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

Du kannst 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.