Verbinden von Azure Boards mit GitHub (Cloud)

Azure DevOps Services

Verbinden Sie Ihr Azure Boards-Projekt mit GitHub.com Repositorys, sodass Commits und Pullanforderungen automatisch mit Arbeitsaufgaben verknüpft werden. Mit dieser Integration können Sie Die Arbeit in Azure Boards planen und nachverfolgen, während Ihr Team in GitHub entwickelt wird.

Nachdem Sie eine Verbindung hergestellt haben, können Sie:

• Automatische Verknüpfung von Commits, Zweigen und Pullanforderungen mit Arbeitsaufgaben
• Überwachen des Entwicklungsfortschritts direkt aus Azure Boards
• Verwendung von GitHub Copilot mit Arbeitsaufgaben für KI-gestützte Entwicklung

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. Wählen Sie für eine erstmalige Verbindung Ihr GitHub-Konto verbinden aus, um sich mit Ihren GitHub-Anmeldeinformationen zu authentifizieren.

   

   Wählen Sie für nachfolgende Verbindungen die Option "Neue Verbindung" und dann Ihre Authentifizierungsmethode aus.

   Informationen dazu, wie Sie stattdessen eine Verbindung mit einem PAT herstellen können, finden Sie unter Hinzufügen einer GitHub-Verbindung mit PAT. Informationen zu GitHub Enterprise Server finden Sie unter Registrieren von 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. Melden Sie sich mit Ihren GitHub-Anmeldeinformationen an. Wählen Sie ein Konto aus, bei dem Sie ein Repositoryadministrator sind.

2. Wählen Sie das GitHub-Konto oder die Organisation aus, um eine Verbindung herzustellen. Nur Organisationen, die Sie besitzen oder verwalten, werden in der Liste angezeigt.

   Wenn alle Repositorys für eine Organisation bereits 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 Code ein, und wählen Sie "Überprüfen" aus.

Hinzufügen von GitHub Repositorys

Nachdem Sie sich authentifiziert haben, wählen Sie die Repositorys aus, die eine Verbindung herstellen sollen.

1. Im Dialogfeld "GitHub-Repositorys hinzufügen " werden alle Repositorys angezeigt und vorgewählt, in denen Sie ein Administrator in der ausgewählten Organisation sind. Löschen Sie alle Repositorys, die Sie nicht verbinden möchten.

   

   Tipp

   Verbinden Sie jedes GitHub-Repository mit Projekten in einer einzelnen Azure DevOps-Organisation, um unerwartetes AB#-Erwähnungsverknüpfungen zu vermeiden. Weitere Informationen finden Sie unter Beheben von Verbindungsproblemen.

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

   

2. Wählen Sie Speichern aus.

Bestätigen der Verbindung

1. Wählen Sie auf der GitHub-Seite "Genehmigen", "Installieren" und "Autorisieren" aus.

   

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

3. Die neue Verbindung wird mit den ausgewählten Repositorys angezeigt.

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

1. Wählen Sie im Dialogfeld "Neue Verbindung" das persönliche 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 Repositories aus, die verbunden werden sollen. Ausführliche Informationen finden Sie unter Hinzufügen von GitHub-Repositorys.

4. Installieren Sie für eine erstmalige Verbindung die Azure Boards-App für GitHub. Siehe Bestätigen der Verbindung.

Registrieren von Azure DevOps in GitHub als OAuth-App

Um Azure DevOps mit Ihrem GitHub Enterprise Server mit OAuth zu verbinden, registrieren Sie die Anwendung 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.

   • Homepage-URL – Url Ihrer Organisation.
   • Autorisierungsrückruf-URL – Verwenden Sie das Muster {Organization URL}/_admin/oauth2/callback. Beispiel: https://dev.azure.com/fabrikam/_admin/oauth2/callback

   

4. Wählen Sie Anwendung registrieren aus.

5. Kopieren Sie die Client-ID und den geheimen Clientschlüssel , die für Ihre registrierte OAuth-Anwendung angezeigt werden.

   

Registrieren Ihrer OAuth-Konfiguration in Azure DevOps Services

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

2. Wählen Sie"Organisationseinstellungen" für Oauth-Konfigurationen>"Oauth-Konfiguration hinzufügen" aus.>

   

3. Geben Sie Ihre Informationen ein, und wählen Sie "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.

   

   Wählen Sie für nachfolgende Verbindungen gitHub Enterprise Server im Dialogfeld "Neue GitHub-Verbindung " aus.

   

2. Wählen Sie die Authentifizierungsmethode aus.

   

   Herstellen einer Verbindung mit OAuth – Wählen Sie die OAuth-Konfiguration aus, die Sie in der OAuth-Konfiguration registriert haben, und wählen Sie dann "Verbinden" aus.

   

   Herstellen einer Verbindung mit einem persönlichen Zugriffstoken – Geben Sie Ihre GitHub Enterprise Server-URL und PAT ein, und wählen Sie dann "Verbinden" aus.

   

   Herstellen einer Verbindung mit GitHub-Anmeldeinformationen – Geben Sie Ihre GitHub Enterprise Server-URL und Administratoranmeldeinformationen ein, und wählen Sie dann "Verbinden" aus.

   

3. Das Dialogfeld listet alle Repositorys auf, in denen Sie über Administratorrechte verfügen. Wechseln Sie zwischen Mine und All , um weitere Repositorys zu finden, wählen Sie die hinzuzufügenden Repositorys aus, und wählen Sie dann " Speichern" aus.

   

   Tipp

   Jede Verbindung unterstützt nur eine GitHub-Organisation. Um Repositorys aus einer anderen Organisation zu verbinden, fügen Sie eine separate Verbindung hinzu.

4. Installieren Sie für eine erstmalige Verbindung die Azure Boards-App für GitHub. Siehe Bestätigen der Verbindung.

Beheben von Verbindungsproblemen

Die Azure Boards-GitHub-Integration verwendet mehrere Authentifizierungsprotokolle, um die Verbindung aufrechtzuerhalten. Änderungen an Berechtigungsbereichen oder Anmeldeinformationen können verknüpfte GitHub-Repositorys trennen.

Eine Übersicht über die Integration 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 nicht wie erwartet funktioniert, überprüfen Sie, ob Sie dem Organisationszugriff gewährt haben.

1. Öffnen Sie im GitHub-Webportal Einstellungen im Profilmenü.
   

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

3. Wählen Sie unter "Organisationszugriff" die Option "Gewähren " für jede Organisation aus, in der die Zugriffsanforderung aussteht.

   

Beheben von Probleme beim Zugriff

Wenn die Azure Boards-Verbindung mit GitHub den Zugriff verliert, wird in der Benutzeroberfläche eine Red-X-Warnung angezeigt. Zeigen Sie mit der Maus auf die Warnung, um zu bestätigen, dass die Anmeldeinformationen nicht mehr gültig sind. Entfernen Sie die Verbindung, und erstellen Sie eine neue.

• OAuth-Verbindungen:

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

  • GitHub oder Azure DevOps können aufgrund eines Dienstausfalls oder eines Netzwerkproblems möglicherweise nicht erreichbar sein. Status überprüfen: GitHub | Azure DevOps

    Löschen Sie die Verbindung, und erstellen Sie sie erneut. GitHub fordert Sie auf, Azure Boards erneut zu autorisieren.

• PAT-Verbindungen:

  • Der PAT wurde widerrufen, oder seine Berechtigungsbereiche sind unzureichend.

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

    Erstellen Sie den PAT mit den erforderlichen Bereichen neu: 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, werden Arbeitsaufgabenerwähnungen in GitHub möglicherweise verzögert oder fehlen, da die Rückruf-URL nicht mehr gültig ist.

• Entfernen und erneutes Erstellen der Verbindung – Führen Sie die Schritte unter Verbinden von Azure DevOps Services mit GitHub Enterprise Server aus.

• Beheben Sie die Webhook-URL – Aktualisieren Sie in Ihren GitHub-Repositoryeinstellungen die Webhook-URL so, dass sie auf die migrierte Organisation verweist: https://dev.azure.com/{OrganizationName}/_apis/work/events?api-version=5.2-preview

Herstellen einer Verbindung mit mehreren Azure DevOps Organisationen

Das Verbinden eines GitHub-Repositorys mit Projekten in mehreren Azure DevOps-Organisationen (z. B. dev.azure.com/Contoso und dev.azure.com/Fabrikam) kann zu unerwartetem AB# -Erwähnungsverhalten führen. Arbeitsaufgaben-IDs sind in Organisationen nicht eindeutig, sodass AB#12 einer Arbeitsaufgabe in beiden Organisationen entsprechen könnte. Beide Organisationen versuchen möglicherweise, eine Verknüpfung mit der übereinstimmenden ID zu erstellen, was Zu Verwirrung führt.

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

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

Wenn Ihre Organisation das Gehostete XML- oder lokale XML-Prozessmodell verwendet, aktualisieren Sie die XML-Definitionen für Arbeitsaufgabentypen, um GitHub-Linktypen im Abschnitt "Entwicklung von Arbeitsaufgabenformularen" anzuzeigen.

Um beispielsweise Benutzergeschichten und Fehler mit GitHub zu verknüpfen und Anforderungen aus dem Abschnitt "Entwicklung " abzurufen, aktualisieren Sie die XML-Definitionen für diese Arbeitsaufgabentypen.

Führen Sie die Schritte im Gehosteten XML-Prozessmodell aus. Suchen Sie für jeden Arbeitsaufgabentyp den Group Label="Development" Abschnitt, und fügen Sie die folgenden Zeilen hinzu, um GitHub Commit - und GitHub Pull Request-Linktypen zu unterstützen:

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

Nach der Aktualisierung 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. Lassen Sie Ihre Benutzer sich abmelden und sich dann mit ihren GitHub-Anmeldeinformationen in einer neuen Browsersitzung bei der Organisation wieder anmelden.

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 bei Azure DevOps ab, und melden Sie sich 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. Arbeiten Sie mit Ihrem Administrator zusammen, um Berechtigungen zu erhalten, oder bitten Sie ihn, den Benutzer 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ächster Schritt

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