Dela via


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 i 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:er och ge feedback på ä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 för att du ska kunna 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

  • Åtkomst:
    • Grundläggande åtkomst: Om du vill visa eller granska pr:er bör du vara medlem i ett Azure DevOps-projekt med minst grundläggande åtkomst.
    • Intressentåtkomst: För offentliga projekt har användare som beviljats intressentåtkomst fullständig åtkomst till Azure Repos.
  • Behörigheter:
    • Repo aktiverade: Repo måste vara aktiverade i projektet. Om Repos-hubben och tillhörande sidor inte visas, se Aktivera eller inaktivera en Azure DevOps-tjänst för att återaktivera Repos.
    • Projektmedlemskap:
    • Läsares säkerhetsgrupp: Om du vill bidra till en pr måste du vara medlem i säkerhetsgruppen Läsare eller ha motsvarande behörigheter.
    • Säkerhetsgruppen för deltagare: För att skapa och slutföra en PR måste du vara medlem i säkerhetsgruppen Deltagare eller ha motsvarande behörigheter.
  • Verktyg:
  • Åtkomst:
    • Grundläggande åtkomst: Om du vill visa eller granska pr:er bör du vara medlem i ett Azure DevOps-projekt med minst grundläggande åtkomst. Om du inte är projektmedlem lägga till.
  • behörigheter:
    • Lagringsplatser aktiverade: Lagringsplatser måste vara aktiverade i ditt projekt. Om Repo-hubben och tillhörande sidor inte visas, kan du läsa Aktivera eller inaktivera en Azure DevOps-tjänst för att återaktivera Repos.
    • Läsares säkerhetsgrupp: För att bidra till en PR kan du vara medlem i säkerhetsgruppen Läsare eller ha motsvarande behörigheter.
    • Deltagares säkerhetsgrupp: För att skapa och slutföra en PR måste du vara medlem i säkerhetsgruppen Deltagare eller ha motsvarande behörigheter.

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

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 Pull-begäranden sidan på webben.

  1. På sidan Repos>Pull requests väljer du Ny pull request uppe till höger.

    Skärmbild av knappen Ny pull request.

  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 Pullförfrågningar:

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

  • På sidan Files:

    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 i Azure Boards, från Arbetsuppgifter eller Frågor i vyn Arbete.

  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 commits från en gren till en annan med hjälp av "cherry-pick". Till skillnad från en sammanslagning eller rebase, tar cherry-pick bara med sig ändringarna från de commits du väljer, istället för alla ändringar i en gren.

Välj Cherry-pick på PR:ens översiktssida för att hämta ändringar från en slutförd PR. Om du vill kopiera ändringar från en aktiv PR väljer du Cherry-pick från PR:s Fler alternativ-menyn. 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. För detaljerade instruktioner, se Kopiera ändringar med kommandot cherry-pick.

Byt käll- och målgrenar för din pull-förfrågan

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:n är aktiv försvinner den här ikonen, men du kan fortfarande ändra målgren för PR:n.

Skärmbild av ikonen för att växla käll- och målgrenar.

Använda pull-begärandemallar

En pull request-mall ä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 byggvalideringar manuellt genom att välja menyn Fler alternativ i PR:n.

  • 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 märke för utkast.

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

Obs

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. Att publicera en PR tilldelar nödvändiga granskare, utvärderar policyer och startar röstningen.

Skärmbild som visar Publicera för en PR.

Om du vill ändra en befintlig publicerad PR till ett utkast väljer du Markera som utkast. Om du markerar en PR som utkast, tas 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 request 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 Files och Commits 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 dina ändringar väljer du Skapa för att skapa PR.

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 om du vill 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ägg till granskare i en pull request

Du kan lägga till granskare i sektionen Granskare i en ny eller befintlig PR. Du kan också göra befintliga valfria granskare obligatoriska eller ändra obligatoriska granskare till valfria eller ta bort dem, om de inte krävs av en policy.

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 att valfria granskare för policy för grenen ska vara obligatoriska eller ta bort dem.

För att se grenprincipen som automatiskt lade till en granskare, högerklicka på Fler alternativ bredvid granskaren i avsnittet Granskare på sidan PR-Översikt.

Skärmbild som visar en policy för en granskare som automatiskt ingår i en grenpolicy.

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 under Granskareväljer du Sök efter användare och grupper som ska läggas 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 granskareoch 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 Granskare på sidan Översikt väljer du Lägg tilloch väljer sedan Nödvändig granskare eller Valfri granskare.

    översikt över pull request

  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 under Arbetsobjekt för att länkaväljer du 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ånd som har 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 Översikt för PR , under området Arbetsobjekt, välj .

    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 arbetsobjektlänk genom att välja ikonen x 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 commits 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 en ikon i PR:er

  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ånd som har 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. ta bort-knappen Om du tar bort en länk tas bara länken mellan ett arbetsobjekt och en PR bort. Länkar som skapas i grenen eller från ändringar behålls 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: visar P 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 när du skapar.

Ä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 längst upp till höger på PR Översikt-sidan och 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 Översikt för pr-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 Note (Valfritt) och välj sedan Skicka. Mottagarna får ett e-postmeddelande som begär deras uppmärksamhet och länkar till PR.

Not

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 arbetsgrupp eller säkerhetsgrupp i Till: raden. 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