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
Visual Studio 2019 | Visual Studio 2022
Erstellen Sie Pullanforderungen (PRs), um Code in einem Git-Repositoryzu ändern, zu überprüfen und zusammenzuführen. Sie können PRs aus Branches im Upstream-Repository oder aus Branches in Ihrem Fork des Repositorys erstellen. Ihr Team kann die PRs überprüfen und Feedback zu Änderungen geben. Reviewer können sich die vorgeschlagenen Änderungen Schritt für Schritt ansehen, Kommentare hinterlassen und die PRs genehmigen oder ablehnen. Je nach Branchrichtlinien und anderen Anforderungen muss Ihr PR möglicherweise verschiedene Kriterien erfüllen, bevor Sie den PR abschließen und die Änderungen im Zielbranch zusammenführen können.
Informationen zu PR-Richtlinien und Verwaltungsaspekte finden Sie unter Informationen zu Pull Requests.
Voraussetzungen
| Kategorie | Anforderungen |
|---|---|
| Zugriffsebenen | - Anzeigen oder Überprüfen von PRs: Mindestens einfacher Zugriff. Für öffentliche Projekte haben Benutzer den Vollzugriff auf Azure Repos. |
| Erlaubnisse | - Tragen Sie zu einer PR bei: Mitglied der Sicherheitsgruppe "Leser" oder entsprechende Berechtigungen. – Erstellen und Abschließen einer PR: Mitglied der Sicherheitsgruppe "Mitwirkende " oder entsprechende Berechtigungen. |
| Dienste | Repos aktiviert. |
| Werkzeuge | Azure DevOps CLI. |
| Kategorie | Anforderungen |
|---|---|
| Zugriffsebenen | - Anzeigen oder Überprüfen von PRs: Mindestens einfacher Zugriff. |
| Erlaubnisse | - Tragen Sie zu einer PR bei: Mitglied der Sicherheitsgruppe "Leser" oder entsprechende Berechtigungen. – Erstellen und Abschließen einer PR: Mitglied der Sicherheitsgruppe "Mitwirkende " oder entsprechende Berechtigungen. |
| Dienste | Repos aktiviert. |
Weitere Informationen zu Berechtigungen und Zugriff finden Sie unter Standardmäßige Git-Repository- und Branch-Berechtigungen und Informationen zu Zugriffsebenen.
Pull-Request erstellen
Sie können eine neue PR auf der Azure DevOps-Projektwebsite, in Visual Studio oder über die Azure DevOps CLI erstellen.
Auf der Azure DevOps-Projektwebsite können Sie aus Folgendem einen neuen PR erstellen:
- Seite „Pull Requests“.
- In Ihr Repository gepushter Featurebranch.
- Vorhandener PR mithilfe von Cherry-Pick.
- Entwicklungssteuerelement in einem verknüpften Azure Boards-Arbeitselement.
Erstellen eines PR über die Seite „Pull Requests“
Sie können PRs für jeden Branch über die Seite Pull Requests Ihres Projekts im Web erstellen.
Wählen Sie auf der Seite Repos>Pull Requests oben rechts die Option Neuer Pull Request aus.
Wählen Sie den Branch mit den Änderungen und den Branch aus, in den Sie die Änderungen zusammenführen möchten, z. B. den Hauptbranch.
Geben Sie Ihre PR-Details ein, und erstellen Sie den PR.
Erstellen eines PR aus einem gepushten Branch
Nachdem Sie einen Featurebranch per Push übertragen oder aktualisiert haben, zeigt Azure Repos eine Aufforderung zum Erstellen eines PR an.
Auf der Seite Pull Requests:
Auf der Seite Dateien:
Wählen Sie Pull Request erstellen aus, um zu einer Seite zu wechseln, auf der Sie Ihre PR-Details eingeben und den PR erstellen können.
Erstellen eines PR aus einem verknüpften Arbeitselement
Sie können einen PR direkt aus einem Azure Boards-Arbeitselement erstellen, das mit dem Branch verknüpft ist.
Öffnen Sie in Azure Boards aus "Backlogs " oder "Abfragen " in der Arbeitsansicht eine Arbeitsaufgabe, die mit der Verzweigung verknüpft ist.
Wählen Sie im Bereich Entwicklung des Arbeitselements Pull Request erstellen aus.
Über den Link gelangen Sie zu einer Seite, auf der Sie Ihre PR-Details eingeben und den PR erstellen können.
Hinzufügen von Updates mit Cherry-Pick
Sie können Commits mit der Option „Cherry-Pick“ von einem Branch in einen anderen kopieren. Im Gegensatz zum Zusammenführen oder zur Ausführung eines Rebase werden beim Cherry-Picking nur die Änderungen aus den Commits übernommen, die Sie auswählen, anstatt alle Änderungen in einem Branch.
Wenn Sie Änderungen aus einem abgeschlossenen PR auswählen möchten, wählen Sie Cherry-Pick auf der Übersichtsseite des PR aus. Wählen Sie zum Kopieren von Änderungen aus einem aktiven PR im Menü Weitere Optionen des PR die Option Cherry-Pick aus. Durch diese Aktion wird ein neuer Branch mit den kopierten Änderungen erstellt. Anschließend können Sie einen neuen PR aus dem neuen Branch erstellen. Ausführliche Anweisungen finden Sie unter Kopieren von Änderungen mit Cherry-Pick.
Wechseln von Quell- und Zielbranches Ihres Pull Requests
Bevor Sie einen PR zum ersten Mal speichern, können Sie die Quell- und Zielbranches des PR wechseln, indem Sie das Symbol Quell- und Zielbranches wechseln neben den Branchnamen auswählen. Sobald der PR aktiv ist, wird dieses Symbol ausgeblendet, aber Sie können weiterhin den Zielbranch des PR ändern.
Verwenden von Pull Request-Vorlagen
Eine Pull Request-Vorlage ist eine Datei mit Markdowntext, der in die PR-Beschreibung eingegeben wird, wenn Sie einen PR erstellen. Gute PR-Beschreibungen informieren PR-Reviewer darüber, was sie erwarten können, und können dabei helfen, Aufgaben wie das Hinzufügen von Unittests und die Aktualisierung der Dokumentation nachzuverfolgen. Ihr Team kann eine Pr-Standardvorlage erstellen, die allen neuen PR-Beschreibungen im Repository Text hinzufügt. Darüber hinaus können Sie aus bereichsspezifischen oder anderen von Ihrem Team definierten Vorlagen auswählen. Weitere Informationen zum Erstellen und Verwenden von PR-Vorlagen finden Sie unter Verbessern Sie Pull-Request-Beschreibungen mit Vorlagen.
Wenn Ihr Repository über eine Standardvorlage verfügt, verfügen alle PRs im Repository bei der Erstellung über den Beschreibungstext der Standardvorlage. Um andere Vorlagen hinzuzufügen, wählen Sie Eine Vorlage hinzufügen und wählen dann eine Vorlage aus der Dropdown-Liste aus. Sie können den Vorlagentext in Ihrer Beschreibung bearbeiten, ihn entfernen oder anderen Text hinzufügen.
Erstellen von PRs-Entwürfen
Wenn Ihre PR nicht zur Überprüfung bereit ist, können Sie einen Pr-Entwurf erstellen, um die laufende Arbeit anzuzeigen. Wenn der PR für den Review bereit ist, können Sie ihn veröffentlichen und den vollständigen Reviewprozess starten oder fortsetzen.
PR-Entwürfe unterscheiden sich wie folgt von veröffentlichten PRs:
Build-Validierungsrichtlinien werden nicht automatisch ausgeführt. Sie können Buildvalidierungen manuell in die Warteschlange stellen, indem Sie im PR das Menü „Weitere Optionen“ auswählen.
Die Abstimmung ist im Entwurfsmodus deaktiviert.
Erforderliche Prüfer werden nicht automatisch hinzugefügt. Benachrichtigungen werden nur an Reviewer gesendet, die Sie dem PR-Entwurf explizit hinzufügen.
PR-Entwürfe werden in der PR-Liste mit einem Entwurfs-Badge angezeigt.
Um einen PR-Entwurf zu erstellen, wählen Sie den Pfeil neben Erstellen aus, und wählen Sie beim Erstellen des PR AEntwurf erstellen aus. Sie müssen keine Titelpräfixe wie WIP oder DO NOT MERGE.
Wenn Sie bereit sind, den PR überprüfen zu lassen und ihn abzuschließen, wählen Sie oben rechts in dem PR Veröffentlichen aus. Durch die Veröffentlichung eines PR werden erforderliche Reviewer zugewiesen, Richtlinien ausgewertet und die Abstimmung gestartet.
Um einen vorhandenen veröffentlichten PR in einen Entwurf zu ändern, wählen Sie Als Entwurf markieren aus. Wenn Sie einen PR als Entwurf markieren, werden alle vorhandenen Stimmen entfernt.
Titel und Beschreibung der Pullanforderung hinzufügen oder bearbeiten
Geben Sie auf der Seite Neuer Pull Request einen Titel und eine ausführliche Beschreibung Ihrer Änderungen ein, damit andere sehen können, welche Probleme mit den Änderungen gelöst werden. Sowohl bei einem neuen PR als auch bei vorhandenen PRs werden die Dateien und Commits in Ihrem PR auf separaten Registerkarten angezeigt. Sie können Reviewer hinzufügen, Arbeitselemente verknüpfen und Tags zum PR hinzufügen.
Wenn Ihre Änderungen für den Review bereit sind, wählen Sie Erstellen aus, um den PR zu erstellen.
Machen Sie sich keine Sorgen, wenn Sie beim Erstellen Ihres PR nicht über alle Arbeitselemente, Reviewer oder Details verfügen. Sie können diese Elemente hinzufügen oder aktualisieren, nachdem Sie den PR erstellt haben.
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 klicken Sie auf das Symbol Rückgängig, um die Änderungen zu verwerfen.
Bearbeiten Sie die PR-Beschreibung, indem Sie im Abschnitt Beschreibung auf das Symbol Bearbeiten klicken.
Hinzufügen von Prüfern zu einem Pull Request
Sie können Reviewer im Abschnitt Reviewer eines neuen oder vorhandenen PR hinzufügen. Sie können optionale Prüfer auch auf erforderlich ändern, erforderliche Prüfer auf optional ändern oder entfernen, es sei denn, sie sind von der Richtlinie erforderlich.
Branch-Richtlinien können mindestens eine Anzahl von Prüfern erfordern oder bestimmte optionale oder erforderliche Prüfer automatisch in PRs einschließen. Sie können prüfer, die von der Verzweigungsrichtlinie benötigt werden, nicht entfernen, aber Sie können optionale Prüfer so ändern, dass sie erforderlich sind oder entfernt werden.
Um die Verzweigungsrichtlinie anzuzeigen, die automatisch einen Bearbeiter hinzugefügt hat, wählen Sie rechts neben dem Bearbeiter im Abschnitt "Prüfer" der Seite "PR-Übersicht" weitere Optionen aus.
Wenn der Benutzer oder die Gruppe, den Bzw. die Sie überprüfen möchten, kein Mitglied Ihres Projekts ist, fügen Sie sie dem Projekt hinzu , bevor Sie sie als Prüfer hinzufügen können.
Führen Sie die folgenden Schritte aus, um Prüfer zu einer neuen PR hinzuzufügen:
- Wählen Sie auf der Seite Neuer Pull Request unter Reviewer die Option Benutzer und Gruppen suchen, die als Reviewer hinzugefügt werden sollen aus.
- 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 Rezensenten hinzugefügt werden sollen.
- Um erforderliche Reviewer hinzuzufügen, wählen Sie Erforderliche Reviewer hinzufügen und dann Suchen, um erforderliche Reviewer hinzuzufügen aus, um nach den Namen zu suchen und sie auszuwählen.
Führen Sie die folgenden Schritte aus, um Prüfer zu einer vorhandenen PR hinzuzufügen:
Wählen Sie im Abschnitt Reviewer auf der Seite Übersicht die Option Hinzufügen und dann Erforderlicher Reviewer oder Optionaler Reviewer aus.
Pull-Request-Übersicht
Während 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 Reviewer hinzugefügt werden sollen.
Wenn Sie einen Bearbeiter zwischen erforderlich und optional ändern oder einen Bearbeiter entfernen möchten, wählen Sie rechts neben dem Namen des Bearbeiters weitere Optionen (⋮) aus. Um die Mitgliedschaft einer Gruppe oder eines Teams anzuzeigen, die als Bearbeiter festgelegt wurde, wählen Sie das Symbol der Gruppe aus.
Verknüpfen von Arbeitselementen mit einem Pull-Request
Führen Sie die folgenden Schritte aus, um Arbeitsaufgaben mit einer neuen PR zu verknüpfen:
- Wählen Sie auf der Seite Neuer Pull Request unter Zu verknüpfende Arbeitselemente die Option Arbeitselemente nach ID oder Titel durchsuchen aus.
- Beginnen Sie mit der Eingabe einer Arbeitsaufgaben-ID oder eines Titels, und wählen Sie die Arbeitsaufgabe aus, die aus der angezeigten Dropdownliste verknüpft werden soll.
- Suche nach Titel gibt Arbeitsaufgaben zurück, die nach Status gefiltert sind; Alle Arbeitsaufgaben, die als "Abgeschlossen" und "Entfernt " kategorisiert sind, werden ausgeschlossen.
- Diese Arbeitsaufgaben werden auch nach Datum und Benutzer gefiltert, wobei nur Elemente angezeigt werden, die in den letzten 30 Tagen erstellt oder aktualisiert wurden. Sie sollten von dem aktuellen Benutzer erstellt, zugewiesen oder autorisiert werden.
Führen Sie die folgenden Schritte aus, um Arbeitsaufgaben mit einer vorhandenen PR zu verknüpfen:
Wählen Sie auf der PR-Registerkarte Übersicht im Bereich Arbeitselemente die Option + aus.
Geben Sie die ID der Arbeitsaufgabe ein, oder suchen Sie nach dem Arbeitsaufgabentitel. Wählen Sie die Arbeitsaufgabe aus der angezeigten Liste aus.
Entfernen Sie einen Link zu einem Arbeitselement, indem Sie das Symbol x neben dem Arbeitselement auswählen. Wenn Sie einen Link entfernen, wird nur der Link zwischen dem Arbeitselement und dem PR entfernt. Links, die im Branch oder aus Commits erstellt wurden, bleiben im Arbeitselement erhalten.
Tags zu einem Pull Request hinzufügen
Verwenden Sie Tags, um wichtige Details hervorzuheben und PRs besser zu organisieren. Tags können zusätzliche Informationen an Reviewer übermitteln, wie z. B. dass der PR noch in Bearbeitung ist oder dass er ein Hotfix für ein bevorstehendes Release ist.
Um beim Erstellen eines PR ein Tag hinzuzufügen, geben Sie im Abschnitt Tags einen Tagnamen ein. Nachdem Sie den PR erstellt haben, können Sie Tags im Abschnitt Tags verwalten.
Hinzufügen von Anlagen zu Pull Requests
Sie können während oder nach der Erstellung Dateien, einschließlich Bildern, an Ihren PR anfügen. Wählen Sie das Büroklammersymbol unter dem Feld Beschreibung aus, oder ziehen Sie Dateien direkt in das Feld Beschreibung des PR.
Ändern des Zielbranchs eines aktiven Pull Requests
Bei den meisten Teams zielen fast alle PRs auf einen Standardbranch ab, z. B. main oder develop. Wenn Sie zuweilen einen anderen Branch als Ziel verwenden müssen, kann es beim Erstellen des PR leicht passieren, dass Sie vergessen, den Zielbranch zu ändern. In diesem Fall können Sie den Zielzweig einer aktiven PR ändern:
- Wählen Sie oben rechts auf der PR-Seite Übersicht die Option Weitere Aktionen und dann im Dropdownmenü Zielbranch ändern aus.
- Wählen Sie im Bereich Zielbranch ändern die Option Zielbranch auswählen, dann den neuen Branch und dann Ändern aus.
Senden von E-Mail-Pull-Anforderungsbenachrichtigungen an Projektbeteiligte
Sie können eine Pull-Anforderung per E-Mail freigeben, um Prüfer zu benachrichtigen und mit Teammitgliedern zu kommunizieren. So geben Sie einen PR frei:
Wählen Sie auf der PR-Seite Übersicht die Option Weitere Optionen und dann Pull Request freigeben aus.
Fügen Sie auf dem Bildschirm Pull Request freigeben Empfänger hinzu, indem Sie ihre Namen in das Feld An: eingeben und aus den angezeigten Benutzernamen einen Namen auswählen. Sie können auch Empfänger entfernen.
Fügen Sie dem Feld Notiz (Optional) eine optionale Nachricht hinzu, und wählen Sie dann Senden aus. Empfänger erhalten eine E-Mail, die um ihre Aufmerksamkeit bittet und einen Link zur PR enthält.
Anmerkung
Wenn Sie das integrierte E-Mail-Feature verwenden, können Sie nur E-Mails an die Adressen einzelner Projektmitglieder senden. Das Hinzufügen einer Team- oder Sicherheitsgruppe zur Zeile An: wird nicht unterstützt. Wenn Sie eine nicht erkannte E-Mail-Adresse hinzufügen, erhalten Sie eine Nachricht, die angibt, dass mindestens ein Empfänger nicht über berechtigungen zum Lesen der E-Mail-Pullanforderung verfügt.
Damit das E-Mail-Feature funktioniert, muss Ihr Administrator einen SMTP-Server konfigurieren.