Azure Boards-GitHub-Integration

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

Verwenden Sie diese Leitlinie, um Azure Boards mit einem oder mehreren GitHub-Repositorys zu verbinden. Diese Verbindung verwendet die Azure Boards-App für GitHub, um die Integration zwischen Azure Boards und GitHub zu unterstützen. Diese App ist für öffentliche und private Repositorys kostenlos.

Wenn Sie Azure Boards mit GitHub-Repositorys verbinden, ermöglichen Sie die Verknüpfung zwischen GitHub-Commits, Pull Requests und Issues zu Arbeitselementen. Sie können GitHub für die Softwareentwicklung verwenden, während Sie Azure Boards zum Planen und Nachverfolgen Ihrer Arbeit nutzen. Azure Boards bietet die nötige Skalierbarkeit, wenn Ihre Organisation und Ihre geschäftlichen Anforderungen wachsen.


Hinweis

Azure DevOps unterstützt nur die Integration mit GitHub-Repositorys oder Azure Repos Git-Repositorys. Die Integration mit anderen Git-Repositorys wird nicht unterstützt.

Registrieren für Azure Boards

Wenn Sie sich noch nicht für Azure Boards registriert haben, können Sie dies jetzt tun. Weitere Informationen finden Sie unter Kostenlos registrieren und andere Personen zu Ihrem Projekt einladen. Sie können sich auch mit ihren GitHub-Anmeldeinformationen registrieren und anmelden.

GitHub-Signin

Zusammen mit dem Zugriff auf Entwicklerdienste wie Azure DevOps und Azure können Sie Ihr GitHub-Konto verwenden, um auf alle Microsoft-Onlinedienste von Excel Online bis XBox zuzugreifen.

Unterstützte Integrationsszenarien

Azure Boards und Azure DevOps Services unterstützen die Integration mit GitHub.com und GitHub Enterprise Server-Repositorys. Lokale Azure DevOps Server unterstützen die Integration mit GitHub Enterprise Server-Repositorys.

Hinweis

Durch die Installation des Azure DevOps Server 2020.1.1 Patch 2 können Sie Verbindungen von Ihrem Azure DevOps Server zu GitHub.com Repositorys neben GitHub Enterprise Server-Repositorys erstellen.

Die Azure Boards-GitHub-Integration unterstützt die folgenden Verbindungen:

  • In GitHub:

    • Unterstützen der Integration für alle Repositorys für ein GitHub-Konto oder eine Organisation oder Auswählen von Repositorys.
    • Hinzufügen oder Entfernen von GitHub-Repositorys, die an der Integration beteiligt sind, und Konfigurieren des verbundenen Projekts.
    • Aussetzen der Azure Boards-GitHub Integration oder Deinstallieren der App.
  • In Azure Boards:

    • Verbinden eines oder mehrerer GitHub-Repositorys mit einem Azure Boards-Projekt.
    • Hinzufügen oder Entfernen von GitHub-Repositorys zu/aus einer GitHub-Verbindung in einem Azure Boards Projekt.
    • Vollständiges Entfernen einer GitHub-Verbindung für ein Projekt.
    • Zulassen einer Verbindung von einem GitHub-Repository zu einem oder mehreren Azure Boards-Projekten in derselben Azure DevOps-Organisation oder -Sammlung.

Die Azure Boards-GitHub-Integration unterstützt die folgenden operativen Aufgaben:

  • Erstellen von Links zwischen Arbeitselementen und GitHub-Commits, Pull Requests und Issues basierend auf GitHub-Erwähnungen
  • Unterstützen des Statusübergangs von Arbeitselementen in einen Status "Fertig" oder "Abgeschlossen" bei Verwendung der GitHub-Erwähnung mithilfe fixvon , fixesoder fixed
  • Unterstützen einer umfassenden Nachverfolgbarkeit durch Veröffentlichen eines Diskussionskommentars in GitHub beim Verknüpfen eines Arbeitselements mit GitHub-Commit, Pull Requests oder Issues
  • Anzeigen von mit GitHub Code verknüpften Artefakten im Entwicklungsabschnitt für Arbeitselemente
  • Anzeigen von mit GitHub Code verknüpften Artefakten als Anmerkungen auf Kanban-Boardkarten
  • Unterstützen von Statusbadges von Kanban-Boardspalten, die GitHub hinzugefügt wurden

Die folgenden Aufgaben werden derzeit nicht unterstützt:

  • Abfragen von Arbeitselementen mit Verknüpfungen zu GitHub Artefakten. Sie können Arbeitselemente jedoch mit einem External Link Count > 0 abfragen.

Verbinden von Azure Boards mit GitHub-Repositorys

Sie können die Verbindung ausgehend von Azure Boards oder GitHub herstellen. Sie können bis zu 250 GitHub-Repositorys mit einem Azure Boards-Projekt verbinden.

Hinweis

Für die Verbindung mit mehr als 100 GitHub-Repositorys müssen Sie Azure DevOps Server 2020.1 oder höher verwenden.

Sie können die Verbindung ausgehend von Azure Boards oder GitHub herstellen. Sie können bis zu 100 GitHub-Repositorys mit einem Azure Boards-Projekt verbinden.

Hinweis

Es wird empfohlen, die Azure Boards-App für GitHub zum Konfigurieren und Verwalten der Verbindungen mit GitHub.com zu verwenden. Die App bietet optimierte Konfigurationsfunktionen und hat den Vorteil, dass Authentifizierung und Verarbeitung als App und nicht als Einzelperson erfolgen. Nachdem Sie die Verbindung konfiguriert haben, können Sie die verbundenen Repositorys über Azure Boards oder GitHub.com verwalten.

Ausgehend von GitHub

Ausgehend von Azure Boards

  • Verbinden von Azure Boards mit GitHub (Cloud)
    • Hinzufügen einer Verbindung von einem Azure Boards-Projekt zu bestimmten GitHub-Repositorys
    • Genehmigen und Installieren der Azure Boards-App für GitHub für Ihr GitHub Konto oder Ihre Organisation

Durchführen von Azure Boards-GitHub Integrationsfeatures

Nachdem Sie die Verbindung konfiguriert haben, können Sie die folgenden Aufgaben ausführen.

Hinzufügen oder Entfernen von Verbindungen

Beschränkungen

  • Verbinden Sie nur ein GitHub-Repository mit einer Azure DevOps-Organisation und einem Projekt.
    Das Verbinden des gleichen GitHub-Repositorys mit Projekten, die in zwei oder mehr Azure DevOps-Organisationen definiert sind, kann zu unerwarteten Verknüpfungen von AB# -Erwähnungen führen. Ausführliche Informationen finden Sie unter Problembehandlung bei gitHub & Azure Boards Integration.