Erstellen von Pull Requests

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

Visual Studio 2019 | Visual Studio 2022

Erstellen Sie Pull Requests (PRs), um Code in einem Git-Repository zu ändern, zu überprüfen und zusammenzuführen. Sie können PRs aus Branches im Upstreamrepository oder aus Verzweigungen 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 hinterlassen und abstimmen, um die PRs zu genehmigen oder abzulehnen. Abhängig von 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 Verwaltungsüberlegungen finden Sie unter Informationen zu Pull Requests.

Voraussetzungen

  • Repositorys müssen für Ihr Projekt aktiviert sein. Wenn der Repository-Hub und die zugehörigen Seiten nicht angezeigt werden, lesen Sie Aktivieren oder Deaktivieren eines Azure DevOps-Diensts , um Repos wiederzuverwenden.

  • Um PRs anzeigen oder überprüfen zu können, müssen Sie Mitglied eines Azure DevOps-Projekts mit Standardzugriff oder höher sein.

  • Um zu einem PR beizutragen, müssen Sie Mitglied der Sicherheitsgruppe Leser sein oder über die entsprechenden Berechtigungen verfügen.

  • Zum Erstellen und Abschließen eines PR müssen Sie Mitglied der Sicherheitsgruppe Mitwirkende sein oder über die entsprechenden Berechtigungen verfügen.

    Hinweis

    Bei öffentlichen Projekten haben Benutzer, denen Der Zugriff auf Beteiligte gewährt wurde, Vollzugriff auf Azure Repos.

  • Repositorys müssen für Ihr Projekt aktiviert sein. Wenn der Repository-Hub und die zugehörigen Seiten nicht angezeigt werden, lesen Sie Aktivieren oder Deaktivieren eines Azure DevOps-Diensts , um Repos wiederzuverwenden.
  • Zum Anzeigen oder Überprüfen von PRs müssen Sie Mitglied des Azure DevOps-Projekts mit Standardzugriff oder höher sein. Wenn Sie kein Projektmitglied sind, werden Sie hinzugefügt.
  • Um einen 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 einem PR beizutragen, müssen Sie Mitglied der Sicherheitsgruppe Leser sein oder über die entsprechenden Berechtigungen verfügen.
  • Zum Erstellen und Abschließen eines PR müssen Sie Mitglied der Sicherheitsgruppe Mitwirkende sein oder über die entsprechenden Berechtigungen verfügen.
  • Um PRs anzeigen oder überprüfen zu können, müssen Sie Mitglied eines Azure DevOps-Projekts mit Standardzugriff oder höher sein. Wenn Sie kein Projektmitglied sind, werden Sie hinzugefügt.
  • Um zu einem PR beizutragen, müssen Sie Mitglied der Sicherheitsgruppe Leser sein oder über die entsprechenden Berechtigungen verfügen.

Erstellen eines Pull Requests

Sie können einen neuen PR auf der Azure DevOps-Projektwebsite, in Visual Studio oder über die Azure DevOps CLI erstellen.

Auf der Azure DevOps-Projektwebsite können Sie einen neuen PR erstellen:

Erstellen eines PR über die Seite "Pull Requests"

Sie können PRs für jeden Branch über die Pull Requests-Seite 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

  2. Wählen Sie den Branch mit den Änderungen und den Branch aus, in dem Sie die Änderungen zusammenführen möchten, z. B. den Mainbranch.

    Screenshot: Quell- und Zielbranche für ein P R in Azure Repos.

  3. Geben Sie Ihre PR-Details ein , und erstellen Sie den PR.

Erstellen eines PR aus einem Pushbranch

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: Aufforderung zum Erstellen eines P R auf der Registerkarte Pull Requests in Azure Repos

  • Auf der Seite Dateien :

    Screenshot: Aufforderung zum Erstellen eines P R auf der Registerkarte

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.

Nachdem Sie einen Featurebranch per Push übertragen oder aktualisiert haben, werden Sie von Azure Repos aufgefordert, einen PR in der Codeansicht im Web zu erstellen. Diese Eingabeaufforderung wird unter Pull Requests und Files angezeigt.

Screenshot: Aufforderung zum Erstellen eines P R auf der Registerkarte Pull Requests in Azure Repos

Screenshot: Aufforderung zum Erstellen eines P R auf der Registerkarte

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 Arbeitsansicht ein Arbeitselement, das mit dem Branch verknüpft ist.

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

    Screenshot: Erstellen eines PR aus dem Bereich

Der Link führt 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 von einem Branch in einen anderen kopieren, indem Sie cherry-pick verwenden. Im Gegensatz zu einer Merge- oder Rebase bringt Cherry-Pick nur die Änderungen aus den ausgewählten Commits anstelle aller Änderungen in einem Branch.

Wenn Sie Änderungen aus einem abgeschlossenen PR auswählen möchten, wählen Sie auf der Seite Übersicht des PR die Option Cherry-pick aus. Um Änderungen aus einem aktiven PR zu kopieren, wählen Sie im Menü Weitere Optionen des PR die Option Cherry-pick aus. Mit dieser 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 Ziel-Branches Ihres Pull Requests

Bevor Sie einen PR zum ersten Mal speichern, können Sie die Quell- und Ziel-Branches des PR ändern, indem Sie neben den Branchnamen das Symbol Quell- und Zielbranchen wechseln auswählen. Sobald der PR aktiv ist, wird dieses Symbol entfernt, aber Sie können den Zielbranch des PR weiterhin ändern .

Screenshot: Symbol

Verwenden von Pull Request-Vorlagen

Eine Pull Request-Vorlage ist eine Datei mit Markdowntext, der die PR-Beschreibung beim Erstellen eines PR auffüllt. Gute PR-Beschreibungen informieren PR-Prüfern, was sie erwartet, und können ihnen helfen, Aufgaben wie das Hinzufügen von Komponententests und das Aktualisieren von Dokumentationen nachzuverfolgen. Ihr Team kann eine STANDARD-PR-Vorlage erstellen, die allen neuen PR-Beschreibungen im Repository Text hinzufügt. Außerdem können Sie aus branchspezifischen Vorlagen oder anderen Vorlagen auswählen, die Ihr Team definiert. Weitere Informationen zum Erstellen und Verwenden von PR-Vorlagen finden Sie unter Verbessern von Pull Request-Beschreibungen mithilfe von Vorlagen.

Wenn Ihr Repository über eine Standardvorlage verfügt, verfügen alle PRs im Repository bei der Erstellung über den Beschreibungstext der Standardvorlage. Um weitere Vorlagen hinzuzufügen, wählen Sie Vorlage hinzufügen und dann eine Vorlage aus der Dropdownliste aus. Sie können den Vorlagentext in Ihrer Beschreibung bearbeiten, entfernen oder anderen Text hinzufügen.

Screenshot: Hinzufügen einer Vorlage beim Erstellen eines P R

Erstellen von Entwurfs-PRs

Wenn Ihr PR nicht zur Überprüfung bereit ist, können Sie einen Entwurfs-PR erstellen, um die laufenden Arbeiten anzugeben. Wenn der PR zur Überprüfung bereit ist, können Sie ihn veröffentlichen und den vollständigen Überprüfungsprozess beginnen oder fortsetzen.

Entwurfs-PRs weisen die folgenden Unterschiede zu veröffentlichten PRs auf:

  • Buildvalidierungsrichtlinien werden nicht automatisch ausgeführt. Sie können Buildüberprüfungen manuell in die Warteschlange stellen, indem Sie das Menü Weitere Optionen im 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 dem Pr-Entwurf explizit hinzufügen.

  • Entwurfs-PRs werden in der PR-Liste mit einem Draft-Badge angezeigt.

    Screenshot eines P R-Entwurfs in der P R-Liste

Hinweis

Das Erstellen von Entwurfs-PRs erfordert Azure DevOps Server Update 2019.1 oder höher.

Um einen Entwurfs-PR zu erstellen, wählen Sie den Pfeil neben Erstellen aus, und wählen Sie beim Erstellen des PR als Entwurf erstellen aus. Sie müssen keine Titelpräfixe wie WIP oder DO NOT MERGE verwenden.

Screenshot: Erstellen als Entwurf von P R

Wenn Sie bereit sind, den PR überprüfen und abschließen zu lassen, wählen Sie oben rechts im PR veröffentlichen aus. Die Veröffentlichung eines PR weist erforderliche Prüfer zu, wertet Richtlinien aus und startet die Abstimmung.

Screenshot: Veröffentlichen für eine P R

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: Als Entwurf markieren

Hinweis

Für dieses Feature ist Azure DevOps Server Update 2019.1 oder höher erforderlich.

Hinzufügen oder Bearbeiten von Pull Request-Titel und -Beschreibung

Geben Sie auf der Seite Neuer Pull Request einen Titel und eine detaillierte Beschreibung Ihrer Änderungen ein, damit andere personen sehen können, welche Probleme die Änderungen lösen. Auf einem neuen PR wie in vorhandenen PRs können Sie die Dateien und Commits in Ihrem PR auf separaten Registerkarten sehen. Sie können Prüfer hinzufügen, Arbeitselemente verknüpfen und dem PR Tags hinzufügen.

Wenn Sie bereit sind, Ihre Änderungen zu überprüfen, wählen Sie Erstellen aus, um den PR zu erstellen.

Screenshot: Erstellen eines neuen P R

Hinzufügen von Details zu einem neuen P R.

Machen Sie sich keine Sorgen, wenn Sie beim Erstellen Ihres PR nicht alle Arbeitselemente, Prüfer oder Details bereit haben. Sie können diese Elemente hinzufügen oder aktualisieren, nachdem Sie den PR erstellt haben.

Bearbeiten von PR-Titel und -Beschreibung

Halten Sie den PR-Titel und die Beschreibung auf dem neuesten Stand, damit die Prüfer die Änderungen im PR verstehen können.

Sie können den Titel eines vorhandenen PR aktualisieren, indem Sie den aktuellen Titel auswählen und den Text aktualisieren. Wählen Sie das Symbol Speichern aus, um Die Änderungen zu speichern, oder wählen Sie das Symbol Rückgängig aus, um die Änderungen zu verwerfen.

Bearbeiten Sie die PR-Beschreibung, indem Sie im Abschnitt Beschreibung auf das Symbol Bearbeiten klicken.

Screenshot: Bearbeiten des P R-Titels und Auswählen der Schaltfläche

Hinzufügen von Prüfern zu einem Pull Request

Sie können Prüfer im Abschnitt Prüfer eines neuen oder vorhandenen PR hinzufügen. Sie können auch vorhandene optionale Prüfer erforderlich machen oder erforderliche Prüfer in optional ändern oder entfernen, es sei denn, sie sind gemäß der Richtlinie erforderlich.

Branchrichtlinien können eine Mindestanzahl von Prüfern erfordern oder automatisch bestimmte optionale oder erforderliche Prüfer in PRs einschließen. Sie können keine Prüfer entfernen, die für die Branchrichtlinie erforderlich sind. Sie können optionale Prüfer für Branchrichtlinien ändern, um erforderlich zu sein, oder sie entfernen.

Um die Branchrichtlinie anzuzeigen, die automatisch einen Prüfer hinzugefügt hat, klicken Sie im Abschnitt Prüfer der PR-Übersichtsseite neben dem Prüfer mit der rechten Maustaste auf Weitere Optionen .

Screenshot: Ansichtsrichtlinie auf einem Prüfer, der automatisch von der Branchrichtlinie eingeschlossen wird

Wenn der Benutzer oder die Gruppe, den Sie ihren PR überprüfen möchten, kein Mitglied Ihres Projekts ist, müssen Sie sie dem Projekt hinzufügen , bevor Sie sie als Bearbeiter hinzufügen können.

So fügen Sie einem neuen PR Prüfer hinzu:

  1. Wählen Sie auf der Seite Neuer Pull Request unter Prüfer die Option Benutzer und Gruppen durchsuchen aus, die als Prüfer hinzugefügt werden sollen.
  2. Wenn Sie einen Namen oder eine E-Mail-Adresse eingeben, wird in einer Dropdownliste eine Liste der übereinstimmenden Benutzer und Gruppen angezeigt. Wählen Sie Namen aus der Liste aus, die Als optionale Prüfer hinzugefügt werden sollen.
  3. Um erforderliche Prüfer hinzuzufügen, wählen Sie Erforderliche Prüfer hinzufügen und dann Suchen aus, um erforderliche Prüfer hinzuzufügen , um die Namen zu suchen und auszuwählen.

Screenshot: Hinzufügen eines Prüfers zu einem neuen P R

So fügen Sie einem vorhandenen PR Prüfer hinzu:

  1. Wählen Sie im Abschnitt Prüfer der Seite Übersicht die Option Hinzufügen und dann Erforderlicher Prüfer oder Optionaler Prüfer aus.

    Übersicht über Pull Request

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

    Fügen Sie den P R-Prüfer hinzu.

Um einen Prüfer zwischen erforderlich und optional zu ändern oder einen Prüfer zu entfernen, wählen Sie rechts neben dem Namen des Prüfers Weitere Optionen aus. Um die Mitgliedschaft einer Gruppe oder eines Teams anzuzeigen, die als Prüfer bezeichnet wurde, wählen Sie das Gruppensymbol aus.

So fügen Sie Ihrem PR Prüfer hinzu:

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

    PR-Übersicht

  2. Wählen Sie im Bereich Prüfer die Schaltfläche Hinzufügen aus.

  3. Geben Sie den Namen des Benutzers oder der Gruppe ein, der der Prüferliste für den PR hinzugefügt werden soll. Wenn der Benutzer kein Mitglied Ihres Projekts ist, müssen Sie sie hinzufügen.

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

    Hinzufügen eines PR-Prüfers

So verknüpfen Sie Arbeitselemente mit einem neuen PR:

  1. Wählen Sie auf der Seite Neuer Pull Request unter Zu verknüpfende Arbeitselementedie 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.

So verknüpfen Sie Arbeitselemente mit einem vorhandenen PR:

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

    Screenshot: Auswählen der Registerkarte

  2. Geben Sie die ID des Arbeitselements ein, oder suchen Sie nach dem Titel des Arbeitselements. Wählen Sie das Arbeitselement aus der angezeigten Liste aus.

Entfernen Sie einen Arbeitselementlink, indem Sie das Symbol x neben dem Arbeitselement auswählen. Wenn Sie einen Link entfernen, wird nur die Verknüpfung zwischen dem Arbeitselement und dem PR entfernt. Links, die im Branch oder aus Commits erstellt wurden, verbleiben im Arbeitselement.

So verknüpfen Sie Arbeitselemente mit Ihrem PR:

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

    Screenshot: Auswahl der Registerkarte

  2. Wählen Sie im Bereich Arbeitselemente die Schaltfläche Hinzufügen aus. Symbol hinzufügen in PRs

  3. 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 angezeigten Liste aus.

Entfernen Sie Arbeitselementlinks, indem Sie die Schaltfläche Entfernen auswählen, die angezeigt wird, wenn Sie mit der Maus auf das Arbeitselement zeigen. Schaltfläche Beim Entfernen eines Links wird nur der Link zwischen einem Arbeitselement und einem PR entfernt. Links, die im Branch oder aus Commits erstellt wurden, verbleiben im Arbeitselement.

So verknüpfen Sie Arbeitselemente mit Ihrem PR:

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

    Wählen Sie im PR die Option Übersicht aus.

  2. Wählen Sie im Bereich Arbeitselemente die Schaltfläche Hinzufügen aus.

  3. 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 angezeigten Liste aus.

Entfernen Sie Arbeitselementlinks, indem Sie die Schaltfläche Entfernen auswählen, die angezeigt wird, wenn Sie mit der Maus auf das Arbeitselement zeigen. Symbol Durch Entfernen eines Links wird nur der Link zwischen dem Arbeitselement und dem PR entfernt. Links, die im Branch oder aus Commits erstellt wurden, verbleiben im Arbeitselement.

Hinzufügen von Tags zu einem Pull Request

Verwenden Sie Tags, um wichtige Details anzuzeigen und PRs zu organisieren. Tags können zusätzliche Informationen an Prüfer übermitteln, z. B. dass der PR noch in Bearbeitung ist oder ein Hotfix für eine bevorstehende Version ist.

Screenshot: P Rs 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: Hervorgehobener Abschnitt

Hinzufügen von Bezeichnungen zu einem Pull Request

Sie können zusätzliche Informationen zu einem PR an die Prüfer übermitteln, indem Sie Bezeichnungen verwenden. Möglicherweise ist der PR noch in Arbeit, oder es ist ein Hotfix für ein bevorstehendes Release. 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.

Screenshot: P Rs mit Bezeichnungen

Um beim Erstellen eines PR eine Bezeichnung hinzuzufügen, wählen Sie Bezeichnung hinzufügen aus. Nachdem Sie einen PR erstellt haben, können Sie seine Bezeichnungen im Abschnitt Bezeichnungen verwalten.

P R-Bezeichnung hinzufügen

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: Anfügen von Dateien an die P R-Beschreibung während der Erstellung

Ändern des Zielbranchs eines aktiven Pull Requests

Für die meisten Teams zielen fast alle PRs auf einen Standardbranch ab, z. B main . oder develop. Wenn Sie manchmal einen anderen Branch als Ziel verwenden müssen, können Sie beim Erstellen des PR leicht vergessen, den Zielbranch zu ändern. In diesem Fall können Sie den Zielbranch eines aktiven PR ändern:

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

Email Pull Request-Benachrichtigungen für Projektbeteiligte

Sie können einen Pull Request per E-Mail freigeben, um Prüfer zu benachrichtigen und mit Teammitgliedern zu kommunizieren. So teilen Sie einen PR:

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

    Screenshot: Auswahl von Pull Request freigeben auf der Übersichtsseite eines P R

  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 auswählen. Sie können auch Empfänger entfernen.

  3. Fügen Sie im Feld Notiz (Optional) eine optionale Nachricht hinzu, und wählen Sie dann Senden aus. Empfänger erhalten eine E-Mail, in der sie ihre Aufmerksamkeit anfordern und eine Verknüpfung mit dem PR anfordern.

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 ein oder mehrere Empfänger Ihrer E-Mail nicht berechtigt sind, den per E-Mail gesendeten Pull Request zu lesen.

Damit das E-Mail-Feature funktioniert, muss Ihr Administrator für Azure DevOps Server einen SMTP-Server konfigurieren.

Nächste Schritte