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. Durch Verknüpfen von Azure Boards-Projekten mit GitHub.com-Repositorys unterstützen Sie die Verknüpfung zwischen GitHub-Commits, Pull Requests zu Arbeitselementen. Sie können GitHub für die Softwareentwicklung verwenden, während Sie Azure Boards zum Planen und Nachverfolgen Ihrer Arbeit nutzen. Nachdem Sie die Azure Boards-App für GitHub auf 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 |
|---|---|
| Permissions | - Mitglied der Gruppe Projektsammlungsadministratoren. Wenn Sie das Projekt erstellt haben, verfügen Sie über Berechtigungen. - Administrator oder Eigentümer der GitHub-Organisation, um die Azure Boards-App zu installieren. - 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 es mithilfe der GitHub-App erneut verbinden. Führen Sie die weiter unten im Artikel beschriebenen Schritte zum Hinzufügen oder Entfernen von GitHub-Repositorys aus, bevor Sie die GitHub-App konfigurieren.
Sie können eine Azure DevOps-Organisation mit mehreren GitHub-Repositorys verbinden, wenn Sie für diese Repositorys Administrator*in 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. Führen Sie bei Bedarf die Bildschirmaufforderungen zwischen den folgenden Schritten aus.
Navigieren Sie im GitHub Marketplace zu Azure Boards-App.
Wählen Sie unter "Pläne und Preise" unter "Kostenlos" die Option "Installieren" aus.
Wählen Sie unter "Installieren und Autorisieren von Azure Boards" die Repositorys aus, die Sie mit Azure Boards verbinden möchten, und wählen Sie dann "Installieren und Autorisieren" aus.
In diesem Beispiel werden alle Repositorys verwendet:
Wählen Sie die Azure DevOps-Organisation und das Azure Boards-Projekt zum Verbinden mit GitHub.com aus.
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.
Gewähren des Azure Boards-Zugriffs für die Organisation
Führen Sie die folgenden Schritte aus, um GitHub-Zugriff auf Ihre Azure DevOps-Organisation zu gewähren.
Öffnen Sie im GitHub-Webportal über Ihr Profilmenü die Option Einstellungen.
Wählen Sie unter IntegrationenAnwendungen aus.
Wählen Sie Autorisierte 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 Drittanbieteranwendungen.
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 Neues Arbeitselement aus, um ein neues Arbeitselement mit dem Namen „Badge zu README hinzufügen“ einzugeben – Problem (Basic), User Story (Agile) oder Product Backlog Item (Scrum) – je nachdem, welches Prozessmodell Ihr Azure Boards-Projekt verwendet.
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 unter "Linktyp" die Option "GitHub-Pullanforderung" 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.
- Der README-Datei des ersten Repositorys aus der Liste der verbundenen GitHub-Repositorys wird ein Badge hinzu.
- Für das durch Hinzufügen des Badges zur README-Datei erfolgte Update wird ein GitHub-Commit erstellt.
- Es wird ein GitHub-Pull Request erstellt, um die an der README-Datei vorgenommenen Änderungen zusammenzuführen.
- GitHub-Commit und Pull Request werden mit dem in Schritt 1 erstellten Arbeitselement verknüpft.
Wählen Sie ausgehend von Ihrem Arbeitselement den ersten Pull-Request-Link aus.
Der GitHub-Pull Request wird in einer neuen Browserregisterkarte 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 Hinzufügen von Statussignalen für Ihr GitHub-Repository.
Konfigurieren anderer Projekte oder Repositorys
Sie können andere Azure Boards-/Azure DevOps-Projekte oder GitHub.com-Repositorys konfigurieren oder die aktuelle Konfiguration auf der Seite der Azure Boards-App ä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.
Navigieren Sie in Ihrem Projekt in Azure DevOps zu Projekteinstellungen>GitHub-Verbindungen.
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 über Ihr Profilmenü die Option Einstellungen.
Wählen Sie "Integrationsanwendungen>" aus. Wählen Sie unter "Installierte GitHub-Apps" die Option "Konfigurieren" 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 Repositorys auswählen auswählen, wählen Sie die Repositorys aus, die an der Integration in Azure Boards beteiligt sein sollen.
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 Deinstallieren und dann im Popupbestätigungsfenster OK aus.
Aktualisieren der GitHub-Verbindungen von Azure Boards
Wenn Sie die Repositorys ändern, die die Azure Boards-App für GitHub unterstützt, werden Sie möglicherweise zu Azure Boards GitHub-Verbindungen umgeleitet. Eine bewährte Methode besteht darin, die Repositorys in Azure Boards zu entfernen, die keine Verbindung mit GitHub mehr herstellen können. Weitere Informationen finden Sie unter GitHub-Repositorys hinzufügen oder entfernen.
Wenn Sie die Azure Boards-App für GitHub deinstallieren, wird in Azure Boards die folgende Meldung angezeigt: Projekteinstellungen>GitHub-Verbindungen. Wählen Sie Verbindung entfernen aus, um alle zuvor hergestellten GitHub-Verbindungen zu entfernen. Weitere Informationen finden Sie unter GitHub-Repositorys hinzufügen oder entfernen.
