Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
In dieser Schnellstartanleitung installieren Sie die Azure Boards-App für GitHub, um Azure Boards mit Ihren GitHub Repositorys zu verbinden. Wenn Sie Azure Boards Projekte mit GitHub.com Repositorys verbinden, unterstützen Sie die Verknüpfung zwischen GitHub Commits und Pullanforderungen an Arbeitsaufgaben. Sie können GitHub für die Softwareentwicklung verwenden, während Sie Azure Boards verwenden, um Ihre Arbeit zu planen und nachzuverfolgen. Nachdem Sie die Azure Boards-App für GitHub in Ihrem GitHub Konto oder Ihrer Organisation installiert haben, wählen Sie aus, mit welchen GitHub Repositorys Sie eine Verbindung mit Ihrem Projekt herstellen möchten.
Eine Übersicht über die Integration, die die Azure Boards-App für GitHub unterstützt, finden Sie unter Azure Boards-GitHub-Integration.
Prerequisites
| Category | Requirements |
|---|---|
| Erlaubnisse | - Mitglied der Gruppe Projektsammlungsadministratoren. Wenn Sie das Projekt erstellt haben, verfügen Sie über Berechtigungen. - Administrator oder owner der GitHub Organisation zum Installieren der Azure Boards App. - Leseberechtigungen für das GitHub-Repository. |
| Projektmitgliedschaft | Projektmitglied. |
Important
Wenn Ihr Repository bereits über einen anderen Authentifizierungstyp wie OAuth verbunden ist, müssen Sie dieses Repository aus Ihrer vorhandenen Verbindung entfernen, bevor Sie sie mithilfe der GitHub App erneut verbinden. Führen Sie die in Add oder Entfernen GitHub Repositorys weiter unten in diesem Artikel beschriebenen Schritte aus, bevor Sie die GitHub App konfigurieren.
Sie können eine Azure DevOps Organisation mit mehreren GitHub Repositorys verbinden, wenn Sie administrator für diese Repositorys sind. Sie sollten kein GitHub-Repository mit mehr als einer Azure DevOps-Organisation verbinden.
Installieren und Konfigurieren der Azure Boards-App
Ihre Installationssequenz kann aufgrund Ihrer Kontokonfiguration variieren. Befolgen Sie bei Bedarf die Bildschirmhinweise zwischen den folgenden Schritten.
Wechseln Sie zur Azure Boards App im GitHub Marketplace.
Wählen Sie unter "Pläne und Preise" unter "Kostenlos" die Option "Installieren" aus.
In
Installieren & Autorisieren von Azure Boards wählen Sie die Repositories aus, die Sie mit Azure Boards verbinden möchten, und wählen Sie dannInstallieren & Autorisieren .In diesem Beispiel werden alle Repositorys verwendet:
Wählen Sie die Azure DevOps Organisation und Azure Boards Projekt aus, das Sie mit GitHub.com verbinden möchten.
Sie können jeweils nur ein Projekt verbinden. Wenn Sie für weitere Projekte eine Verbindung herstellen möchten, können Sie dies später tun, wie weiter unten in diesem Artikel unter Konfigurieren anderer Projekte oder Repositorys beschrieben.
Zugriff auf die Azure Boards Organisation gewähren
Führen Sie die folgenden Schritte aus, um GitHub Zugriff auf Ihre Azure DevOps Organisation zu gewähren.
Öffnen Sie im GitHub Webportal Settings aus Ihrem Profilmenü.
Wählen Sie unter IntegrationenAnwendungen aus.
Wählen Sie Authorized GitHub Apps>Azure Boards aus.
Unter Organisationszugriff können alle auftretenden Probleme behoben werden. Wählen Sie Gewähren aus, um allen Organisationen Zugriff zu gewähren, für die Zugriffsanforderung ausstehend angezeigt wird.
Überprüfen der Anwendungszugriffsrichtlinie von Drittanbietern
Stellen Sie sicher, dass Ihre GitHub Organisation den Anwendungszugriff von Drittanbietern für die Azure Boards-App zulässt. Wenn der Zugriff von Drittanbietern eingeschränkt ist, kann das Hinzufügen von Repositorys aus Azure DevOps eine leere Liste anzeigen oder einen Fehler erzeugen.
So aktivieren Sie den Zugriff:
Öffnen Sie in GitHub Ihre Organisation, und wechseln Sie zu "Einstellungen" > OAuth-App-Richtlinie.
Genehmigen Sie die Azure Boards-App speziell (empfohlen), oder entfernen Sie Einschränkungen für alle Anwendungen von Drittanbietern.
Hinweis
Sie müssen ein Organisationsbesitzer oder Administrator sein, um diese Einstellung zu ändern.
Verwenden der Verbindung
An diesem Punkt ist Ihre Azure Boards-GitHub Integration abgeschlossen. Sie können die nächsten Schritte überspringen oder sie durchgehen, um die im Zusammenhang mit der Verbindung unterstützten Funktionen zu verstehen.
Wählen Sie in Ihrem Board Neue Arbeitsaufgabe aus, um eine neue Arbeitsaufgabe mit dem Namen "Badge zu README hinzufügen" – Problem (Basic), User Story (Agile) oder Product Backlog Item (Scrum) einzugeben, je nach prozessmodell, das von Ihrem Azure Boards Projekt verwendet wird.
In Ihrem Board wird ein Arbeitselement mit dem Titel Badge zu README hinzufügen angezeigt.
Öffnen Sie Ihr Arbeitselement, wechseln Sie zum Abschnitt Entwicklung und wählen Sie Link hinzufügen aus.
Wählen Sie Link typeGitHub Pull Request aus.
Wählen Sie das Repository aus und geben Sie die Pull-Request-ID und optional einen Kommentar ein.
Wählen Sie Verbindung hinzufügen aus.
Im Hintergrund werden die folgenden Aktionen automatisch ausgeführt.
- Fügt der README-Datei des ersten Repositories in der Liste der verbundenen GitHub-Repositories ein Abzeichen hinzu.
- Erstellt einen GitHub Commit für das Update durch Hinzufügen des Badges zur README-Datei.
- Erstellt eine GitHub Pullanforderung, um die an der README-Datei vorgenommenen Änderungen zusammenzuführen.
- Verknüpft die GitHub Commit- und Pullanforderung mit der in Schritt 1 erstellten Arbeitsaufgabe.
Wählen Sie ausgehend von Ihrem Arbeitselement den ersten Pull-Request-Link aus.
Der Screenshot zeigt das Fehlerformular für eine Pull-Anforderung, die in GitHub geöffnet wurde. Der GitHub-Pull-Request wird in einem neuen Browser-Tab geöffnet.
Wählen Sie Pull Request zusammenführen aus.
Wechseln Sie zu Ihrer Repository-README-Datei und zeigen Sie das hinzugefügte Badge an.
Weitere Informationen finden Sie unter Status-Badges zu Ihrem GitHub-Repository hinzufügen.
Konfigurieren anderer Projekte oder Repositorys
Sie können andere Azure Boards/Azure DevOps Projekte, GitHub.com Repositorys konfigurieren oder die aktuelle Konfiguration von der Azure Boards-App-Seite ändern. Weitere Informationen finden Sie unter Hinzufügen oder Entfernen von Repositorys oder Entfernen einer Verbindung aus Azure Boards.
Hinzufügen oder Entfernen von Repositorys oder Entfernen einer Verbindung aus Azure Boards
Wenn ein Problem mit einer Verbindung auftritt, empfiehlt es sich, die Verbindung zu entfernen und mit einer neuen Verbindung zu beginnen.
Wechseln Sie in Ihrem Projekt in Azure DevOps zu Projekteinstellungen>GitHub connections.
Um Repositorys hinzuzufügen oder zu entfernen, wählen Sie die Auslassungspunkte für Weitere Optionen aus, um die Verbindung herzustellen, und wählen Sie im Menü Repositorys hinzufügen oder Repositorys entfernen aus.
Um alle Repositorys und die Verbindung zu entfernen, wählen Sie die Option Verbindung entfernen aus. Wählen Sie dann zur Bestätigung Entfernen aus.
Ändern des Repositoryzugriffs
Öffnen Sie im GitHub Webportal Settings aus Ihrem Profilmenü.
Wählen Sie "Integrationsanwendungen>" aus. Wählen Sie unter Installed GitHub AppsConfigure aus.
Die Azure Boards Konfigurationsseite wird geöffnet.
Scrollen Sie nach unten zum Abschnitt Repositoryzugriff.
Wählen Sie die gewünschte Option aus, Alle Repositorys oder Nur Repositorys auswählen.
Wenn Sie Nur ausgewählte Repositorys auswählen, wählen Sie die Repositorys aus, in der die Integration mit Azure Boards erfolgen soll.
Wählen Sie Speichern aus.
Anhalten oder Deinstallieren der Azure Boards-Integration
Scrollen Sie ab Schritt 2 im vorherigen Verfahren nach unten zum Abschnitt Gefahrenzone.
Um die Integration anzuhalten, wählen Sie Anhalten aus. Wählen Sie im Bestätigungsfenster "OK " aus, um das Anhalten zu bestätigen.
Wenn Sie das Anhalten der Integration aufheben möchten, wählen Sie Fortsetzen aus.
Um die Azure Boards-App zu deinstallieren, wählen Sie Uninstall aus, und wählen Sie dann im Popupbestätigungsfenster OK aus.
Aktualisieren von Azure Boards-GitHub-Verbindungen
Wenn Sie die Repositorys ändern, die von der Azure Boards-App für GitHub unterstützt werden, werden Sie möglicherweise zu Azure Boards GitHub Verbindungen umgeleitet. Es empfiehlt sich, die Repositorys in Azure Boards zu entfernen, die keine Verbindung mit GitHub mehr herstellen können. Weitere Informationen finden Sie unter Hinzufügen oder Entfernen von GitHub-Repositorien.
Wenn Sie die Azure Boards-App für GitHub deinstallieren, wird die folgende Meldung in Azure Boards angezeigt, Project settings>GitHub connections. Wählen Sie Verbindung entfernen aus, um alle zuvor vorgenommenen GitHub-Verbindungen zu entfernen. Weitere Informationen finden Sie unter Hinzufügen oder Entfernen von GitHub-Repositorys.
