Skapa pull-begäranden

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

Visual Studio 2019 | Visual Studio 2022

Skapa pull-begäranden (PR) för att ändra, granska och slå samman kod på en Git-lagringsplats. Du kan skapa pr från grenar i den överordnade lagringsplatsen eller från grenar i din förgrening av lagringsplatsen. Ditt team kan granska pr:erna och ge feedback om ändringar. Granskare kan gå igenom de föreslagna ändringarna, lämna kommentarer och rösta för att godkänna eller avvisa pr:erna. Beroende på grenprinciper och andra krav kan din pr behöva uppfylla olika kriterier innan du kan slutföra PR och sammanfoga ändringarna i målgrenen.

Information om PR-riktlinjer och hanteringsöverväganden finns i Om pull-begäranden.

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.

  • Om du vill visa eller granska PR:er måste du vara medlem i ett Azure DevOps-projekt med grundläggande åtkomst eller högre.

  • 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 skapa och slutföra en PR måste du vara medlem i säkerhetsgruppen Deltagare eller ha motsvarande behörigheter.

    Kommentar

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

  • 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.
  • Om du vill visa eller granska pr:er måste du vara medlem i Azure DevOps-projektet med grundläggande åtkomst eller högre. Om du inte är projektmedlem läggs du till.
  • Om du vill skapa och slutföra en PR måste du vara medlem i säkerhetsgruppen Deltagare eller ha motsvarande behörigheter i det projekt som du vill ändra.
  • Om du vill bidra till en PR måste du vara medlem i säkerhetsgruppen Läsare eller ha motsvarande behörigheter.

Skapa en pull-begäran

Du kan skapa en ny PR från Azure DevOps-projektwebbplatsen, från Visual Studio eller från Azure DevOps CLI.

Från Azure DevOps-projektwebbplatsen kan du skapa en ny PR från:

Skapa en PR från sidan Pull-begäranden

Du kan skapa pr-begäranden för valfri gren från projektets sida Pull-begäranden på webben.

  1. På sidan Pull-begäranden för lagringsplatser>väljer du Ny pull-begäran uppe till höger.

    Skärmbild av knappen Ny pull-begäran.

  2. Välj grenen med ändringarna och den gren som du vill sammanfoga ändringarna i, till exempel huvudgrenen.

    Skärmbild av käll- och målgrenar för en P R i Azure Repos.

  3. Ange din PR-information och skapa PR.

Skapa en PR från en push-gren

När du har push-överfört eller uppdaterat en funktionsgren visar Azure Repos en uppmaning om att skapa en PR.

  • På sidan Pull-begäranden :

    Skärmbild som visar uppmaningen att skapa en P R på fliken Pull-begäranden i Azure Repos.

  • På sidan Filer :

    Skärmbild som visar uppmaningen att skapa en P R på fliken Filer i Azure Repos.

Välj Skapa en pull-begäran för att gå till en sida där du kan ange din PR-information och skapa PR.

Skapa en PR från ett länkat arbetsobjekt

Du kan skapa en pr direkt från ett Azure Boards-arbetsobjekt som är länkat till grenen.

  1. Öppna ett arbetsobjekt som är länkat till grenen från Kvarvarande uppgifter eller frågor i arbetsvyn i Azure Boards.

  2. I området Utveckling i arbetsobjektet väljer du Skapa en pull-begäran.

    Skärmbild av hur du skapar en PR från området Utveckling för ett arbetsobjekt med en länkad gren.

Länken tar dig till en sida där du kan ange din PR-information och skapa PR.

Lägga till uppdateringar med cherry-pick

Du kan kopiera incheckningar från en gren till en annan med hjälp av cherry-pick. Till skillnad från en sammanslagning eller ombas tar cherry-pick bara med sig ändringarna från de incheckningar du väljer, i stället för alla ändringar i en gren.

Välj Cherry-pick på PR:s översiktssidaom du vill välja ändringar från en slutförd PR. Om du vill kopiera ändringar från en aktiv PR väljer du Cherry-pick på pr-menyn Fler alternativ . Den här åtgärden skapar en ny gren med de kopierade ändringarna. Du kan sedan skapa en ny PR från den nya grenen. Detaljerade instruktioner finns i Kopiera ändringar med cherry-pick.

Växla käll- och målgrenar för din pull-begäran

Innan du sparar en pr första gången kan du växla käll- och målgrenarna för PR genom att välja ikonen Växla källa och målgrenar bredvid grennamnen. När PR är aktiv försvinner den här ikonen, men du kan fortfarande ändra målgrenen för PR.

Skärmbild av ikonen för växelkälla och målgrenar.

Använda pull-begärandemallar

En pull-begärandemall är en fil som innehåller Markdown-text som fyller i PR-beskrivningen när du skapar en PR. Bra PR-beskrivningar talar om för PR-granskare vad de kan förvänta sig och kan hjälpa till att spåra uppgifter som att lägga till enhetstester och uppdatera dokumentationen. Ditt team kan skapa en standard-PR-mall som lägger till text i alla nya PR-beskrivningar på lagringsplatsen. Du kan också välja från grenspecifika mallar eller andra mallar som ditt team definierar. Mer information om hur du skapar och använder PR-mallar finns i Förbättra beskrivningar av pull-begäranden med hjälp av mallar.

Om lagringsplatsen har en standardmall har alla PR:er på lagringsplatsen standardmallens beskrivningstext när den skapas. Om du vill lägga till andra mallar väljer du Lägg till en mall och väljer sedan en mall i listrutan. Du kan redigera malltexten i beskrivningen, ta bort den eller lägga till annan text.

Skärmbild som visar Lägg till en mall när du skapar en P R.

Skapa utkast till PR:ar

Om din pr inte är redo för granskning kan du skapa ett utkast till pr för att ange pågående arbete. När pr är redo för granskning kan du publicera den och påbörja eller återuppta den fullständiga granskningsprocessen.

Utkast till PR:ar har följande skillnader jämfört med publicerade pr:ar:

  • Skapa valideringsprinciper körs inte automatiskt. Du kan köa byggvalidering manuellt genom att välja menyn Fler alternativ i PR.

  • Röstning är inaktiverat i utkastläge.

  • Nödvändiga granskare läggs inte till automatiskt. Meddelanden skickas endast till granskare som du uttryckligen lägger till i utkastet till PR.

  • Utkast-PR:er visas i PR-listan med ett utkastmärke .

    Skärmbild som visar ett utkast till P R i P R-listan.

Kommentar

För att skapa utkast till PR:er krävs azure DevOps Server 2019.1-uppdatering eller senare version.

Om du vill skapa ett utkast till pr väljer du pilen bredvid Skapa och väljer Skapa som utkast när du skapar PR. Du behöver inte använda rubrikprefix som WIP eller KOPPLA INTE.

Skärmbild som visar Skapa som utkast P R.

När du är redo att granska och slutföra pr:en väljer du Publicera längst upp till höger i PR. När du publicerar en PR tilldelas nödvändiga granskare, principer utvärderas och röstningen startas.

Skärmbild som visar Publicera för en P R.

Om du vill ändra en befintlig publicerad PR till ett utkast väljer du Markera som utkast. Om du markerar en PR som utkast tar alla befintliga röster bort.

Skärmbild som visar Markera som utkast.

Lägg till eller redigera namn och beskrivning för pull-begäran

På sidan Ny pull-begäran anger du en rubrik och en detaljerad beskrivning av dina ändringar, så att andra kan se vilka problem ändringarna löser. På en ny PR som i befintliga PR:er kan du se filer och incheckningar i din PR på separata flikar. Du kan lägga till granskare, länka arbetsobjekt och lägga till taggar i PR.

När du är redo att granska ändringarna väljer du Skapa för att skapa pr.en.

Skärmbild som visar hur du skapar en ny P R.

Lägga till information i en ny P R.

Oroa dig inte om du inte har alla arbetsobjekt, granskare eller information redo när du skapar din PR. Du kan lägga till eller uppdatera dessa objekt när du har skapat PR.

Redigera PR-rubrik och beskrivning

Håll PR-rubriken och beskrivningen uppdaterade så att granskarna kan förstå ändringarna i PR.

Du kan uppdatera rubriken för en befintlig PR genom att välja den aktuella rubriken och uppdatera texten. Välj ikonen Spara för att spara ändringar eller välj ikonen Ångra för att ignorera ändringarna.

Redigera PR-beskrivningen genom att välja ikonen Redigera i avsnittet Beskrivning .

Skärmbild som visar hur du redigerar P R-rubriken och väljer knappen Redigera beskrivning.

Lägga till granskare i en pull-begäran

Du kan lägga till granskare i avsnittet Granskare i en ny eller befintlig PR. Du kan också göra befintliga valfria granskare obligatoriska eller ändra nödvändiga granskare till valfria eller ta bort dem, såvida de inte krävs av principen.

Förgreningsprinciper kan kräva ett minsta antal granskare eller automatiskt inkludera vissa valfria eller obligatoriska granskare i pr-flöden. Du kan inte ta bort granskare som krävs av grenprincipen. Du kan ändra valfria granskare för grenprinciper så att de krävs eller ta bort dem.

Om du vill se den grenprincip som automatiskt lade till en granskare högerklickar du på Fler alternativ bredvid granskaren i avsnittet Granskare på sidan PR-översikt.

Skärmbild som visar Visa princip på en granskare som automatiskt ingår i grenprincipen.

Om den användare eller grupp som du vill granska din pr inte är medlem i projektet måste du lägga till dem i projektet innan du kan lägga till dem som granskare.

Så här lägger du till granskare i en ny PR:

  1. På sidan Ny pull-begäran går du till Granskare och väljer Sök användare och grupper att lägga till som granskare.
  2. När du anger ett namn eller en e-postadress visas en listruta med matchande användare och grupper. Välj namn i listan som ska läggas till som valfria granskare.
  3. Om du vill lägga till nödvändiga granskare väljer du Lägg till nödvändiga granskare och väljer sedan Sök för att lägga till nödvändiga granskare att söka efter och välja namnen.

Skärmbild av att lägga till en granskare i en ny P R.

Så här lägger du till granskare i en befintlig PR:

  1. I avsnittet Granskaresidan Översikt väljer du Lägg till och väljer sedan Nödvändig granskare eller Valfri granskare.

    Översikt över pull-begäran

  2. När du anger ett namn eller en e-postadress visas en lista med matchande användare eller grupper. Välj de namn som ska läggas till som granskare.

    Lägg till P R-granskare.

Om du vill ändra en granskare mellan obligatoriskt och valfritt eller ta bort en granskare väljer du Fler alternativ till höger om granskarens namn. Om du vill se medlemskap i en grupp eller ett team som har utsetts till granskare väljer du gruppens ikon.

Så här länkar du arbetsobjekt till en ny PR:

  1. På sidan Ny pull-begäran går du till Arbetsobjekt som ska länkas och väljer Sök efter arbetsobjekt efter ID eller rubrik.
  2. Börja ange ett arbetsobjekts-ID eller en rubrik och välj det arbetsobjekt som ska länkas från listrutan som visas. Sök efter rubrik returnerar arbetsobjekt filtrerade efter tillstånd. alla arbetsobjekt med tillståndskategorier slutförda och borttagna undantas. Dessa arbetsobjekt filtreras också efter datum och användare, med endast objekt som skapats eller uppdaterats under de senaste 30 dagarna som visas, och de bör skapas av, tilldelas till eller auktoriseras som den aktuella användaren.

Så här länkar du arbetsobjekt till en befintlig PR:

  1. På fliken PR-översikt går du till området Arbetsobjekt och väljer +.

    Skärmbild som visar hur du väljer fliken Översikt och avsnittet arbetsobjekt.

  2. Ange ID för arbetsobjektet eller sök efter arbetsobjektets rubrik. Välj arbetsobjektet i listan som visas.

Ta bort en länk för arbetsobjekt genom att välja x-ikonen bredvid arbetsobjektet. Om du tar bort en länk tas bara länken mellan arbetsobjektet och PR bort. Länkar som skapats i grenen eller från incheckningar finns kvar i arbetsobjektet.

Så här länkar du arbetsobjekt till din PR:

  1. Välj fliken Översikt i PR.

    Skärmbild som visar hur du väljer fliken Översikt och knappen länkobjekt.

  2. Välj knappen Lägg till i området Arbetsobjekt . Lägg till ikon i PRs

  3. Ange ID för arbetsobjektet eller sök efter arbetsobjekt med rubriker som matchar texten. Välj arbetsobjektet i listan som visas. Sök efter rubrik returnerar arbetsobjekt filtrerade efter tillstånd. alla arbetsobjekt med tillståndskategorier slutförda och borttagna undantas. Dessa arbetsobjekt filtreras också efter datum och användare, med endast objekt som skapats eller uppdaterats under de senaste 30 dagarna som visas, och de bör skapas av, tilldelas till eller auktoriseras som den aktuella användaren.

Ta bort länkar för arbetsobjekt genom att välja knappen Ta bort som visas när du hovrar över arbetsobjektet. knappen ta bort Om du tar bort en länk tas bara länken mellan ett arbetsobjekt till en PR bort. Länkar som skapats i grenen eller från incheckningar finns kvar i arbetsobjektet.

Lägga till taggar i en pull-begäran

Använd taggar för att visa viktig information och hjälpa till att organisera PR. Taggar kan förmedla extra information till granskare, till exempel att PR fortfarande är ett pågående arbete eller är en snabbkorrigering för en kommande version.

Skärmbild som visar RS med taggar.

Om du vill lägga till en tagg när du skapar en PR skriver du ett taggnamn i avsnittet Taggar . När du har skapat PR kan du hantera taggar i avsnittet Taggar .

Skärmbild som visar avsnittet P R-taggar markerat.

Lägga till bifogade filer i pull-begäranden

Du kan bifoga filer, inklusive bilder, till din PR under eller efter skapandet. Välj gemikonen under fältet Beskrivning eller dra och släpp filer direkt till fältet Beskrivning i PR.

Skärmbild som visar hur du kopplar filer till P R-beskrivningen under skapandet.

Ändra målgrenen för en aktiv pull-begäran

För de flesta team riktar nästan alla PR:er in sig på en standardgren, till exempel main eller develop. Om du ibland behöver rikta in dig på en annan gren är det lätt att glömma att ändra målgrenen när du skapar PR. Om det händer kan du ändra målgrenen för en aktiv PR:

  1. Välj Fler åtgärder uppe till höger på sidan PR-översiktoch välj sedan Ändra målgren i listrutan.
  2. I fönstret Ändra målgren väljer du Välj en målgren, väljer den nya grenen och väljer sedan Ändra.

E-posta pull-begärandemeddelanden till intressenter

Du kan dela en pull-begäran via e-post för att meddela granskare och kommunicera med gruppmedlemmar. Så här delar du en PR:

  1. Välj Fler alternativ på sidan PR-översikt och välj sedan Dela pull-begäran.

    Skärmbild som visar hur du väljer Dela pull-begäran på en P R-översiktssida.

  2. På skärmen Dela pull-begäran lägger du till mottagare genom att skriva deras namn i fältet Till: och välja bland de användarnamn som visas. Du kan också ta bort mottagare.

  3. Lägg till ett valfritt meddelande i fältet Anteckning (valfritt) och välj sedan Skicka. Mottagarna får ett e-postmeddelande som begär deras uppmärksamhet och länkar till PR.

Kommentar

Om du använder den inbyggda e-postfunktionen kan du bara skicka e-postmeddelandet till projektmedlemmarnas enskilda adresser. Det går inte att lägga till en grupp eller säkerhetsgrupp på raden Till: . Om du lägger till ett e-postkonto som systemet inte känner igen får du ett meddelande om att en eller flera mottagare av e-postmeddelandet inte har behörighet att läsa pull-begäran.

För att e-postfunktionen ska fungera måste administratören för Azure DevOps Server konfigurera en SMTP-server.

Nästa steg