Verbinden von Azure Boards mit GitHub (Cloud)

Azure DevOps Services

Verwenden Sie GitHub.com Repositorys für Ihre Softwareentwicklung und Ihr Azure Boards Projekt, um Ihre Arbeit zu planen und nachzuverfolgen. Verbinden Sie Ihr Projekt und Ihr Repository, damit Ihre GitHub Commits und Pull Requests mit Ihren Arbeitsaufgaben in Azure Boards verknüpft werden.

Voraussetzungen

Authentifizierungsoptionen

Die folgenden Authentifizierungsoptionen werden basierend auf der GitHub Plattform unterstützt, mit der Sie eine Verbindung herstellen möchten.

Verbinden Azure Boards mit einem GitHub-Repository

1. Melden Sie sich bei Ihrem Projekt (https://dev.azure.com/{Your_Organization/Your_Project}).

2. Wählen Sie Projekteinstellungen>GitHub Connections aus.

   

3. Wenn Sie zum ersten Mal eine Verbindung mit dem Projekt herstellen, wählen Sie Connect your GitHub account aus, um Ihre GitHub Kontoanmeldeinformationen zu verwenden.

   

   Wählen Sie andernfalls Neue Verbindung und im Dialogfeld Neue Verbindung Ihre Authentifizierungsmethode aus.

   Wenn Sie eine Verbindung mit Ihrem GitHub Konto herstellen, verwenden Sie Ihre GitHub Anmeldeinformationen, um sich zu authentifizieren. Informationen zur Verwendung eines PAT finden Sie unter Add a GitHub connection using PAT. Informationen zum Herstellen einer Verbindung mit einem GitHub Enterprise Server finden Sie unter Register Azure DevOps in GitHub als OAuth-App.

Hinzufügen einer GitHub Verbindung mit GitHub Anmeldeinformationen

Sie können bis zu 1.000 GitHub Repositorys mit einem Azure Boards Projekt verbinden.

1. Wenn Sie zum ersten Mal eine Verbindung mit GitHub von Azure Boards herstellen, melden Sie sich mit Ihren GitHub Anmeldeinformationen an. Wählen Sie ein Konto aus, für das Sie Repository-Administrator*in sind.

2. Wählen Sie das GitHub Konto oder die Organisation aus, das Sie verbinden möchten. Nur die Organisationen, deren Eigentümer oder Admin Sie sind, werden aufgeführt.

   Wenn alle Repositorys für eine Organisation bereits mit Azure Boards verbunden sind, wird die folgende Meldung angezeigt:

   

3. Geben Sie Ihre GitHub Anmeldeinformationen ein. Wenn die zweistufige Authentifizierung aktiviert ist, geben Sie den von GitHub gesendeten Authentifizierungscode ein, und wählen Sie Verify aus. Wenn nicht, erkennt das System Ihre GitHub Organisation automatisch, da Ihr GitHub Konto Ihrem Azure DevOps Services-Konto zugeordnet ist.

Hinzufügen von GitHub Repositorys

Nachdem Sie authentifiziert wurden, können Sie die Repositorys auswählen, mit denen Sie eine Verbindung herstellen möchten.

1. Das Dialogfeld Add GitHub Repositorys zeigt automatisch alle GitHub.com Repositorys an, für die Sie ein Administrator in der ausgewählten Organisation sind. Heben Sie die Auswahl aller Repositorys auf, die nicht zu der Integration gehören sollen.

   

   Tipp

   Um unerwartete AB# erwähnungsverknüpfung zu vermeiden, empfehlen wir, ein GitHub Repository mit Projekten innerhalb einer einzelnen Azure DevOps Organisation zu verbinden. Das Verbinden desselben GitHub Repositorys mit Projekten in mehreren Azure DevOps Organisationen kann Zu Problemen führen. Weitere Informationen finden Sie unter Troubleshoot GitHub & Azure Boards Integration.

   Wenn alle Repositorys bereits mit der aktuellen oder einer anderen Organisation verbunden sind, wird die folgende Meldung angezeigt:

   

2. Klicken Sie auf Speichern, nachdem Sie die Auswahlen vorgenommen haben.

Bestätigen der Verbindung

1. Überprüfen Sie die GitHub Seite, die angezeigt wird, und wählen Sie dann Approve, Install & Autorisieren.

   

2. Geben Sie Ihre GitHub Anmeldeinformationen an, um dies zu bestätigen.

3. Wenn Sie fertig sind, sollte die neue Verbindung mit den ausgewählten Repositorys aufgeführt werden.

Um die Konfiguration zu ändern oder die Azure Boards-App für GitHub zu verwalten, siehe Repositoryzugriff auf Azure Boards ändern.

Hinzufügen einer GitHub Verbindung mithilfe von PAT

Wir empfehlen die Verwendung Ihrer GitHub Kontoanmeldeinformationen, um eine Verbindung mit Ihrem GitHub Repository herzustellen.

1. Wählen Sie Persönliches Zugriffstoken aus.

   

   Um einen GitHub PAT zu erstellen, wechseln Sie zu GitHub Entwicklereinstellungen > Persönliche Zugriffstoken.

2. Geben Sie das PAT ein, und wählen Sie dann Verbinden aus.

   

3. Wählen Sie die Repositorys aus, die Sie mit dem Projekt verbinden möchten, indem Sie die unter Auswählen der Repositorys weiter oben in diesem Artikel beschriebenen Verfahren befolgen.

4. Wenn sie zum ersten Mal eine Verbindung mit einem GitHub Konto oder einer Organisation aus Azure Boards herstellen, installieren Sie die Azure Boards-App für GitHub. Bestätigen der Verbindung weiter oben in diesem Artikel.

Registrieren von Azure DevOps in GitHub als OAuth-App

Wenn Sie OAuth verwenden möchten, um Azure DevOps mit Ihrem GitHub Enterprise Server zu verbinden, registrieren Sie die Anwendung zuerst als OAuth-App. Weitere Informationen finden Sie unter „Erstellen einer OAuth-App“.

Registrieren von Azure DevOps Services

1. Melden Sie sich beim Webportal für Ihren GitHub Enterprise-Server an.

   

2. Öffnen Sie „Einstellungen“>„Entwicklereinstellungen“>„Oauth-Apps“>„Neue OAuth-App“.

   

3. Geben Sie die Registrierungsinformationen ein.

   Geben Sie für URL für Startseite die Organisations-URL Ihrer Organisation an.
   Verwenden Sie für die Autorisierungsrückruf-URL das folgende Muster, um die URL zu erstellen.

   {Azure DevOps Services Organization URL}/_admin/oauth2/callback

   Zum Beispiel:

   https://dev.azure.com/fabrikam/_admin/oauth2/callback

   

4. Wählen Sie Anwendung registrieren aus.

5. Client-ID und geheimer Clientschlüssel für Ihre registrierte OAuth-Anwendung werden angezeigt.

   

Registrieren Ihrer OAuth-Konfiguration in Azure DevOps Services

1. Melden Sie sich beim Webportal für Azure DevOps Dienste an.

2. Fügen Sie ihrer Organisation die GitHub Enterprise Oauth-Konfiguration hinzu.

3. Wählen Sie in den OrganisationseinstellungenOauth-Konfigurationen>„Oauth-Konfiguration hinzufügen“ aus.

   

4. Geben Sie Ihre Informationen ein, und wählen Sie dann „Erstellen“ aus.

   

Verbinden von Azure DevOps Services mit GitHub Enterprise Server

1. Wählen Sie Projekteinstellungen>GitHub connections>GitHub Enterprise Server für eine erstmalige Verbindung aus.

   

   Oder wählen Sie im Dialogfeld Neue GitHub VerbindungGitHub Enterprise Server aus.

   

2. Wählen Sie die Authentifizierungsmethode aus.

   

   Verbinden mit OAuth

   Wählen Sie die Konfiguration aus, die Sie in Schritt 4 der Registrierung Ihrer OAuth-Konfiguration in Azure DevOps Services eingerichtet haben, und wählen Sie dann Verbinden aus.

   

   Mit einem persönlichen Zugriffstoken verbinden

   Geben Sie die URL für Ihren GitHub Enterprise-Server und die anmeldeinformationen für das persönliche Zugriffstoken ein, die von diesem Server erkannt werden. Wählen Sie dann Verbinden aus.

   

   Verbinden mit GitHub Anmeldeinformationen

   Geben Sie die URL für Ihren GitHub Enterprise-Server und die anmeldeinformationen des Administratorkontos ein, die von diesem Server erkannt wurden, und wählen Sie dann Verbinden aus.

   

3. Im Dialogfeld werden alle Repositorys aufgeführt, für die Sie über GitHub Administratorrechte verfügen. Sie können zwischen Meine und Alle umschalten, um festzustellen, ob weitere Repositorys angezeigt werden, und dann die Repositorys aktivieren, die Sie hinzufügen möchten. Wählen Sie Speichern aus, wenn Sie fertig sind.

   

   Tipp

   Sie können nur eine Verbindung mit Repositorys herstellen, die in einer GitHub Organisation definiert sind. Um ein Projekt mit anderen Repositorys zu verbinden, die in einer anderen GitHub Organisation definiert sind, müssen Sie eine weitere Verbindung hinzufügen.

4. Wenn Sie zum ersten Mal eine Verbindung mit einem GitHub Konto oder einer Organisation aus Azure Boards herstellen, installieren Sie auch die Azure Boards-App für GitHub. Bestätigen der Verbindung weiter oben in diesem Artikel.

Beheben von Verbindungsproblemen

Die Azure Boards-GitHub-Integration verwendet verschiedene Authentifizierungsprotokolle, um die Verbindung aufrechtzuerhalten. Änderungen am Berechtigungsbereich oder den Authentifizierungsanmeldeinformationen eines Benutzers können die GitHub Repositorys widerrufen, die mit Azure Boards verbunden sind.

Eine Übersicht über die integration, die von der Azure Boards-App für GitHub unterstützt wird, finden Sie unter Azure Boards-GitHub integration.

Unterstützte Authentifizierungsoptionen

Die folgenden unterstützten Authentifizierungsoptionen hängen von der GitHub Plattform ab, mit der Sie eine Verbindung herstellen:

Gewähren Sie Zugriff auf die Azure Boards-Organisation

Wenn die Integration zwischen Azure Boards und GitHub nicht wie erwartet funktioniert, stellen Sie sicher, dass Ihnen der Organisationszugriff gewährt wurde.

1. Öffnen Sie im GitHub Webportal Settings aus Ihrem Profilmenü.
   

2. Wählen Sie Applications unter Integrations>Authorized OAuth Apps>Azure Boards aus.

3. 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.

   

Beheben von Probleme beim Zugriff

Wenn die Azure Boards Verbindung mit GitHub den Zugriff verliert, wird ein Warnungsstatus mit einem roten X auf der Benutzeroberfläche angezeigt. Wenn Sie den Mauszeiger über die Warnmeldung bewegen, wird angezeigt, dass die Anmeldeinformationen nicht mehr gültig sind. Um dieses Problem zu beheben, entfernen Sie die Verbindung, und erstellen Sie eine neue.

Ziehen Sie die folgenden Schritte in Betracht, um das Problem zu lösen:

• Wenn die Verbindung OAuth verwendet:

  • Der Azure Boards-Anwendung wurde für eines der Repositorys der Zugriff verweigert.

  • GitHub ist möglicherweise nicht verfügbar/nicht erreichbar. Diese Nichtverfügbarkeit könnte auf einen Dienstausfall oder auf ein Problem mit der lokalen Infrastruktur bzw. dem lokalen Netzwerk zurückzuführen sein. Sie können den Dienststatus über die folgenden Links überprüfen:

    • GitHub
    • Azure DevOps

    Löschen Sie die Verbindung mit dem GitHub Repository, und erstellen Sie sie erneut. Durch diese neu erstellte Verbindung wird GitHub aufgefordert, Azure Boards erneut zu autorisieren.

• Wenn die Verbindung ein PAT verwendet:

  • Das PAT wurde widerrufen oder die erforderlichen Berechtigungsbereiche haben sich geändert und sind unzureichend.

  • Der Benutzer verfügt möglicherweise nicht über Administratorberechtigungen für das GitHub Repository.

    Erstellen Sie das persönliche Zugriffstoken neu und stellen Sie sicher, dass der Bereich für das Token die erforderlichen Berechtigungen enthält: repo, read:user, user:email, admin:repo_hook. Weitere Informationen finden Sie unter Bewährte Methoden für die Verwendung von PATs.

Beheben fehlerhafter GitHub Enterprise Server-Verbindung

Wenn Sie von Azure DevOps Server zu Azure DevOps Services mit einer vorhandenen GitHub Enterprise Server-Verbindung migriert haben, funktioniert Ihre vorhandene Verbindung möglicherweise nicht wie erwartet. Erwähnungen von Arbeitsaufgaben innerhalb GitHub werden möglicherweise verzögert oder nie in Azure DevOps Services angezeigt, da die mit GitHub verknüpfte Rückruf-URL nicht mehr gültig ist. Beachten Sie die folgenden Lösungen:

• Entfernen und erneutes Erstellen der Verbindung: Entfernen und erneutes Erstellen der Verbindung zum GitHub Enterprise Server-Repository. Führen Sie die In Verbinden aus Azure Boards Dokumentation beschriebenen Schritte aus.

• Beheben Sie die Webhook-URL: Gehen Sie zur Einstellungsseite des GitHub-Repositorys und bearbeiten Sie die Webhook-URL, um auf die migrierte Azure DevOps-Organisations-URL zu verweisen: https://dev.azure.com/{OrganizationName}/_apis/work/events?api-version=5.2-preview

Herstellen einer Verbindung mit mehreren Azure DevOps Organisationen

Wenn Sie Ihr GitHub-Repository mit Projekten in mehreren Azure DevOps-Organisationen verbinden, wie z. B. dev.azure.com/Contoso und dev.azure.com/Fabrikam, kann dies unerwartete Ergebnisse mit AB#-Erwähnungen verursachen. Arbeitsaufgaben-IDs sind in Azure DevOps Organisationen nicht eindeutig. Daher können AB#12 auf eine Arbeitsaufgabe in Contoso oder Fabrikam verweisen. Wenn ein Arbeitselement in einer Commit-Nachricht oder einer Pull-Anforderung erwähnt wird, können beide Organisationen versuchen, ein Arbeitselement mit der passenden ID zu verknüpfen, was zu Verwirrung führt.

Um dieses Problem zu vermeiden, verbinden Sie ein einzelnes GitHub Repository mit nur einer Azure DevOps Organisation.

Aktualisieren von XML-Definitionen für ausgewählte Arbeitselementtypen

Aktualisieren Sie die XML-Definitionen für die Arbeitsaufgabentypen, wenn Ihre Organisation das Gehostete XML- oder lokale XML-Prozessmodell verwendet, um die Arbeitsverfolgungserfahrung anzupassen und die Verknüpfungen mit den GitHub Linktypen aus dem Abschnitt "Entwicklung" in den Arbeitsaufgabenformularen anzuzeigen.

Wenn Sie z. B. Benutzergeschichten und Fehler mit GitHub Commits verknüpfen und Anforderungen aus dem Abschnitt Development abrufen möchten, aktualisieren Sie die XML-Definitionen für Benutzergeschichten und Fehler.

Beachten Sie beim Aktualisieren der XML-Definitionen die in Gehostetes XML-Prozessmodell angegebene Aufgabereihenfolge. Suchen Sie für jeden Arbeitsaufgabentyp den Abschnitt Group Label="Development", und fügen Sie die folgenden beiden Zeilen in der Codesyntax hinzu, um die externen Verknüpfungstypen zu unterstützen: GitHub Commit und GitHub Pull Request.

             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  

Nach dem Aktualisieren sollte der Abschnitt wie folgt angezeigt werden.

<Group Label="Development">  
   <Control Type="LinksControl" Name="Development">  
      <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">  
         <ListViewOptions GroupLinks="false">   
         </ListViewOptions>  
         <LinkFilters>  
             <ExternalLinkFilter Type="Build" />  
             <ExternalLinkFilter Type="Integrated in build" />  
             <ExternalLinkFilter Type="Pull Request" />  
             <ExternalLinkFilter Type="Branch" />  
             <ExternalLinkFilter Type="Fixed in Commit" />  
             <ExternalLinkFilter Type="Fixed in Changeset" />  
             <ExternalLinkFilter Type="Source Code File" />  
             <ExternalLinkFilter Type="Found in build" />  
             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  
         </LinkFilters>  
      </LinksControlOptions>  
   </Control>  
</Group>  

Häufig gestellte Fragen

F: Einige meiner Benutzer in Azure DevOps haben GitHub Identitäten. Muss ich sie als neue GitHub Benutzer zu meiner Organisation hinzufügen?

A: Nein. Bitten Sie Ihre Benutzer, sich abzumelden und sich dann mit ihren GitHub Anmeldeinformationen aus einer neuen Browsersitzung bei der Organisation anzumelden. Diese Aktion richtet ihre GitHub Identitäten ein.

F: Ich bin Organisationsadministrator und habe die Richtlinie zum Einladen der GitHub-Benutzer aktiviert. Warum kann ich keine neuen GitHub Benutzer einladen?

A: Melden Sie sich nach dem Ändern der Einstellung von Azure DevOps ab, und melden Sie sich dann bei der Organisation (dev.azure.com/{organizationName} oder organizationName.visualstudio.com) mit Ihren GitHub Anmeldeinformationen aus einer neuen Browsersitzung an.

F: Ich habe mich mit meinen GitHub Anmeldeinformationen angemeldet, aber warum kann ich GitHub Benutzer nicht einladen?

A: Nur Organisations- oder Projektadministratoren können neue Benutzer einladen, der Organisation beizutreten. Möglicherweise haben Sie nicht die erforderlichen Berechtigungen, um neue Benutzer hinzuzufügen. Wenden Sie sich an Ihren Administrator, um die erforderlichen Berechtigungen zu erhalten, oder bitten Sie ihn, den Benutzer für Sie hinzuzufügen.

F: Erhalten GitHub Enterprise-Benutzer kostenlosen Zugriff auf Azure DevOps?

A: Weitere Informationen finden Sie unter User and permissions management FAQs/GitHub Enterprise.

Nächste Schritte

Verwandte Inhalte

• Installieren und Konfigurieren der Azure Boards-App für GitHub
• Statusabzeichen konfigurieren, um sie zu GitHub-README-Dateien hinzuzufügen
• Fehlerbehebung der Integration von GitHub und Azure Boards
• Build GitHub Repositorys
• Ändere den Zugriff auf das GitHub-Repository

Was Sie mit GitHub Integration tun können

Nach der Verbindung haben Sie folgende Möglichkeiten:

• Verwenden Sie GitHub Copilot: Verwenden Sie GitHub Copilot mit Arbeitselementen zur automatisierten Codeerstellung
• Verknüpfung von Arbeitsaufgaben: Automatisches Verknüpfen von Commits, Branches und Pull-Anforderungen mit Arbeitsaufgaben
• Verlaufsüberwachung: Fortlaufende Überwachung des Fortschritts direkt in Azure Boards