Skip to main content

Hinzufügen eines Badges für den Workflowstatus

Du kannst ein Statusbadge zum Status deines Workflows in deinem Repository anzeigen.

Hinweis: GitHub-gehostete Runner werden auf GitHub Enterprise Server derzeit nicht unterstützt. Weitere Informationen zur geplanten zukünftigen Unterstützung findest Du in der GitHub public roadmap.

Hinweis: Workflowbadges in einem privaten Repository sind nicht extern zugänglich, sodass du sie nicht einbetten oder von einer externen Website aus verlinken kannst.

Ein Statusbadge zeigt an, ob ein Workflow derzeit fehlerhaft oder korrekt ausgeführt wird. Ein gängiger Ort für ein Statusbadge ist die Datei README.md deines Repositorys, du kannst den Badge aber zu jeder beliebigen Webseite hinzufügen. Standardmäßig zeigen Badges den Status deines Standardbranchs an. Du kannst auch den Status einer Workflowausführung für einen bestimmten Branch oder ein bestimmtes Ereignis anzeigen, indem du die Abfrageparameter branch und event in der URL verwendest.

Screenshot eines Workflowstatus-Badges Die linke Seite enthält das octocat-Logo und den Namen des Workflows (GitHub Actions Demo) Die rechte Hälfte ist grün und trägt die Aufschrift „Erfolgreich“.

Wenn du deiner README.md-Datei einen Workflowstatusbadge hinzufügen möchtest, suche zuerst die URL für den Statusbadge, den du anzeigen möchtest. Anschließend kannst du Markdown verwenden, um den Badge als Bild in deiner README.md-Datei anzuzeigen. Weitere Informationen zu Bildmarkup in Markdown findest du unter Grundlegende Schreib- und Formatierungssyntax.

Verwenden des Workflowdateinamens

Du kannst die URL für einen Workflowstatusbadge mithilfe des Namens der Workflowdatei erstellen:

HOSTNAME/OWNER/REPOSITORY/actions/workflows/WORKFLOW-FILE/badge.svg

Um den Workflowstatusbadge in deiner README.md-Datei anzuzeigen, verwende das Markdownmarkup zum Einbetten von Bildern. Weitere Informationen zu Bildmarkup in Markdown findest du unter Grundlegende Schreib- und Formatierungssyntax.

Füge beispielsweise deiner README.md-Datei das folgende Markdownelement hinzu, um einen Statusbadge für einen Workflow mit dem Dateipfad .github/workflows/main.yml hinzuzufügen. Der OWNER des Repositorys ist die github-Organisation und der REPOSITORY-Name ist docs.

![example workflow](https://github.com/github/docs/actions/workflows/main.yml/badge.svg)

Verwenden des branch-Parameters

Zum Anzeigen des Status eines Workflows, der für einen bestimmten Branch ausgeführt wird, füge dem Ende der Statusbadge-URL ?branch=BRANCH-NAME hinzu.

Füge beispielsweise deiner README.md-Datei das folgende Markdownelement hinzu, um einen Statusbadge für einen Branch mit dem Namen feature-1 anzuzeigen.

![example branch parameter](https://github.com/github/docs/actions/workflows/main.yml/badge.svg?branch=feature-1)

Verwenden des event-Parameters

Zum Anzeigen des Status von Workflowausführungen, die vom push-Ereignis ausgelöst werden, füge dem Ende der Statusbadge-URL ?event=push hinzu.

Füge beispielsweise deiner README.md-Datei das folgende Markdownelement hinzu, um einen Badge mit dem Status von Workflowausführungen anzuzeigen, die vom push-Ereignis ausgelöst werden, wodurch der Status des Builds für den aktuellen Zustand des betreffenden Branchs angezeigt wird.

![example event parameter](https://github.com/github/docs/actions/workflows/main.yml/badge.svg?event=push)