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:
- Om du inte har ett projekt, skapa ett eller registrera dig gratis.
- Om du inte är projektmedlem lägga till.
- 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:
-
Azure DevOps CLI: Du kan skapa och hantera PR:er från Azure-kommandoradsgränssnitt (CLI) med
azure-devops
-tillägget. Mer information finns i Komma igång med Azure DevOps CLI.- Azure Repos CLI-kommandon för PRs använder
az repos pr
.
- Azure Repos CLI-kommandon för PRs använder
-
Azure DevOps CLI: Du kan skapa och hantera PR:er från Azure-kommandoradsgränssnitt (CLI) med
-
Å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:
- Sidan för pull-begäranden.
- En funktionell gren som har pushats till ditt repo.
- En befintlig PR genom att använda cherry-pick.
- Utvecklingskontrollen i ett länkat Azure Boards-arbetsobjekt.
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.
På sidan Repos>Pull requests väljer du Ny pull request uppe till höger.
Välj grenen med ändringarna och den gren som du vill sammanfoga ändringarna i, till exempel huvudgrenen.
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:
På sidan Files:
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.
Öppna ett arbetsobjekt som är länkat till grenen i Azure Boards, från Arbetsuppgifter eller Frågor i vyn Arbete.
I området Utveckling i arbetsobjektet väljer du Skapa en pull-begäran.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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:
- På sidan Ny pull-begäran under Granskareväljer du Sök efter användare och grupper som ska läggas till som granskare.
- 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.
- 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.
Så här lägger du till granskare i en befintlig PR:
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
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.
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.
Länka arbetsobjekt till en pull-begäran
Så här länkar du arbetsobjekt till en ny PR:
- På sidan Ny pull-begäran under Arbetsobjekt för att länkaväljer du Sök efter arbetsobjekt efter ID eller rubrik.
- 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:
På fliken Översikt för PR
, under området Arbetsobjekt , välj. 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:
Välj fliken Översikt i PR.
Välj knappen Lägg till i området Arbetsobjekt.
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. 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.
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.
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.
Ä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:
- Välj Fler åtgärder längst upp till höger på PR Översikt-sidan och välj sedan Ändra målgren i listrutan.
- 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:
Välj
Fler alternativ på sidan Översikt för pr-och välj sedan Dela pull-begäran .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.
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.