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
| Kategori | Krav |
|---|---|
| Åtkomstnivåer | – Visa eller granska PR:er: Minst grundläggande åtkomst. För offentliga projekt har de användare som har intressentåtkomst fullständig åtkomst till Azure Repos. |
| behörigheter | - Bidra till en PR: Medlem i Läsare säkerhetsgrupp eller motsvarande behörighet. – Skapa och slutför en PR: Medlem i kontributörer säkerhetsgrupp eller motsvarande behörighet. |
| Tjänster | Repos aktiverat. |
| Verktyg | Azure DevOps CLI. |
| Kategori | Krav |
|---|---|
| Åtkomstnivåer | – Visa eller granska PR:er: Minst Grundläggande åtkomst. |
| behörigheter | - Bidra till en PR: Medlem i säkerhetsgruppen Läsare eller med motsvarande behörigheter. – Skapa och slutför en PR: Medlem i deltagare säkerhetsgrupp eller motsvarande behörigheter. |
| Tjänster | Repos aktiverat. |
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 pushad 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.
I Azure Boards, öppna ett arbetsobjekt som är länkat till grenen från Kvarvarande uppgifter eller Frågeuppgifter 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.
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 DO NOT MERGE.
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. I en ny PR, i likhet med befintliga PR:er, kan du se filer och kommandon 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å ändra valfria granskare till obligatoriska, ä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 PRs. Du kan inte ta bort granskare som krävs av grenprincipen, men du kan ändra valfria granskare till obligatoriska eller ta bort dem.
Om du vill se den grenprincip som automatiskt lade till en granskare högerklickar du 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 lägga till dem i projektet innan du kan lägga till dem som granskare.
Gör följande för att lägga 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.
Gör följande för att lägga 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 om du vill ta bort en granskare väljer du Fler alternativ (⋮) till höger om granskarens namn. Om du vill visa 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
Gör följande för att länka 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 kategoriserade som Slutförda och Borttagna undantas.
- Dessa arbetsobjekt filtreras också efter datum och användare, som endast visar objekt som skapats eller uppdaterats under de senaste 30 dagarna. De bör skapas av, tilldelas till eller auktoriseras som den aktuella användaren.
Gör följande för att länka 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.
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 nedanför fältet Beskrivning eller dra och släpp filer direkt in i 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.
Skicka meddelanden om pull-begäranden via e-post 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 för Ö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.
Obs
När du använder den inbyggda e-postfunktionen kan du bara skicka e-postmeddelanden till enskilda projektmedlemmars adresser. Det går inte att lägga till en arbetsgrupp eller säkerhetsgrupp i Till: raden. Om du lägger till en okänd e-postadress får du ett meddelande som anger att en eller flera mottagare inte har behörighet att läsa pull-begäran via e-post.
För att e-postfunktionen ska fungera måste administratören konfigurera en SMTP-server.