Erstellen von Pull Requests
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018
Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015
Erstellen Sie Pullanforderungen (PRs) zum Ändern, Überprüfen und Zusammenführen von Code in einem Git-Repository. Sie können PRs aus Zweigen im Upstream-Repository oder aus Zweigen in Ihrem Fork des Repositorys erstellen. Ihr Team kann die PRs überprüfen und Feedback zu Änderungen geben. Prüfer können die vorgeschlagenen Änderungen durchlaufen, Kommentare verlassen und abstimmen, um die PRs zu genehmigen oder abzulehnen. Je nach Zweigrichtlinien und anderen Anforderungen müssen Ihre PR möglicherweise verschiedene Kriterien erfüllen, bevor Sie die PR abschließen und die Änderungen in die Zielzweige zusammenführen können.
Informationen zu PR-Richtlinien und Verwaltungsüberlegungen finden Sie unter "Informationen zu Pullanforderungen".
Voraussetzungen
Repos muss auf Ihrem Projekt aktiviert sein. Wenn der Repos Hub und zugeordnete Seiten nicht angezeigt werden, finden Sie unter Aktivieren oder Deaktivieren eines Azure DevOps Diensts, um Repos erneut zu können.
Um PRs anzuzeigen oder zu überprüfen, müssen Sie Mitglied eines Azure DevOps Projekts sein, bei dem der Grundlegende Zugriff oder höher besteht.
- Wenn Sie kein Projekt haben, erstellen Sie ein Projekt oder registrieren Sie sich kostenlos.
- Wenn Sie kein Projektmitglied sind, werden Sie hinzugefügt.
Um zu einer PR beizutragen, müssen Sie Mitglied der Sicherheitsgruppe "Leser " sein oder über die entsprechenden Berechtigungen verfügen.
Um eine PR zu erstellen und abzuschließen, müssen Sie Mitglied der Sicherheitsgruppe " Mitwirkende " sein oder über die entsprechenden Berechtigungen verfügen.
Hinweis
Für öffentliche Projekte haben Benutzer, die dem Stakeholder-Zugriff gewährt wurden, vollständigen Zugriff auf Azure Repos.
- Repos muss auf Ihrem Projekt aktiviert sein. Wenn der Repos Hub und zugeordnete Seiten nicht angezeigt werden, finden Sie unter Aktivieren oder Deaktivieren eines Azure DevOps Diensts, um Repos erneut zu können.
- Um PRs anzuzeigen oder zu überprüfen, müssen Sie Mitglied des Azure DevOps-Projekts sein, auf das der Grundlegende Zugriff oder höher festgelegt ist. Wenn Sie kein Projektmitglied sind, werden Sie hinzugefügt.
- Um eine PR zu erstellen und abzuschließen, müssen Sie Mitglied der Sicherheitsgruppe " Mitwirkende " sein oder über die entsprechenden Berechtigungen im Projekt verfügen, das Sie ändern möchten.
- Um zu einer PR beizutragen, müssen Sie Mitglied der Sicherheitsgruppe "Leser " sein oder über die entsprechenden Berechtigungen verfügen.
- Um eine PR zu erstellen und abzuschließen, müssen Sie Mitglied der Sicherheitsgruppe " Mitwirkende " sein oder über die entsprechenden Berechtigungen verfügen.
- Um PRs anzuzeigen oder zu überprüfen, müssen Sie Mitglied eines Azure DevOps Projekts sein, bei dem der Grundlegende Zugriff oder höher besteht. Wenn Sie kein Projektmitglied sind, werden Sie hinzugefügt.
- Um zu einer PR beizutragen, müssen Sie Mitglied der Sicherheitsgruppe "Leser " sein oder über die entsprechenden Berechtigungen verfügen.
- Weitere Informationen zu Berechtigungen und Zugriff finden Sie unter Standard-Git-Repository- und Zweigberechtigungen undÜber Zugriffsstufen.
- Sie können PRs über die Azure-Befehlszeilenschnittstelle (CLI) mit der
azure-devopsErweiterung erstellen und verwalten. Informationen zum Arbeiten mit der Azure DevOps Services CLI finden Sie unter Erste Schritte mit Azure DevOps CLI. Azure Repos CLI-Befehle für PRs verwenden az repos pr.
Erstellen eines Pull Requests
Sie können eine neue PR aus der Azure DevOps Projektwebsite, aus Visual Studio oder aus der Azure DevOps CLI erstellen.
Auf der Azure DevOps Projektwebsite können Sie eine neue PR von:
- Die Pull-Anforderungsseite.
- Ein Featurezweig, der an Ihr Repo verschoben wurde.
- Eine vorhandene PR mithilfe von Kirschauswahl.
- Das Entwicklungssteuerelement in einem verknüpften Azure Boards Arbeitselement.
Erstellen einer PR aus der Pull-Anforderungsseite
Sie können PRs für jede Verzweigung aus der Pull-Anforderungsseite Ihres Projekts im Web erstellen.
Wählen Sie auf der Seite "Repos>Pull-Anforderungen" die Option "Neue Pullanforderung" oben rechts aus.
Wählen Sie die Verzweigung mit den Änderungen und dem Zweig aus, in den Sie die Änderungen zusammenführen möchten, z. B. die Hauptzweige.
Geben Sie Ihre PR-Details ein, und erstellen Sie die PR.
Erstellen einer PR aus einem pushed Branch
Nachdem Sie einen Featurezweig pushen oder aktualisieren, zeigt Azure Repos eine Aufforderung zum Erstellen einer PR an.
Auf der Pull-Anforderungsseite :
Auf der Seite "Dateien"
Wählen Sie eine Pullanfrage erstellen aus, um zu einer Seite zu wechseln, auf der Sie Ihre PR-Details eingeben und die PR erstellen können.
Nachdem Sie einen Featurezweig pushen oder aktualisieren, fordert Azure Repos Sie auf, eine PR in der Codeansicht im Web zu erstellen. Diese Aufforderung wird auf Pull-Anforderungen und -Dateien angezeigt.
Wählen Sie eine Pullanfrage erstellen aus, um zu einer Seite zu wechseln, auf der Sie Ihre PR-Details eingeben und die PR erstellen können.
Erstellen einer PR aus einem verknüpften Arbeitselement
Sie können eine PR direkt aus einem Azure Boards Arbeitselement erstellen, das mit dem Zweig verknüpft ist.
Öffnen Sie in Azure Boards aus Backlogs oder Abfragen in der Arbeitsansicht ein Arbeitselement, das mit dem Zweig verknüpft ist.
Wählen Sie im Bereich " Entwicklung " des Arbeitselements eine Pullanforderung erstellen aus.
Der Link führt Sie zu einer Seite, auf der Sie Ihre PR-Details eingeben und die PR erstellen können.
Hinzufügen von Updates mit Kirschauswahl
Sie können Commits von einer Verzweigung in eine andere kopieren, indem Sie die Kirschauswahl verwenden. Im Gegensatz zu einer Zusammenführung oder Neubasis bringt cherry-pick nur die Änderungen aus den von Ihnen ausgewählten Commits anstelle aller Änderungen in einer Verzweigung.
Wenn Sie Änderungen aus einer abgeschlossenen PR auswählen möchten, wählen Sie auf der Seite "Übersicht" der PR-Datei "Cherry-Pick" aus. Um Änderungen aus einer aktiven PR zu kopieren, wählen Sie " Kirschauswahl " im Menü " Weitere Optionen " aus. Diese Aktion erstellt eine neue Verzweigung mit den kopierten Änderungen. Anschließend können Sie eine neue PR aus der neuen Verzweigung erstellen. Ausführliche Anweisungen finden Sie unter "Kopieren von Änderungen mit Kirschauswahl".
Wechseln von Quell- und Zielzweigen Ihrer Pullanforderung
Bevor Sie zum ersten Mal eine PR speichern, können Sie die Quell- und Zielzweige der PR wechseln, indem Sie das Symbol "Quelle" und "Zielzweige " neben den Verzweigungsnamen auswählen. Sobald die PR aktiv ist, geht dieses Symbol weg, aber Sie können den Zielzweig der PR immer noch ändern.
Verwenden von Pullanforderungsvorlagen
Eine Pullanforderungsvorlage ist eine Datei mit Markdown-Text, die die PR-Beschreibung auffüllt, wenn Sie eine PR erstellen. Gute PR-Beschreibungen teilen PR-Prüfern mit, was sie erwarten müssen, und können Aufgaben nachverfolgen, z. B. das Hinzufügen von Komponententests und die Aktualisierung der Dokumentation. Ihr Team kann eine Standard-PR-Vorlage erstellen, die allen neuen PR-Beschreibungen im Repo Text hinzufügt. Außerdem können Sie aus verzweigten Vorlagen oder anderen Vorlagen auswählen, die Ihr Team definiert. Weitere Informationen zum Erstellen und Verwenden von PR-Vorlagen finden Sie unter Verbessern von Pullanforderungsbeschreibungen mithilfe von Vorlagen.
Wenn Ihr Repo über eine Standardvorlage verfügt, verfügen alle PRs im Repo über den Beschreibungstext der Standardvorlage beim Erstellen. Wenn Sie andere Vorlagen hinzufügen möchten, wählen Sie " Vorlage hinzufügen" aus, und wählen Sie dann eine Vorlage aus der Dropdownliste aus. Sie können den Vorlagentext in Ihrer Beschreibung bearbeiten, entfernen oder anderen Text hinzufügen.
Erstellen von Entwurfs-PRs
Wenn Ihre PR nicht zur Überprüfung bereit ist, können Sie einen Pr-Entwurf erstellen, um die Arbeit anzuzeigen. Wenn die PR zur Überprüfung bereit ist, können Sie sie veröffentlichen und den vollständigen Überprüfungsprozess beginnen oder fortsetzen.
Entwurfs-PRs weisen die folgenden Unterschiede von veröffentlichten PRs auf:
Buildüberprüfungsrichtlinien werden nicht automatisch ausgeführt. Sie können Überprüfungen manuell in die Warteschlange stellen, indem Sie das Menü "Weitere Optionen" in der PR auswählen.
Die Abstimmung ist im Entwurfsmodus deaktiviert.
Erforderliche Prüfer werden nicht automatisch hinzugefügt. Benachrichtigungen werden nur an Prüfer gesendet, die Sie explizit zum Entwurf der PR hinzufügen.
Entwurfs-PRs werden in der PR-Liste mit einem Entwurfssignal angezeigt.
Hinweis
Das Erstellen von Entwurfs-PRs erfordert Azure DevOps Server Update 2019.1 oder höher.
Wenn Sie einen Entwurf pr erstellen möchten, wählen Sie den Pfeil neben "Erstellen" aus, und wählen Sie beim Erstellen der PR als Entwurf aus. Sie müssen keine Titelpräfixe wie WIP oder DO NOT MERGE verwenden.
Wenn Sie bereit sind, die PR überprüft und abgeschlossen zu haben , wählen Sie oben rechts in der PR veröffentlichen aus. Das Veröffentlichen einer PR weist erforderliche Prüfer zu, wertet Richtlinien aus und startet abstimmungen.
Wenn Sie eine vorhandene veröffentlichte PR in einen Entwurf ändern möchten, wählen Sie "Als Entwurf markieren" aus. Wenn Sie eine PR als Entwurf markieren, werden alle vorhandenen Stimmen entfernt.
Hinweis
Dieses Feature erfordert Azure DevOps Server Version 2019.1 oder höher.
Titel und Beschreibung der Pullanforderung hinzufügen oder bearbeiten
Geben Sie auf der Seite "Neue Pullanforderung " einen Titel und eine detaillierte Beschreibung Ihrer Änderungen ein, damit andere sehen können, welche Probleme die Änderungen lösen. Auf einer neuen PR wie in vorhandenen PRs können Sie die Dateien und Commits in Ihrer PR auf separaten Registerkarten sehen. Sie können Prüfer hinzufügen, Arbeitselemente verknüpfen und der PR Tags hinzufügen.
Wenn Sie bereit sind, Ihre Änderungen zu überprüfen, wählen Sie "Erstellen" aus, um die PR zu erstellen.
Machen Sie sich keine Sorgen, wenn Sie nicht über alle Arbeitsaufgaben, Prüfer oder Details verfügen, wenn Sie Ihre PR erstellen. Sie können diese Elemente nach dem Erstellen der PR hinzufügen oder aktualisieren.
PR-Titel und Beschreibung bearbeiten
Halten Sie den PR-Titel und die Beschreibung auf dem neuesten Stand, damit Prüfer die Änderungen in der PR verstehen können.
Sie können den Titel einer vorhandenen PR aktualisieren, indem Sie den aktuellen Titel auswählen und den Text aktualisieren. Wählen Sie das Symbol "Speichern " aus, um Änderungen zu speichern, oder wählen Sie das Symbol "Rückgängig ", um die Änderungen zu verwerfen.
Bearbeiten Sie die PR-Beschreibung, indem Sie das Symbol "Bearbeiten" im Abschnitt "Beschreibung " auswählen.
Hinzufügen von Prüfern zu einer Pullanforderung
Sie können Prüfer im Abschnitt "Prüfer" einer neuen oder vorhandenen PR hinzufügen. Sie können auch vorhandene optionale Prüfer erforderlich machen oder erforderliche Prüfer auf optional oder entfernen, es sei denn, sie sind von der Richtlinie erforderlich.
Zweigrichtlinien können mindestens eine Anzahl von Prüfern erfordern oder bestimmte optionale oder erforderliche Prüfer in PRs automatisch einschließen. Sie können Prüfer, die von der Zweigrichtlinie erforderlich sind, nicht entfernen. Sie können optionale Prüfer für die Zweigrichtlinie ändern, um erforderlich zu sein, oder sie entfernen.
Um die Verzweigungsrichtlinie anzuzeigen, die automatisch einen Prüfer hinzugefügt hat, klicken Sie im Abschnitt " Prüfer " auf der Seite " PR-Übersicht " mit der rechten Maustaste auf "Weitere Optionen " neben dem Prüfer.
Wenn der Benutzer oder die Gruppe, die Sie überprüfen möchten, kein Mitglied Ihres Projekts ist, müssen Sie sie dem Projekt hinzufügen , bevor Sie sie als Prüfer hinzufügen können.
So fügen Sie Prüfer zu einer neuen PR hinzu:
- Wählen Sie auf der Seite "Neue Pullanforderung" unter "Prüfer" die Option "Benutzer und Gruppen durchsuchen" aus, die als Prüfer hinzugefügt werden sollen.
- Während Sie einen Namen oder eine E-Mail-Adresse eingeben, zeigt eine Dropdownliste eine Liste der übereinstimmenden Benutzer und Gruppen an. Wählen Sie Namen aus der Liste aus, die als optionale Prüfer hinzugefügt werden sollen.
- Wenn Sie erforderliche Prüfer hinzufügen möchten, wählen Sie "Erforderliche Prüfer hinzufügen" aus, und wählen Sie dann "Suchen" aus, um erforderliche Prüfer zu suchen und die Namen auszuwählen.
So fügen Sie Prüfern zu einer vorhandenen PR hinzu:
Wählen Sie im Abschnitt "Prüfer" auf der Seite "Übersicht " die Option "Hinzufügen" aus, und wählen Sie dann "Erforderlicher Prüfer " oder "Optionaler Prüfer" aus.
Wenn Sie einen Namen oder eine E-Mail-Adresse eingeben, wird eine Liste der übereinstimmenden Benutzer oder Gruppen angezeigt. Wählen Sie die Namen aus, die als Prüfer hinzugefügt werden sollen.
Wenn Sie einen Prüfer zwischen erforderlich und optional ändern oder einen Prüfer entfernen möchten, wählen Sie "Weitere Optionen " rechts neben dem Prüfernamen aus. Um die Mitgliedschaft einer Gruppe oder eines Teams anzuzeigen, das als Prüfer bezeichnet wird, wählen Sie das Symbol der Gruppe aus.
So fügen Sie Ihrer PR Prüfer hinzu:
Wählen Sie die Registerkarte "Übersicht " in der PR aus.
Wählen Sie die Schaltfläche "Hinzufügen" im Bereich "Prüfer" aus.
Geben Sie den Namen des Benutzers oder der Gruppe ein, um der Prüferliste für die PR hinzuzufügen. Wenn der Benutzer kein Mitglied Ihres Projekts ist, müssen Sie sie hinzufügen.
Wenn Sie einen Namen oder eine E-Mail-Adresse eingeben, wird eine Liste der übereinstimmenden Benutzer oder Gruppen angezeigt. Wählen Sie den Benutzer oder die Gruppe aus der Liste aus, um sie als Prüfer hinzuzufügen.
Verknüpfen von Arbeitselementen zu einer Pullanforderung
So verknüpfen Sie Arbeitselemente mit einer neuen PR:
- Wählen Sie auf der Seite "Neue Pullanforderung" unter " Arbeitselemente zum Verknüpfen" die Option " Arbeitselemente nach ID oder Titel durchsuchen" aus.
- Beginnen Sie mit der Eingabe einer Arbeitselement-ID oder eines Titels, und wählen Sie das Arbeitselement aus der Dropdownliste aus, die angezeigt wird.
So verknüpfen Sie Arbeitselemente mit einer vorhandenen PR:
Wählen Sie auf der Registerkarte "PR-Übersicht " im Bereich "Arbeitselemente " die Option +".
Geben Sie die ID des Arbeitselements ein, oder suchen Sie nach dem Arbeitselementtitel. Wählen Sie das Arbeitselement aus der Liste aus, die angezeigt wird.
Entfernen Sie einen Arbeitselementlink, indem Sie das x-Symbol neben dem Arbeitselement auswählen. Das Entfernen eines Links entfernt nur den Link zwischen dem Arbeitselement und der PR. Links, die in der Verzweigung oder aus Commits erstellt wurden, bleiben im Arbeitselement.
So verknüpfen Sie Arbeitselemente mit Ihrer PR:
Wählen Sie die Registerkarte "Übersicht " in der PR aus.
Wählen Sie die Schaltfläche "Hinzufügen" im Bereich "Arbeitselemente " aus.
Geben Sie die ID des Arbeitselements ein, oder suchen Sie nach Arbeitselementen mit Titeln, die Ihrem Text entsprechen. Wählen Sie das Arbeitselement aus der Liste aus, die angezeigt wird.
Entfernen Sie Arbeitselementlinks, indem Sie die Schaltfläche "Entfernen" auswählen, die angezeigt wird, wenn Sie auf das Arbeitselement zeigen. 
Das Entfernen eines Links entfernt nur den Link zwischen einem Arbeitselement zu einer PR. Links, die in der Verzweigung erstellt wurden, oder von Commits bleiben im Arbeitselement.
So verknüpfen Sie Arbeitselemente mit Ihrer PR:
Wählen Sie "Übersicht " in der PR aus.
Wählen Sie die Schaltfläche "Hinzufügen" im Bereich "Arbeitselemente " aus.
Geben Sie die ID des Arbeitselements ein, oder suchen Sie nach Arbeitselementen mit Titeln, die Ihrem Text entsprechen. Wählen Sie das Arbeitselement aus der Liste aus, die angezeigt wird.
Entfernen Sie Arbeitselementlinks, indem Sie die Schaltfläche "Entfernen" auswählen, die angezeigt wird, wenn Sie auf das Arbeitselement zeigen. Das Entfernen eines Links entfernt nur den Link zwischen dem Arbeitselement und der PR. Links, die in der Verzweigung erstellt wurden, oder von Commits bleiben im Arbeitselement.
Hinzufügen von Tags zu einer Pullanforderung
Verwenden Sie Tags, um wichtige Details anzuzeigen und PRs zu organisieren. Tags können zusätzliche Informationen an Prüfer kommunizieren, z. B. dass die PR noch in Bearbeitung ist oder ein Hotfix für eine bevorstehende Version ist.
Wenn Sie beim Erstellen einer PR ein Tag hinzufügen möchten, geben Sie im Abschnitt "Tags " einen Tagnamen ein. Nachdem Sie die PR erstellt haben, können Sie Tags im Abschnitt "Tags " verwalten.
Hinzufügen von Bezeichnungen zu einer Pullanforderung
Sie können zusätzliche Informationen zu einer PR an die Prüfer übermitteln, indem Sie Bezeichnungen verwenden. Vielleicht ist die PR noch in Bearbeitung, oder es ist ein Hotfix für eine bevorstehende Version. Verwenden Sie Bezeichnungen, um wichtige Details zu kommunizieren und PRs zu organisieren.
Hinweis
Die Verwendung von PR-Bezeichnungen erfordert TFS 2018.2 oder höher.
Wenn Sie beim Erstellen einer PR eine Bezeichnung hinzufügen möchten, wählen Sie "Bezeichnung hinzufügen" aus. Nachdem Sie eine PR erstellt haben, können Sie die Bezeichnungen im Abschnitt "Bezeichnungen " verwalten.
Hinzufügen von Anlagen zu Pullanforderungen
Sie können Dateien, einschließlich Bildern, während oder nach der Erstellung an Ihre PR anfügen. Wählen Sie das Papierausschnittsymbol unterhalb des Felds "Beschreibung " aus, oder ziehen Sie Dateien direkt in das Feld "Beschreibung " der PR.
Ändern der Zielzweige einer aktiven Pullanforderung
Für die meisten Teams zielen fast alle PRs auf einen Standardzweig, z. B main . oder develop. Wenn Sie manchmal auf eine andere Verzweigung abzielen müssen, ist es einfach zu vergessen, die Zielzweige zu ändern, wenn Sie die PR erstellen. In diesem Fall können Sie den Zielzweig einer aktiven PR ändern:
- Wählen Sie oben rechts auf der SEITE "PR-Übersicht" weitere Aktionen aus, und wählen Sie dann im Dropdownmenü "Zielverzweigung ändern" aus.
- Wählen Sie im Bereich "Zielzweig ändern" die Option "Zielzweig auswählen" aus, wählen Sie die neue Verzweigung aus, und wählen Sie dann "Ändern" aus.
E-Mail-Pullanforderungsbenachrichtigungen an Projektbeteiligte
Sie können eine Pullanfrage per E-Mail freigeben, um Prüfer zu benachrichtigen und mit Teammitgliedern zu kommunizieren. So teilen Sie eine PR:
Wählen Sie auf der Seite "PR-Übersicht" weitere Optionen aus, und wählen Sie dann "Pullanforderung freigeben" aus.
Fügen Sie auf dem Bildschirm " Freigabe-Pullanforderung " Empfänger hinzu, indem Sie ihre Namen im Feld "An:" eingeben und aus den angezeigten Benutzernamen auswählen. Sie können auch Empfänger entfernen.
Fügen Sie eine optionale Nachricht im Feld "Hinweis" (Optional) hinzu, und wählen Sie dann "Senden" aus. Empfänger erhalten eine E-Mail, die ihre Aufmerksamkeit anfordert und mit der PR verknüpft.
Hinweis
Wenn Sie das integrierte E-Mail-Feature verwenden, können Sie die E-Mail nur an die einzelnen Adressen der Projektmitglieder senden. Das Hinzufügen einer Teamgruppe oder Sicherheitsgruppe zur Zeile "An:" wird nicht unterstützt. Wenn Sie ein E-Mail-Konto hinzufügen, das das System nicht erkennt, erhalten Sie eine Nachricht, dass mindestens ein Empfänger Ihrer E-Mail nicht über Berechtigungen zum Lesen der E-Mail-Pullanforderung verfügt.
Damit das E-Mail-Feature funktioniert, muss Ihr Administrator für Azure DevOps Server einen SMTP-Server konfigurieren.