Freigeben über

Pull-Requests erstellen

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

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

  • Zugriff:
    • Einfacher Zugriff: Um PRs anzuzeigen oder zu überprüfen, müssen Sie Mitglied eines Azure DevOps-Projekts mit mindestens grundlegendem Zugriff sein.
    • Stakeholder-Zugriff: Für öffentliche Projekte haben Benutzer, denen Stakeholder-Zugriff gewährt wurde, vollen Zugriff auf Azure Repos.
  • Berechtigungen:
    • Aktivierung von Repos: Repos muss für Ihr Projekt aktiviert sein. Wenn der Repos-Hub und die zugehörigen Seiten nicht angezeigt werden, lesen Sie Aktivieren oder Deaktivieren eines Azure DevOps-Diensts, um Repos erneut zu aktivieren.
    • Projektmitgliedschaft:
      • Wenn Sie kein Projekt haben, erstellen Sie eines oder melden Sie sich kostenlos an.
      • Wenn Sie kein Projektmitglied sind, lassen Sie sich hinzufügen.
    • Sicherheitsgruppe „Leser“: Um zu einem PR beizutragen, müssen Sie Mitglied der Sicherheitsgruppe „Leser“ sein oder über die entsprechenden Berechtigungen verfügen.
    • Sicherheitsgruppe "Mitwirkende": Um eine PR zu erstellen und abzuschließen, müssen Sie Mitglied der Sicherheitsgruppe "Mitwirkende" sein oder über die entsprechenden Berechtigungen verfügen.
  • Tools:
  • Zugriff:
    • Einfacher Zugriff: Um PRs anzuzeigen oder zu überprüfen, müssen Sie Mitglied eines Azure DevOps-Projekts mit mindestens grundlegendem Zugriff sein. Wenn Sie kein Projektmitglied sind, lassen Sie sich hinzufügen.
  • Berechtigungen:
    • Aktivierung von Repos: Repos muss für Ihr Projekt aktiviert sein. Wenn der Repos-Hub und die zugehörigen Seiten nicht angezeigt werden, lesen Sie Aktivieren oder Deaktivieren eines Azure DevOps-Diensts, um Repos erneut zu aktivieren.
    • Sicherheitsgruppe "Leser": Um zu einer PR beizutragen, muss man Mitglied der Sicherheitsgruppe "Leser" sein oder über die entsprechenden Berechtigungen verfügen.
    • Sicherheitsgruppe "Mitwirkende": Um eine PR zu erstellen und abzuschließen, müssen Sie Mitglied der Sicherheitsgruppe "Mitwirkende" sein oder über die entsprechenden Berechtigungen verfügen.

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:

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.

  1. Wählen Sie auf der Seite Repos>Pull Requests oben rechts die Option Neuer Pull Request aus.

    Screenshot der Schaltfläche „Neuer Pull Request“.

  2. 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.

    Screenshot der Quell- und Zielbranches für einen PR in Azure Repos.

  3. 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:

    Screenshot mit der Eingabeaufforderung zum Erstellen eines PR auf der Registerkarte „Pull Requests“ in Azure Repos.

  • Auf der Seite Dateien:

    Screenshot mit der Eingabeaufforderung zum Erstellen eines PR auf der Registerkarte „Dateien“ in Azure Repos.

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.

  1. Öffnen Sie in Azure Boards über Backlogs oder Abfragen in der Ansicht Arbeit ein Arbeitselement, das mit dem Branch verknüpft ist.

  2. Wählen Sie im Bereich Entwicklung des Arbeitselements Pull Request erstellen aus.

    Screenshot der Erstellung eines PR aus dem Entwicklungsbereich eines Arbeitselements mit einem verknüpften Branch.

Ü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.

Screenshot des Symbols „Quell- und Zielbranches wechseln“.

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.

Screenshot der Hinzufügung einer Vorlage beim Erstellen eines PR.

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.

    Screenshot eines Entwurfs-PRs in der PR-Liste.

Anmerkung

Zum Erstellen von Entwurfs-PRs ist ein Azure DevOps Server 2019.1-Update oder eine höhere Version erforderlich.

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 zum Beispiel WIP oder DO NOT MERGE verwenden.

Screenshot der Erstellung eines PR-Entwurfs.

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.

Screenshot des Elements „Veröffentlichen“ zu einem PR.

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.

Screenshot des Elements „Als Entwurf markieren“.

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.

Screenshot der Erstellung eines neuen PR.

Hinzufügen von Details zu einem neuen PR.

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.

Screenshot der Bearbeitung des PR-Titels und der Auswahl der Schaltfläche „Bearbeiten

Hinzufügen von Prüfern zu einem Pull Request

Sie können Reviewer im Abschnitt Reviewer eines neuen oder vorhandenen PR hinzufügen. Darüber hinaus können Sie vorhandene optionale Reviewer erforderlich machen oder erforderliche Reviewer in optionale ändern oder sie entfernen, es sei denn, sie sind laut der Richtlinie erforderlich.

Branchrichtlinien können eine Mindestanzahl von Reviewern oder automatisch bestimmte optionale oder erforderliche Reviewer in PRs einbeziehen. Sie können Reviewer, die laut der Branchrichtlinie erforderlich sind, nicht entfernen. Sie können laut der Branchrichtlinie optionale Reviewer so ändern, dass sie erforderlich sind, oder sie entfernen.

Um die Branchrichtlinie anzuzeigen, die automatisch einen Reviewer hinzugefügt hat, klicken Sie im Abschnitt Reviewer auf der Seite Übersicht mit der rechten Maustaste neben dem Reviewer auf Weitere Optionen .

Screenshot der Ansichtsrichtlinie zu einem Reviewer, der laut der Branchrichtlinie automatisch einbezogen wird.

Wenn die Benutzer oder die Gruppe, die den Review zu Ihrem PR durchführen sollen, Ihrem Projekt nicht angehören, müssen Sie sie dem Projekt hinzufügen, bevor Sie sie als Reviewer hinzufügen können.

So fügen Sie einem neuen PR Reviewer hinzu:

  1. 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.
  2. 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.
  3. 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.

Screenshot des Hinzufügens eines Reviewers zu einem neuen PR.

So fügen Sie einem vorhandenen PR Reviewer hinzu:

  1. 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 Pull Request-Übersicht

  2. 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.

    Hinzufügen eines PR-Reviewers.

Um einen Reviewer von erforderlich in optional und umgekehrt zu ändern oder um einen Reviewer zu entfernen, wählen Sie rechts neben dem Namen des Reviewers Weitere Optionen aus. Um die Mitgliedschaft als Reviewer festgelegten Gruppen oder Teams anzuzeigen, wählen Sie das Symbol der Gruppe aus.

So verknüpfen Sie Arbeitsaufgaben mit einer neuen PR:

  1. Wählen Sie auf der Seite Neuer Pull Request unter Zu verknüpfende Arbeitselemente die Option Arbeitselemente nach ID oder Titel durchsuchen aus.
  2. Beginnen Sie mit der Eingabe einer Arbeitselement-ID oder eines Titels, und wählen Sie das zu verknüpfende Arbeitselement aus der angezeigten Dropdownliste aus. Die Suche nach Titel liefert nach Status gefilterte Arbeitselemente; alle Arbeitselemente mit den Statuskategorien Abgeschlossen und Entfernt werden ausgeschlossen. Diese Arbeitselemente 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, ihm zugewiesen oder von ihm autorisiert sein.

So verknüpfen Sie Arbeitsaufgaben mit einer vorhandenen PR:

  1. Wählen Sie auf der PR-Registerkarte Übersicht im Bereich Arbeitselemente die Option + aus.

    Screenshot der Auswahl der Registerkarte „Übersicht“ und des Abschnitts „Arbeitselemente“.

  2. 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.

So verknüpfen Sie Arbeitsaufgaben mit Ihrer PR:

  1. Wählen Sie im PR die Registerkarte Übersicht aus.

    Screenshot der Auswahl der Registerkarte „Übersicht“ und der Schaltfläche zum Verknüpfen von Elementen.

  2. Wählen Sie im Bereich Arbeitselemente die Schaltfläche zum Hinzufügen aus. Hinzufügen von Symbolen zu PRs

  3. Geben Sie die ID der Arbeitsaufgabe ein, oder suchen Sie nach Arbeitselementen mit Titeln, die Ihrem Text entsprechen. Wählen Sie die Arbeitsaufgabe aus der angezeigten Liste aus. Die Suche nach Titel liefert nach Status gefilterte Arbeitselemente; alle Arbeitselemente mit den Statuskategorien Abgeschlossen und Entfernt werden ausgeschlossen. Diese Arbeitsaufgaben werden auch nach Datum und Benutzer gefiltert, wobei nur diejenigen angezeigt werden, die in den letzten 30 Tagen erstellt oder aktualisiert wurden, und sie sollten vom aktuellen Benutzer erstellt, zugewiesen oder autorisiert sein.

Entfernen Sie Arbeitsaufgabenverknüpfungslinks, indem Sie die Schaltfläche "Entfernen" auswählen, die angezeigt wird, wenn Sie mit der Maus auf die Arbeitsaufgabe zeigen. Schaltfläche zum Entfernen Wenn Sie einen Link entfernen, wird nur der Link zwischen einem Arbeitselement und dem PR entfernt. Links, die im Branch oder aus Commits erstellt wurden, bleiben im Arbeitselement.

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.

Screenshot von PRs mit Tags.

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.

Screenshot mit hervorgehobenem Abschnitt „PR-Tags“.

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.

Screenshot, der zeigt, wie Dateien während der Erstellung an die P R-Beschreibung angefügt werden.

Ä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:

  1. Wählen Sie oben rechts auf der PR-Seite Übersicht die Option Weitere Aktionen und dann im Dropdownmenü Zielbranch ändern aus.
  2. Wählen Sie im Bereich Zielbranch ändern die Option Zielbranch auswählen, dann den neuen Branch und dann Ändern aus.

Pull Request-Benachrichtigungen per E-Mail an Projektbeteiligte senden

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:

  1. Wählen Sie auf der PR-Seite Übersicht die Option Weitere Optionen und dann Pull Request freigeben aus.

    Screenshot der Auswahl von „Pull Request freigeben“ auf der PR-Seite „Übersicht“.

  2. 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.

  3. 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 die E-Mail nur an die einzelnen Adressen der Projektmitglieder senden. Das Hinzufügen einer Team- oder Sicherheitsgruppe zur Zeile An: wird nicht unterstützt. Wenn Sie ein E-Mail-Konto hinzufügen, das vom System nicht erkannt wird, erhalten Sie eine Nachricht, dass mindestens ein Empfänger Ihrer E-Mail nicht über die Berechtigung zum Lesen der E-Mail-Pullanforderung verfügt.

Damit die E-Mail-Funktion funktioniert, muss Ihr Administrator für Azure DevOps Server einen SMTP-Serverkonfigurieren.

Nächste Schritte

Überprüfen von Pull Requests