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 | Azure DevOps Server 2020
In diesem Artikel erfahren Sie, wie Sie Arbeitsaufgaben mit GitHub-Commits, Pullanforderungen und Verzweigungen verknüpfen, nachdem Sie Ihr Azure Boards-Projekt mit einem GitHub-Repository verbunden haben. Sie können die #mention-Syntax für Commits und Verzweigungen verwenden oder einen GitHub-Commit, eine Pullanforderung oder einen Verzweigungslink direkt aus der Arbeitsaufgabe von Azure Boards hinzufügen.
Note
Unterstützung der GitHub-Integration:
- Azure DevOps Services: Integriert sich sowohl in GitHub.com- als auch in GitHub Enterprise Server-Repositories über die Azure Boards-App für GitHub.
- Azure DevOps Server 2020 und höher: Unterstützt nur die Integration in GitHub Enterprise Server-Repositorys.
- Andere Git-Repositorys: Die Integration wird nicht unterstützt.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | Mitwirkender sowohl des Azure Boards-Projekts als auch des GitHub-Repositorys. |
| Projektverbindung | Das Azure Boards-Projekt ist mit dem GitHub-Repository verbunden, in dem die Commits, Pull-Anfragen und Branches vorhanden sind, mit denen Sie eine Verknüpfung herstellen möchten. Weitere Informationen finden Sie unter Azure Boards-GitHub Integration. |
Note
Bei Projekten, die das gehostete XML-Prozessmodell verwenden, müssen die Arbeitselementtypen aktualisiert werden, um den Abschnitt „Entwicklung“ und die GitHub-Verknüpfungstypen anzuzeigen. Weitere Informationen finden Sie unter Aktualisieren von XML-Definitionen für die Auswahl von Arbeitsaufgabentypen.
Verwenden von AB# zum Verknüpfen von GitHub mit Azure Boards-Arbeitselementen
Verwenden Sie aus einem GitHub-Commit, -Pull Request oder -Issue die folgende Syntax, um eine Verknüpfung mit Ihrem Azure Boards-Arbeitselement herzustellen. Geben Sie AB#ID im Text einer Commitnachricht ein. Oder geben Sie für eine Pullanforderung oder ein Problem das AB#ID in die Beschreibung ein. Die Verwendung von AB#ID in einem Kommentar- oder Pull Request-Titel erstellt keinen Link im Arbeitselement.
AB#{ID}
AB#125 verknüpft beispielsweise zu Arbeitselement-ID 125.
Sie können auch eine Commit- oder Pull Request-Nachricht eingeben, um den Status des Arbeitselements zu ändern. Das System erkennt {state} oder {state category}, zusammen mit fix, fixes und fixed, und wendet es auf das folgende #-Mention-Element an.
Wenn eine Beschreibung der Pullanforderung beispielsweise einen gültigen Statusnamen enthält, Closed AB#1234aktualisiert das System die Referenzarbeitsaufgabe in diesen spezifischen Zustand. Wenn der Statusname nicht direkt erkannt wird, versucht Azure Boards, ihn einer Workflow-Kategorie wie Resolved oder Completed zuzuordnen. Wenn eine Übereinstimmung gefunden wird, wechselt die Arbeitsaufgabe in den ersten verfügbaren Zustand, der unter dieser Kategorie definiert ist.
Standardmäßig wechseln Arbeitsaufgaben, die mit fix, fixes oder fixed referenziert werden, in den ersten Zustand, der der Kategorie Aufgelöst zugeordnet ist. Wenn im aktuellen Prozess kein solcher Zustand vorhanden ist, übergibt das System stattdessen die Arbeitsaufgabe in den ersten Zustand in der Kategorie "Abgeschlossen ".
Important
Sie können weiterhin Arbeitselemente verknüpfen und andere Branches anvisieren, aber Statusübergangsregeln gelten nicht, es sei denn, der Pull-Request wird in den Standard-Branch gemerged.
Weitere Informationen finden Sie unter Verwendung von Workflowkategoriestatus in Backlogs und Boards von Azure Boards.
Die folgende Tabelle enthält Beispiele:
| Commit- oder Pull Request-Nachricht | Action |
|---|---|
Fixed AB#123 |
Verknüpft und übergibt die Arbeitsaufgabe zur Kategorie "Aufgelöster Workflowstatus" oder, wenn keine definiert ist, die Kategorie " Abgeschlossener Workflowstatus". |
Closed AB#123 |
Verknüpft und übergibt die Arbeitsaufgabe in den Zustand "Geschlossener Workflow". Wenn keine definiert ist, werden keine Übergänge vorgenommen. |
Adds a new feature, fixes AB#123. |
Verknüpft und übergibt die Arbeitsaufgabe zur Kategorie "Aufgelöster Workflowstatus" oder, wenn keine definiert ist, die Kategorie " Abgeschlossener Workflowstatus". |
Fixes AB#123, AB#124, and AB#126 |
Verknüpfungen zu Azure Boards-Arbeitselementen 123, 124 und 126. Überführt nur das erste Element, 123, in den Workflowstatus „Aufgelöster“ oder, wenn keiner definiert ist, in den Workflowstatus „Abgeschlossener“. |
Fixes AB#123, Fixes AB#124, Fixes AB#125 |
Verknüpfungen zu Azure Boards-Arbeitselementen 123, 124 und 126. Übergibt alle Elemente in die Kategorie "Aufgelöster Workflowstatus" oder , wenn keine definiert ist, die Kategorie " Abgeschlossener Workflowstatus". |
Fixing multiple bugs: issue #123 and user story AB#234 |
Verknüpfungen zu GitHub-Issue 123 und Azure Boards-Arbeitselement 234. Es werden keine Übergänge durchgeführt. |
Note
Wenn Sie dasselbe GitHub-Repository mit Projekten verbunden haben, die in zwei oder mehr Azure DevOps-Organisationen definiert sind, wird möglicherweise eine unerwartete AB#-Referenzverknüpfung angezeigt. Weitere Informationen finden Sie unter Beheben von Verbindungsproblemen. Aus diesem Grund sollten Sie ein GitHub-Repository nur mit Projekten verbinden, die in einer einzelnen Azure DevOps-Organisation definiert sind.
Wenn Sie einen Link zu einer Arbeitsaufgabe mithilfe von AB# hinzufügen, werden diese Links im Abschnitt "Entwicklung" der Pullanforderung angezeigt.
Erstellen einer GitHub-Verzweigung aus einem Arbeitselement
Führen Sie die folgenden Schritte aus, um eine GitHub-Verzweigung direkt aus einem Arbeitselement zu erstellen:
Suchen Sie von Ihrem Board aus nach dem Arbeitselement, aus dem Sie eine GitHub-Verzweigung erstellen möchten.
Wählen Sie
Aktionen für Arbeitselement>Neue GitHub-Verzweigung aus.
Geben Sie im Dialogfeld " GitHub-Verzweigung erstellen" den Verzweigungsnamen ein, und wählen Sie das GitHub-Repository und den Basiszweig aus.
Wählen Sie "Erstellen" aus.
Azure Boards erstellt die Verzweigung im angegebenen GitHub-Repository und verknüpft sie mit dem Arbeitselement. Weitere Informationen finden Sie unter Azure Boards-GitHub Integration.
Hinzufügen einer Arbeitselementverknüpfung zu GitHub-Verzweigung, Commit oder Pull-Anforderung
Öffnen Sie die Arbeitsaufgabe, und wechseln Sie zur Registerkarte "Links ".
Wählen Sie im Dialogfeld "Link hinzufügen " einen der GitHub-Linktypen aus, wählen Sie ein GitHub-Repository aus, geben Sie die URL zu GitHub-Verzweigung, commit oder Pullanforderung ein, und wählen Sie dann "Link hinzufügen" aus.
Im folgenden Beispiel fügen wir einen Link zu einem GitHub-Pull Request hinzu.
Azure Boards führt eine Überprüfung durch, um sicherzustellen, dass Sie eine gültige Verknüpfung eingegeben haben. Das mit GitHub verknüpfte Repository muss mit dem Azure Boards-Projekt verbunden sein , oder die Überprüfung schlägt fehl.
Note
Wenn Sie Azure DevOps Server und GitHub Enterprise Server verwenden, gibt es eine Verzögerung beim Abschließen der AB#-Links. Wir haben ein „Push-and-Pull“-Design, das jede Stunde über die inkrementellen Änderungen bei Commit, PR und Problem aus den GitHub-Ereignissen abgerufen werden soll.
Automatische Verknüpfungsaktualisierungen
Mehrere Ereignisse aktualisieren die Verknüpfungen im Arbeitsaufgabenformular automatisch, sodass Sie sie nicht manuell erstellen müssen. Dazu gehören:
| GitHub-Ereignis | Action |
|---|---|
| Verknüpfung zur Verzweigung | Wenn eine Pullanforderung aus einer Verzweigung erstellt wird, wird sie automatisch mit der Arbeitsaufgabe verknüpft. |
| Zusammenführen des Commits | Nachdem die Pullanforderung zusammengeführt wurde, wird der resultierende Zusammenführungs-Commit automatisch mit der Arbeitsaufgabe verknüpft. |
| Verzweigung löschen | Wenn eine Verzweigung gelöscht wird (typischerweise nach dem Zusammenführen), wird der Link automatisch aus dem Arbeitsobjekt entfernt. |
Anzeigen oder Öffnen von Verknüpfungen im Abschnitt „Entwicklung“
Im Abschnitt „Entwicklung“ innerhalb des Arbeitselementformulars werden die erstellten Verknüpfungen mit GitHub-Commits und -Pull Requests durch das GitHub-Symbol 
gekennzeichnet.
Wählen Sie die angegebene Verknüpfung aus, um den Commit oder Pull Request in GitHub zu öffnen.
Anzeigen von GitHub-Objekten auf einem Board
Wenn auf dem Board GitHub-Kommentare aktiviert sind, können Sie verknüpfte GitHub-Commits, Pull-Requests oder Issues schnell öffnen, um weitere Details zu erhalten. Weitere Informationen finden Sie unter Anpassen von Karten.
