Freigeben über

Hinzufügen von Status-Badges für Ihr GitHub Repo

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Sie können einer GitHub-Repositorydatei README.md Markdown-Syntax hinzufügen, um den Boardstatus in diesem Repository anzuzeigen. Zeigen Sie den Status an, indem Sie die syntax hinzufügen, die Sie aus den Boardeinstellungen auswählen.

Hinweis

Erfordert Azure DevOps Server 2019, Update 1 oder höher.

Die angezeigte Syntax funktioniert unabhängig davon, ob Sie Ihr Projekt mit einem GitHub.com- oder Ihrem GitHub Enterprise Server-Repository verbunden haben. Was GitHub Enterprise Server betrifft, muss ihr Server über das Netzwerk Azure DevOps Services zugänglich sein.

Voraussetzungen

  • Berechtigungen: Ein Teamadministrator für die Einstellungen des Teams, die Sie ändern oder Mitglied der Gruppe " Projektadministratoren " sein möchten.
  • Integration mit GitHub: Verbinden Sie Ihr Projekt mit dem GitHub-Repository, in dem die Commit- und Pullanforderungen vorhanden sind, mit denen Sie eine Verknüpfung herstellen/von dort aus herstellen möchten.
  • Boardkonfiguration: Verfügen Sie über ein Board, das Sie konfigurieren möchten. Wenn Sie ein Team hinzufügen, fügen Sie ein Board für dieses Team hinzu. Weitere Informationen finden Sie unter Informationen zu Teams und Agile-Tools.
  • Repositoryzugriff: Um das Statussignal zum GitHub.com Repository hinzuzufügen, geben Sie einen Mitwirkenden des Repositorys an.

Hinzufügen eines Statusbadges

  1. Melden Sie sich bei Azure Boards an, und öffnen Sie Ihr Board.

  2. Wählen Sie das Zahnradsymbol aus, um das Board zu konfigurieren und allgemeine Teameinstellungen festzulegen.

    Screenshot der Einstellungen für das Öffnen der Tafel.

  3. Wählen Sie Statusbadge aus, und aktivieren oder deaktivieren Sie dann das Kontrollkästchen Anonymen Benutzern den Zugriff auf den Statusbadge gewähren. Wenn diese Option nicht aktiviert ist, wird Benutzern, die nicht angemeldet sind, der Statusbadge weiterhin angezeigt.

    Screenshot des Dialogfelds

    Screenshot des Dialogfelds

  4. Wählen Sie den gewünschten Badgetyp und dann das Kopiersymbol aus, um die Markdownsyntax für den Badge zu kopieren.

    • Nur Spalten "In Bearbeitung" anzeigen ignoriert die erste und die letzte Spalte.
    • Alle Spalten einschließen schließt die erste und die letzte Spalte des Boards ein.
    • Sie können den Satz von Spalten anpassen, indem Sie 2 für columnOptions und dann eine durch Trennzeichen getrennte Liste der anzuzeigenden Boardspalten angeben. Beispiel: ?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review, wie in der folgenden Syntax dargestellt. Für Spaltenbezeichnungen, die Leerzeichen enthalten, müssen Sie den Leerraum mit %20codieren. Beispiel: In%20Progress.
     [![Board Status](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/_apis/work/boardbadge/6fa7b56f-d27c-4e96-957d-f9e7b0f56705?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review)](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/_boards/board/t/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/Microsoft.RequirementCategory/)

    Ein Badge ähnlich des folgenden wird angezeigt:

    Screenshot mit gerenderten Signalen.

  5. Wählen Sie Speichern aus, wenn Sie fertig sind.

    Die einzige Einstellung, die Sie konfigurieren können, ist di Option Anonymen Benutzern den Zugriff auf den Statusbadge gestatten. Der Badgetyp unter Einstellungen wechselt nur die Markdownsyntax, damit Sie aus den Werten Beispielmarkdown und Bild-URL kopieren können.

  6. Öffnen Sie die README-Datei in Ihrem GitHub-Repository, und fügen Sie die kopierte Syntax ein, damit der Badge angezeigt wird.

    Es sollte das gleiche Vorschaubild angezeigt werden, das Sie mit Werten ausgewählt haben, die Ihrem Board entsprechen.