Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Sie erstellen Pull Requests (PRs), um Codeänderungen in einem Git-Repository in Azure Reposzu überprüfen und zusammenzuführen. Teammitglieder und Projektbeteiligte können Änderungen überprüfen und Feedback geben, bevor sie den Code in den Zielbranch zusammenführen. Reviewer können zudem Änderungen kommentieren und abstimmen, um den Code zu genehmigen oder abzulehnen.
Teams können PRs für alle Änderungen an geschützten Branches anfordern und Branchrichtlinien so festlegen, dass bestimmte PRs bestimmte Kriterien erfüllen.
Es gibt mehrere Möglichkeiten, PRs für ein Projekt aufzulisten, zu filtern, anzuzeigen und zu öffnen.
Um PRs anzeigen zu können, müssen Sie Mitglied des Azure DevOps-Projekts sein, in dem sich der PR befindet, und über die Zugriffsebene Basic oder höher verfügen. Wenn Sie kein Projektmitglied sind, lassen Sie sich hinzufügen.
Hinweis
Bei öffentlichen Projekten haben Benutzer, denen Beteiligtenzugriff eingeräumt wurde, vollen Zugriff auf Azure Repos.
Um PRs anzuzeigen, müssen Sie Mitglied des Azure DevOps-Projekts mit Zugriff der Ebene Basic oder höher sein. Wenn Sie kein Projektmitglied sind, lassen Sie sich hinzufügen.
Vergewissern Sie sich, dass Sie das richtige Repository ausgewählt haben.
In der Standardansicht werden Ihre PRs auf der Registerkarte Eigene angezeigt. Wählen Sie Aktiv aus, um alle aktiven PRs für das aktuelle Repository anzuzeigen. Wählen Sie Abgeschlossen oder Aufgegeben aus, um Listen mit geschlossenen PRs anzuzeigen.
Wählen Sie einen beliebigen PR aus der Liste aus, um zur Seite Übersicht dieses PRs zu gelangen.
Sie können alle Ihre PRs in verschiedenen Projekten in Ihrer Organisation auflisten, indem Sie in der Ansicht Meine Arbeit die Option Pull Requests auswählen.
Um Pull Requests von Visual Studio aufzulisten, wählen Sie im Menü Git die Option <Ihr Git-Dienst>>Pull Requests anzeigen aus.
Visual Studio 2019, Version 16.8 und höher, bietet eine Benutzeroberfläche für Git-Versionskontrolle, während die Git-Benutzeroberfläche von Team Explorer beibehalten wird. Um Team Explorer zu verwenden, deaktivieren Sie in der Menüleiste Extras>Optionen>Vorschaufeatures>Neue Git-Benutzeroberfläche. Sie können Git-Features über beide Schnittstellen austauschbar verwenden.
So greifen Sie über Visual Studio Team Explorer auf PRs zu:
Azure DevOps-Organisations-URL. Sie können die Standardorganisation mit az devops configure -d organization=<ORG_URL> konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/.
--project-p
Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=<NAME_OR_ID> konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen.
--query-examples
Empfohlene JMESPath-Zeichenfolge. Sie können eine der Abfragen kopieren und hinter dem --query-Parameter in doppelten Anführungszeichen einfügen, um die Ergebnisse anzuzeigen. Sie können ein oder mehrere Positionsschlüsselwörter hinzufügen, damit Vorschläge auf diesen Schlüsselwörtern basieren.
--repository-r
Name oder ID des Repositorys.
--reviewer
Beschränken Sie die Ergebnisse auf Pull Requests, bei denen dieser Benutzer ein Reviewer ist.
--skip
Anzahl der zu überspringenden Pull Requests.
--source-branch-s
Beschränken Sie die Ergebnisse auf Pull Requests, die aus diesem Quellbranch stammen.
--status
Beschränken Sie die Ergebnisse auf Pull Requests mit diesem Status. Zulässige Werte: abandoned, active, all, completed.
--subscription
Name oder ID des Azure-Abonnements. Sie können das Standardabonnement mithilfe von az account set -s <NAME_OR_ID> konfigurieren.
--target-branch-t
Beschränken Sie die Ergebnisse auf Pull Requests, die auf diesen Branch abzielen.
--top
Maximale Anzahl von aufzulistenden Pull Requests.
Beispiel
Mit dem folgenden Befehl werden alle PRs im Repository unabhängig von ihrem Status aufgelistet, die Ausgabe wird in einer Tabelle angezeigt. In dem Beispiel wird die Standardkonfiguration verwendet: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".
az repos pr list --status all --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------------------------- --------- --------- ------------
11 2021-10-04 jamalh@fabrikam.com Revert 'Updated parameterized-functions.md' Completed False Fabrikam
10 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Completed False Fabrikam
9 2021-10-04 ke@fabrikam.com New pull request Completed False Fabrikam
8 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Abandoned False Fabrikam
7 2021-09-30 jamalh@fabrikam.com Added note-new-git-tool.md to / Completed False Fabrikam
6 2021-09-29 jamalh@fabrikam.com Revert 'Added parameterized-functions.md to /' Abandoned False Fabrikam
5 2021-09-29 jamalh@fabrikam.com Updated README.md Completed False Fabrikam
4 2021-09-29 jamalh@fabrikam.com Added parameterized-functions.md to / Completed False Fabrikam
3 2021-09-28 jamalh@fabrikam.com WIP New file Abandoned False Fabrikam
2 2021-09-28 jamalh@fabrikam.com Update README.md Abandoned False Fabrikam
1 2021-09-28 jamalh@fabrikam.com Edit README.md Completed False Fabrikam
Azure DevOps CLI-Befehle werden für Azure DevOps Server lokal nicht unterstützt.
Definieren einer benutzerdefinierten Pull Request-Ansicht
Durch das Filtern der PR-Liste können Sie PRs finden und so organisieren, dass die wichtigsten Dateien in Ihrem Workflow priorisiert werden.
Um die PR-Liste zu filtern, wählen Sie auf der Seite Pull Requests oben rechts das Filtersymbol aus. Wählen Sie dann Zielbranch oder eine andere Spaltenüberschrift aus, und wählen Sie den Branch oder einen anderen Wert aus, nach dem Sie filtern möchten.
Um die Ansicht der PR-Liste weiter anzupassen, wählen Sie rechts oben auf der Seite Pull Requests die Option Ansicht anpassen aus.
Auf der Seite Ansicht anpassen können Sie die aktuellen Ansichtsabschnitte neu anordnen, bearbeiten oder entfernen. Um einen neuen Abschnitt zu erstellen, wählen Sie Abschnitt hinzufügen aus.
Geben Sie auf der Seite Abschnitt anpassen Werte ein, und wählen Sie sie aus, um den Abschnitt nach Parametern wie Entwurfsstatus oder Aktualisierungsdatum zu filtern. Sie können zwischen Von mir genehmigte oder abgelehnte Pull Requests auf einer separaten Registerkarte anzeigen und In vorherigen Abschnitten enthaltene Pull Requests (Duplikate) ausschließen auswählen. Wenn Sie mit der Anpassung der Ansicht fertig sind, wählen Sie Speichern aus.
Mit diesen angepassten Ansichten werden separate, reduzierbare Abschnitte auf der Pull Request-Seite angezeigt. Diese benutzerdefinierten Abfragen funktionieren auch repositoryübergreifend auf der Registerkarte Meine Pull Requests auf der Startseite der Organisation.
Um die Parameter der benutzerdefinierten Ansichten zu ändern, klicken Sie auf die Schaltfläche Anpassen neben der Ansicht. Oder wählen Sie Ansicht anpassen und auf dem Bildschirm Ansicht anpassen die Ansicht aus, die Sie ändern möchten. Einige Ansichten, z. B. Mir zugewiesen", können nicht angepasst werden, aber sie können neu angeordnet oder entfernt werden.
Auf der PR-Registerkarte Dateien können Sie mithilfe mehrerer Filter Dateien und Kommentare für schnellere Reviews auswählen. Wählen Sie Filter aus, und wählen Sie dann eine der Optionen aus.
Schlüsselwort: Geben Sie ein Schlüsselwort ein.
Überprüft/Nicht überprüft: Alle (Standard), Ausstehend, Überprüft.
Kommentierte Dateien: Alle Dateien (Standard), Dateien mit Kommentaren.
Kommentarstatus: Aktiv (Standard), Ausstehend, Behoben, Gemäß Entwurf, Keine Korrektur, Geschlossen.
Kommentiert von: Alle Kommentare (Standard) oder die Kommentare einer bestimmten Person.
Sie können auch eine Zeichenfolge in das Suchfeld eingeben, um übereinstimmende Ergebnisse aus den vorherigen Optionen anzuzeigen.
So filtern Sie Pull Requests aus Visual Studio:
Wählen Sie im Menü Git<Ihren Git-Dienst>>Pull Requests anzeigen aus.
Filtern Sie nach Ersteller, Bezeichnung oder anderen Attributen.
Gehen Sie in der Ansicht Team Explorer Pull Requests wie folgt vor:
Wählen Sie Aktiv oder Mir oder meinem Team zugewiesen aus, um die PR-Listen nach PR-Status oder Zuweisung zu filtern.
Oder geben Sie in die Felder Machen Sie hier eine Eingabe, um die Liste zu filtern Text ein, um die PR-Listen nach Datum, Ersteller, Branch oder anderen Attributen zu filtern.
Sie können mehrere az repos pr list-Parameter verwenden, um die Liste der PRs zu filtern, wie z. B. --creator, --project, --repository, --reviewer, --source-branch, --status, --target-branch und --top.
Die Werte --creator und --reviewer können Anzeigenamen oder E-Mail-Adressen sein. Mit dem Parameter --top wird die maximale Anzahl von PRs definiert, die aufgelistet werden sollen.
Um beispielsweise Details zum letzten PR, den Sie erstellt haben, unabhängig von seinem Status aufzulisten, verwenden Sie Folgendes:
az repos pr list --creator "My Name" --status all --top 1
Azure DevOps CLI-Befehle werden für Azure DevOps Server lokal nicht unterstützt.
Erstellen eines Pull Requests
Wenn Sie einen PR im Browser, in Visual Studio oder über die Azure CLI öffnen, wird die PR-Seite Übersicht im Browser geöffnet.
Um einen PR im Browser zu öffnen, wählen Sie den PR aus der Liste auf der Seite Pull Requests aus. Der PR wird auf der Registerkarte Übersicht geöffnet. Die Registerkarte Übersicht zeigt den PR-Titel, die Beschreibung, die Reviewer, die verknüpften Arbeitselemente, den Verlauf und den Status. Sie können eine Zusammenfassung der Branchrichtlinien, die bestanden wurden oder fehlgeschlagen sind, und die Kommentare, die Reviewer abgegeben haben, anzeigen.
Auf der PR-Registerkarte Dateien können Sie die tatsächlichen Änderungen an den PR-Dateien überprüfen. Auf den Registerkarten Updates und Commits sehen Sie die Änderungen, die der Ersteller vorgenommen hat, um den PR-Branch zu aktualisieren.
Um einen Pull Request von Visual Studio aus zu öffnen, wählen Sie im Menü Git die Option <Ihr Git-Dienst>>Pull Requests anzeigen und dann einen Pull Request aus.
Oder klicken Sie in der Team Explorer-Ansicht Pull Requests mit der rechten Maustaste auf den PR, und wählen Sie Im Browser öffnen aus, um den PR im Webportal zu öffnen.
Auschecken eines Branchs
In Visual Studio 2019 können Sie den Quellbranch eines PR direkt in der Ansicht Pull Requests auschecken. Klicken Sie mit der rechten Maustaste auf einen PR, und wählen Sie Quellbranch auschecken aus.
Hinweis
Visual Studio 2019 Version 16.8 und höhere Versionen bieten ein neues Git-Menü zum Verwalten des Git-Workflows mit weniger Kontextwechseln als Team Explorer. Die in diesem Artikel auf der Registerkarte „Visual Studio“ bereitgestellten Verfahren enthalten Informationen zur Verwendung der Git-Benutzeroberfläche sowie für Team Explorer. Weitere Informationen finden Sie unter Paralleler Vergleich von Git und Team Explorer.
Um die Details für einen einzelnen PR anzuzeigen, verwenden Sie az repos pr show mit dem erforderlichen --id Parameter. Um den PR in Ihrem Browser zu öffnen, verwenden Sie --open.
az repos pr show --id
[--detect {false, true}]
[--open]
[--org]
[--query-examples]
[--subscription]
Azure DevOps-Organisations-URL. Sie können die Standardorganisation mit az devops configure -d organization=<ORG_URL> konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/.
--query-examples
Empfohlene JMESPath-Zeichenfolge. Sie können eine der Abfragen kopieren und hinter dem --query-Parameter in doppelten Anführungszeichen einfügen, um die Ergebnisse anzuzeigen. Sie können ein oder mehrere Positionsschlüsselwörter hinzufügen, damit Vorschläge auf diesen Schlüsselwörtern basieren.
--subscription
Name oder ID des Azure-Abonnements. Sie können das Standardabonnement mithilfe von az account set -s <NAME_OR_ID> konfigurieren.
Beispiel
Das folgende Beispiel zeigt die Details für PR #21, zeigt die Befehlsausgabe als Tabelle an und öffnet den PR im Browser:
az repos pr show --id 21 --open --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------- -------- --------- ------------
21 2021-10-31 jamalh@fabrikam.com Updated note-new-git-tool.md Active False Fabrikam
Auschecken eines Branchs
Verwenden Sie az repos pr checkout mit dem erforderlichen Parameter --id, um einen PR-Branch lokal auszuchecken, solange keine lokalen Änderungen vorhanden sind.
az repos pr checkout --id
[--remote-name]
[--subscription]
Parameter
Parameter
BESCHREIBUNG
--id
ID des Pull Requests.
--remote-name
Name des Git-Remoteservers, für den ein PR ausgelöst wird. Standardwert. origin.
--subscription
Name oder ID des Azure-Abonnements. Sie können das Standardabonnement mithilfe von az account set -s <NAME_OR_ID> konfigurieren.
Beispiel
Um beispielsweise den Branch für PR #21 lokal auszuchecken, verwenden Sie Folgendes:
az repos pr checkout --id 21
Azure DevOps CLI-Befehle werden für Azure DevOps Server lokal nicht unterstützt.
Informationen zum Überprüfen von Änderungen, zum Abgeben von Kommentaren oder Vorschlägen oder zum Genehmigen des oder Abstimmen über den PR finden Sie unter Überprüfen von Pull Requests.
Anzeigen und Aktualisieren von Pull Requests von einem mobilen Gerät
Sie können mobile Geräte verwenden, um alle Azure Repos PR-Bildschirme anzuzeigen und Maßnahmen zu ergreifen.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
