Slutföra, överge eller återställa pull-begäranden

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

Visual Studio 2019 | Visual Studio 2022

När alla nödvändiga granskare har godkänt din pull-begäran (PR) och PR uppfyller alla krav för grenprinciper , kan du sammanfoga ändringarna i målgrenen och slutföra PR.en. Eller om du bestämmer dig för att inte fortsätta med ändringarna i PR kan du avbryta PR.

Information om hur du åtgärdar granskarnas ändringar och svarar på och löser granskningskommentare finns i Adresskommentare.

Förutsättningar

• Lagringsplatser måste vara aktiverade i projektet. Om lagringshubben och de associerade sidorna inte visas kan du läsa Aktivera eller inaktivera en Azure DevOps-tjänst till lagringsbara lagringsplatser.

• För att slutföra din PR måste du vara medlem i säkerhetsgruppen Deltagare eller ha motsvarande behörigheter i projektet som PR finns i.

• Om du vill bidra till en PR måste du vara medlem i säkerhetsgruppen Läsare eller ha motsvarande behörigheter.

• Om du vill visa eller granska PR:er måste du ha grundläggande eller högre åtkomst till Azure DevOps-projektet.

• Om du inte är medlem i projektet som du vill bidra till läggs du till.

  Kommentar

  För offentliga projekt har användare som beviljats intressentåtkomst fullständig åtkomst till Azure Repos.

• Mer information om behörigheter och åtkomst finns i Git-standardlagringsplats och grenbehörigheter och Om åtkomstnivåer.

• I Azure DevOps Services kan du hantera pr och andra resurser från Azures kommandoradsgränssnitt (CLI) med azure-devops tillägget. Mer information om hur du arbetar med Azure DevOps Services CLI finns i Komma igång med Azure DevOps CLI. Azure Repos CLI-kommandon för PRs använder az repos pr.

Kontrollera sammanslagningsändringar

När du slutför en PR lägger Git till en ny kopplingsincheckning i slutet av huvudgrenen. Den här sammanslagningsincheckningen länkar de tidigare historikerna för huvudgrenen och PR-källgrenen. Om du vill se incheckningen för förhandsgranskningssammanslagning och söka efter sammanslagningskonflikter väljer du menyn Fler alternativ uppe till höger på sidan PR-översiktoch väljer sedan Visa sammanslagningsändringar.

Om du har ändrat målgrenen när du har skapat PR väljer du Starta om sammanslagning för att skapa en ny incheckning av förhandsgranskningssammanslagning och uppdaterar vyn för sammanslagningsändringsdiff.

Granska grenprinciper

Teams kan ange förgreningsprinciper som kräver att PR:er i skyddade grenar uppfyller specifika kriterier innan de PR:er kan slås samman. Du kan se de förgreningsprinciper som gäller för din PR, om de krävs för sammanslagning och om PR skickas eller misslyckas.

Webbläsare

Fliken PR-översikt sammanfattar grenprinciper som skickar eller misslyckas för PR. Översikten visar endast misslyckade principer, men du kan se alla principkontroller genom att välja Visa <n> kontroller.

På sidan PR-översikt har avdelningsprincipkrav en ikon. Välj Fler alternativ bredvid kravet och välj sedan Visa princip för att gå till grenens sida Förgreningsprinciper i Project Inställningar.

Visual Studio

Du kan öppna en PR i Visual Studio och sedan granska grenprinciper enligt beskrivningen på fliken Webbläsare.

Om du vill öppna en PR från Visual Studio går du till Git-menyn, väljer< din Git-tjänst>>Visa pull-begäranden och väljer en pull-begäran för att öppna den.

Visual Studio 2019 version 16.8 och senare versioner ger en Git-versionskontroll samtidigt som du underhåller Git-användargränssnittet för Team Explorer . Om du vill använda Team Explorer avmarkerar du Verktyg>Alternativ>Förhandsgranskning Funktioner>Ny Git-användarupplevelse från menyraden. Du kan använda Git-funktioner från något av gränssnitten på ett och samma sätt.

Så här kommer du åt pr:ar från Visual Studio Team Explorer:

1. Anslut till projektet från Visual Studio.

2. Välj Visa>Team Explorer för att öppna Team Explorer. Du kan också trycka på Ctrl+\, Ctrl+M.

3. Från start väljer du Pull Requests (Pull-begäranden) för att visa listor över pr-begäranden som öppnats av dig eller tilldelats dig.

4. Om du vill öppna en pr i webbportalen och visa principerna i praktiken högerklickar du på PR och väljer Öppna i webbläsaren.

Azure DevOps CLI

Om du vill se alla grenprinciper som gäller för en PR använder du az repos pr policy list med den obligatoriska id parametern.

az repos pr policy list --id
                        [--detect {false, true}]
                        [--org]
                        [--query-examples]
                        [--skip]
                        [--subscription]
                        [--top]

Parametrar

Parameter	Description
--id	ID för pull-begäran. Obligatoriska.
--detect	Identifiera organisationen automatiskt. Godkända värden: false, true.
--org --organization	Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med hjälp az devops configure -d organization=<ORG_URL>av . Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.
--query-examples	Rekommenderad JMESPath-sträng. Du kan kopiera en av frågorna och klistra in den efter parametern --query inom dubbla citattecken för att se resultatet. Du kan lägga till ett eller flera positionsnyckelord så att förslag baseras på dessa nyckelord.
--skip	Antal principer att hoppa över.
--subscription	Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med hjälp az account set -s <NAME_OR_ID>av .
--top	Maximalt antal principer som ska listas.

Exempel

Om du till exempel vill se vilka principer som gäller för PR #28 kör du följande kommando:

az repos pr policy list --id 28 --output table

Evaluation ID                         Policy                                         Blocking    Status    Expired    Build ID
------------------------------------  ---------------------------------------------  ----------  --------  ---------  ----------
84e7ca6d-0b42-4819-9f62-f41df5e319f3  Minimum number of reviewers (1)                True        Approved
1ba061d8-9e9f-401b-ab61-e2ed1c200aba  Required reviewers (1)                         True
37620a4b-adc4-483d-9ca2-3f4e6ffe2990  Comment requirements                           False       Approved
34b7cae8-812a-4c14-9229-f71a0e662e8b  Required reviewers (1) ([Fabrikam Fiber]\Web)  False
a6e4380e-9f38-4aa5-863c-0fc496027362  Work item linking                              False       Rejected

Slutför en pull-begäran

När du har löst eventuella sammanslagningskonflikter, och PR uppfyller alla grenprinciper och har alla nödvändiga godkännanden, kan du slutföra PR.

Webbläsare

1. Välj Slutför längst upp till höger för att slutföra PR. Eller välj listrutepilen bredvid knappen Slutför och välj ett av alternativen.

   

   • Slutför: Slutför PR nu och sammanfoga ändringarna till målgrenen.
   • Ställ in automatisk komplettering: Konfigurera pr för att slutföra och sammanslå när den uppfyller alla nödvändiga grenprinciper.
   • Markera som utkast: Returnera PR till utkaststatus och ta bort alla röster.
   • Avbryt: Stäng PR utan att sammanfoga ändringarna.

2. I fönstret Slutför pull-begäran går du till Sammanslagningstyp och väljer något av kopplingsalternativen.

   

   • Sammanslagning (ingen snabbspolning): Sammanfoga med en icke-linjär historik som bevarar alla incheckningar.
   • Squash-incheckning: Sammanfoga med en linjär historik som kombinerar alla källincheckningar i en enda incheckning på målet, eller squash sammanfogar PR. Tänk på att en ny incheckning skapas för målgrenen utan att behålla incheckningshistoriken från källgrenen.
   • Ombasera och snabbsnabbt framåt: Ombasera källincheckningarna till målet och snabbsnabbt framåt.
   • Halvradär sammanslagning: Ombasera källincheckningar till målet och skapa en två-överordnad sammanslagning.

   Kommentar

   Befintliga principer tillämpas. Om din gren till exempel för närvarande har en "endast squash-sammanslagning"-princip måste du ändra principen om du vill använda en annan kopplingstyp.

3. Välj något av följande alternativ efter slutförande. Vissa alternativ är inte tillgängliga för vissa sammanslagningstyper.

   • Slutför associerade arbetsobjekt efter sammanslagning: Slutför alla länkade arbetsobjekt.
   • Ta bort <grennamn> efter sammanslagning: Ta bort PR:s källgren efter sammanslagning.
   • Anpassa incheckningsmeddelande för sammanslagning: Lägg till ett anpassat incheckningsmeddelande för sammanslagning. Om du väljer det här alternativet uppdaterar du incheckningsmeddelandet för sammanslagning .
   • Åsidosätt grenprinciper och aktivera sammanslagning. Tvinga sammanfogningen även om PR inte uppfyller alla grenprinciper. Det här alternativet är bara tillgängligt om du har behörigheten Undanta från principtillämpning .

4. Välj Slutför sammanslagning.

När du slutför sammanfogningen uppdateras alla länkade arbetsobjekt automatiskt för att visa slutförandet av pr.et.

Visual Studio

Om du vill slutföra en PR öppnar du PR i webbläsaren och på sidan Översikt väljer du Slutför eller anger andra alternativ.

Om du vill öppna en PR från Visual Studio går du till Git-menyn, väljer< din Git-tjänst>>Visa pull-begäranden och väljer en pull-begäran för att öppna den.

Så här kommer du åt PR:ar från Visual Studio 2019 Team Explorer:

1. Anslut till projektet från Visual Studio.

2. Välj Visa>Team Explorer för att öppna Team Explorer. Du kan också trycka på Ctrl+\, Ctrl+M.

3. Från start väljer du Pull Requests (Pull-begäranden) för att visa listor över pr-begäranden som öppnats av dig eller tilldelats dig.

4. Om du vill öppna en PR i webbportalen högerklickar du på PR och väljer Öppna i webbläsaren.

Azure DevOps CLI

Om du vill slutföra en PR och sammanfoga ändringarna använder du az repos pr update för att uppdatera PR --status till completed.

Om du till exempel vill slutföra PR #21 använder du:

az repos pr update --id 21 --status completed

Ange slutförandealternativ

Du kan ange alternativ för pr-slutförande när du skapar en PR med az repos pr createeller uppdaterar alternativ för att skapa i befintliga PR med az repos pr update.

Alternativen för PR-slutförande är:

• bypass-policy {false, true}: Om du vill kringgå nödvändiga principer och slutföra pull-begäran när den kan sammanfogas.
• bypass-policy-reason: Orsak till att kringgå nödvändiga principer.
• delete-source-branch {false, true}: Om du vill ta bort källgrenen när pull-begäran har slutförts och sammanfogats.
• merge-commit-message: Anpassa incheckningsmeddelandet för sammanslagning.
• squash {false, true}: Om källan ska checkas in i en enda målincheckning för sammanslagning.
• transition-work-items {false, true}: Om du vill lösa länkade arbetsobjekt när PR slås samman.

Om du vill ange slutförandealternativ och slutföra en befintlig PR använder du az repos pr update med den obligatoriska id parametern.

az repos pr update --id
                   [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--org]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--subscription]
                   [--title]
                   [--transition-work-items {false, true}]

Parametrar

Parameter	Description
--id	ID för pull-begäran. Obligatoriska.
--auto-complete	Ställ in pull-begäran så att den slutförs automatiskt när alla principer har passerat och källgrenen kan sammanfogas till målgrenen. Godkända värden: false, true.
--bypass-policy	Kringgå alla nödvändiga principer och slutför pull-begäran när den kan sammanfogas. Godkända värden: false, true.
--bypass-policy-reason	Orsak till att kringgå nödvändiga principer.
--delete-source-branch	Ta bort källgrenen när pull-begäran har slutförts och sammanfogats till målgrenen. Godkända värden: false, true.
--description -d	Ny beskrivning för pull-begäran. Kan inkludera Markdown. Varje värde är ny rad. Exempel: --description "First Line" "Second Line".
--detect	Identifiera organisationen automatiskt. Godkända värden: false, true.
--draft	Konvertera PR till utkastläge eller publicera den. Godkända värden: false, true.
--merge-commit-message	Meddelande som ska visas när incheckningar sammanfogas.
--org --organization	Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med hjälp az devops configure -d organization=<ORG_URL>av . Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.
--squash	Mosa incheckningarna i källgrenen när du sammanfogar till målgrenen. Godkända värden: false, true.
--status	Ange det nya tillståndet för pull-begäran. Accepterade värden: abandoned, active, completed.
--subscription	Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med hjälp az account set -s <NAME_OR_ID>av .
--title	Ny rubrik för pull-begäran.
--transition-work-items	Övergå alla arbetsobjekt som är länkade till pull-begäran till nästa logiska tillstånd, till exempel Löst. Godkända värden: false, true.

Exempel

I följande exempel slutförs PR #21, dess källgren tas bort, dess länkade arbetsobjekt matchas och ett incheckningsmeddelande för sammanslagning läggs till:

az repos pr update --id 21 --status completed --delete-source-branch true --transition-work-items true --merge-commit-message "This update is complete."

Rebase under PR-slutförande

Det finns några situationer när det inte går att göra en ombasering under pr-slutförandet:

• Om en princip på målgrenen förbjuder användning av ombaseringsstrategier behöver du behörighet att åsidosätta grenprinciper för att ändra bas.
• Om PR-källgrenen har principer kan du inte göra om den. Ombasering skulle ändra källgrenen utan att gå igenom processen för principgodkännande.
• Om du använde sammanslagningskonfliktstillägget för att lösa sammanslagningskonflikter kan du inte ombaseras. Konfliktlösning som tillämpas på en trevägssammanslagning lyckas sällan eller är giltiga när alla PR-incheckningar görs individuellt.

I alla dessa fall kan du fortfarande ändra din gren lokalt och sedan push-överföra uppströms, eller squash-sammanfoga dina ändringar när du slutför PR.

Problem med flera sammanslagningsbaser

I vissa fall har en PR mer än en sann sammanslagningsbas, och den här situationen kan orsaka säkerhetsproblem. Om filerna i PR har olika versioner mellan sammanslagningsbaserna ges en varning om flera sammanslagningsbaser. Mer information och reparation finns i Flera sammanslagningsbaser.

Lösa sammanslagningskonflikter

Filändringar i din gren kan vara i konflikt med ändringar i en annan gren. När det inte är klart hur du sammanfogar ändringar visar Git de filer som står i konflikt på PR:s översiktssida. Du måste lösa eventuella sammanslagningskonflikter mellan PR-grenen och målgrenen innan du kan slå samman en PR eller ange att PR ska kompletteras automatiskt. Anvisningar om hur du löser sammanslagningskonflikter finns i Lösa sammanslagningskonflikter.

Ange att en pull-begäran ska kompletteras automatiskt

Webbläsare

Välj Ange automatiskt slutfört från listrutan Slutför för att slutföra och sammanfoga PR-ändringarna så snart villkoren uppfyller alla grenprinciper. När PR:en har slutförts får du ett e-postmeddelande. Om en konflikt eller ett fel förhindrar att PR slutförs meddelar e-postmeddelandet dig om problemet.

Kommentar

Alternativet Ange automatisk komplettering är tillgängligt i Azure Repos och TFS 2017 och senare när du har grenprinciper. Om du inte ser Ange automatisk komplettering har du inga grenprinciper. Mer information finns i Grenprinciper.

Som standard väntar en pr som är inställd på automatisk komplettering endast på nödvändiga principer. I panelen Aktivera automatisk slutförande kan du också välja att vänta på valfria principer.

Från och med TFS 2018 Update 2 visar sidan PR-översikt listan över utestående principkriterier som PR väntar på. Om du anger att en princip ska krävas i panelen Aktivera automatisk slutförande kan du ställa in den på valfri på sidan Översikt .

Välj Avbryt automatisk komplettering för att inaktivera automatisk komplettering.

En PR-inställning för automatisk komplettering visar ett automatiskt kompletteringsmärke på sidan Pull-begäranden .

Visual Studio

Öppna en pull-begäran i webbportalen. På sidan Översikt väljer du Ange automatisk komplettering.

Om du vill öppna en PR från Visual Studio går du till Git-menyn, väljer< din Git-tjänst>>Visa pull-begäranden och väljer en pull-begäran för att öppna den.

Så här kommer du åt PR:ar från Visual Studio 2019 Team Explorer:

1. Anslut till projektet från Visual Studio.

2. Välj Visa>Team Explorer för att öppna Team Explorer. Du kan också trycka på Ctrl+\, Ctrl+M.

3. Från start väljer du Pull Requests (Pull-begäranden) för att visa listor över pr-begäranden som öppnats av dig eller tilldelats dig.

4. Om du vill öppna en pr i webbportalen och visa principerna i praktiken högerklickar du på PR och väljer Öppna i webbläsaren.

Azure DevOps CLI

Ange automatisk komplettering för att slutföra en pr automatiskt när den skickar alla nödvändiga godkännanden och grenprinciper. Du kan ange automatisk komplettering när pr skapas eller uppdatera en befintlig PR.

• Om du vill ange automatisk komplettering vid skapande av PR använder du az repos pr create --auto-complete true.
• Om du vill uppdatera en befintlig PR för automatisk komplettering använder du az repos pr update --id <PR Id> --auto-complete true.

Avbryta eller återaktivera en pull-begäran

Webbläsare

Om du vill avbryta dina ändringar och din pr utan att slå samman väljer du Överge i listrutan på knappen Slutför . Du kan fortfarande visa den övergivna PR:en och den förblir länkad till arbetsobjekt.

Om du vill återaktivera en övergiven PR när som helst öppnar du PR från fliken Övergiven i vyn Pull-begäran och väljer Återaktivera längst upp till höger.

Visual Studio

Öppna en pull-begäran i webbportalen. På sidan Översikt väljer du Avbryt.

Om du vill öppna PR i webbportalen använder du proceduren från Slutför en pull-begäran.

Azure DevOps CLI

Om du vill avbryta en PR utan att sammanfoga ändringarna använder du az repos pr update --id <PR Id> –-status abandoned. Du kan återaktivera PR genom att ange statusen till active.

Återställa en slutförd pull-begäran

Följ dessa steg om du vill ångra ändringarna från en pr. Mer information finns i Ångra ändringar.

1. Öppna den slutförda PR:en och välj Återställ. Den här åtgärden skapar en ny gren med ändringar som ångrar PR i en befintlig målgren på lagringsplatsen.

2. I fönstret Återställ pull-begäran :

   1. Under Målgren väljer du den gren där du vill ångra PR-ändringarna.
   2. Under Ämnesgrenens namn som krävs ändrar du namnet på den återställa PR-grenen om du vill.
   3. Välj Återställ.

3. På skärmen Ny pull-begäran väljer du Skapa.

4. Sammanfoga den nya PR:n för att slutföra återställningen.

Kommentar

Grenen som skapades under den här återställningen har en enda incheckning som återställer alla filändringar från den ursprungliga PR:en. Grenen innehåller inte en återställd incheckning för var och en av incheckningarna i den ursprungliga PR:en.

Nästa steg

Kopiera ändringar med cherry-pick

Relaterade artiklar

• Uppdateringsmeddelanden för pull-begäranden
• Om pull-begäranden och behörigheter