Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Du skapar pull-begäranden (PR) för att granska och slå samman kodändringar på en Git-lagringsplats på Azure Repos. Gruppmedlemmar och intressenter kan granska ändringar och ge feedback innan de sammanfogar koden i målgrenen. Granskare kan också kommentera ändringar och rösta för att godkänna eller avvisa koden.
Teams kan kräva PR för alla ändringar i skyddade grenar och ange grenprinciper för att kräva att vissa PR:er uppfyller specifika kriterier.
Det finns flera sätt att lista, filtrera, visa och öppna PR:er för ett projekt.
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 PR:er måste du vara medlem i Azure DevOps-projektet som PR:en finns i, med grundläggande åtkomst eller högre. Om du inte är projektmedlem läggs du till.
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 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 visa en lista över PR:er i en specifik lagringsplats i ett projekt går du till projektet i webbportalen och väljer Repos Pull requests (Repos>Pull requests).
Kontrollera att du har valt rätt lagringsplats.
Standardvyn visar dina PR:er under fliken Gruva . Välj Aktiv om du vill visa alla aktiva PR:er för den aktuella lagringsplatsen. Välj Slutförd eller Övergiven för att visa listor över stängda prs.
Välj valfri PR i listan för att gå till pr-sidan Översikt .
Du kan visa en lista över alla dina PR:er i olika projekt i organisationen genom att välja Pull-begäranden i vyn Mitt arbete .
Om du vill visa pull-begäranden från Visual Studio går du till Git-menyn och väljer <dina Pull-begäranden för Git-tjänstens>>vy.
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:
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/.
--project-p
Projektets namn eller ID. Du kan konfigurera standardprojektet med hjälp az devops configure -d project=<NAME_OR_ID>av . Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration.
--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.
--repository-r
Namn eller ID för lagringsplatsen.
--reviewer
Begränsa resultatet till pull-begäranden där den här användaren är granskare.
--skip
Antal pull-begäranden att hoppa över.
--source-branch-s
Begränsa resultatet till pull-begäranden som kommer från den här källgrenen.
--status
Begränsa resultatet till pull-begäranden med den här statusen. Accepterade värden: abandoned, active, all, completed.
--subscription
Namn eller ID för Azure-prenumeration. Du kan konfigurera standardprenumerationen med hjälp az account set -s <NAME_OR_ID>av .
--target-branch-t
Begränsa resultatet till pull-begäranden som riktar sig mot den här grenen.
--top
Maximalt antal pull-begäranden som ska listas.
Exempel
Följande kommando visar alla PR:er på lagringsplatsen, oavsett status, och visar utdata i en tabell. I exemplet används standardkonfigurationen az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".
az repos pr list --status all --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------------------------- --------- --------- ------------
11 2021-10-04 jamalh@fabrikam.com Revert 'Updated parameterized-functions.md' Completed False Fabrikam
10 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Completed False Fabrikam
9 2021-10-04 ke@fabrikam.com New pull request Completed False Fabrikam
8 2021-10-04 jamalh@fabrikam.com Updated parameterized-functions.md Abandoned False Fabrikam
7 2021-09-30 jamalh@fabrikam.com Added note-new-git-tool.md to / Completed False Fabrikam
6 2021-09-29 jamalh@fabrikam.com Revert 'Added parameterized-functions.md to /' Abandoned False Fabrikam
5 2021-09-29 jamalh@fabrikam.com Updated README.md Completed False Fabrikam
4 2021-09-29 jamalh@fabrikam.com Added parameterized-functions.md to / Completed False Fabrikam
3 2021-09-28 jamalh@fabrikam.com WIP New file Abandoned False Fabrikam
2 2021-09-28 jamalh@fabrikam.com Update README.md Abandoned False Fabrikam
1 2021-09-28 jamalh@fabrikam.com Edit README.md Completed False Fabrikam
Azure DevOps CLI-kommandon stöds inte för Azure DevOps Server.
Definiera en anpassad vy för pull-begäranden
Genom att filtrera PR-listan kan du hitta och organisera pr för att prioritera de viktigaste filerna i arbetsflödet.
Om du vill filtrera PR-listan går du till sidan Pull-begäranden och väljer filterikonen längst upp till höger. Välj sedan Målgren eller annan kolumnrubrik och välj den gren eller annat värde som du vill filtrera på.
Om du vill anpassa vyn för PR-listan ytterligare väljer du Anpassa vy längst upp till höger på sidan Pull-begäranden .
På sidan Anpassa vy kan du ordna om de aktuella vyavsnitten, redigera dem eller ta bort dem. Om du vill skapa ett nytt avsnitt väljer du Lägg till avsnitt.
På sidan Anpassa avsnitt anger och väljer du värden för att filtrera avsnittet efter parametrar som utkasttillstånd eller uppdaterat datum. Du kan välja om du vill Visa pull-begäranden som jag har godkänt eller avvisat på en separat flik eller Exkludera pull-begäranden (dubbletter) som ingår i föregående avsnitt. När du är klar med anpassningen av vyn väljer du Spara.
Dessa anpassade vyer skapar separata, komprimerbara avsnitt på pull-begärandesidan. De här anpassade frågorna fungerar även mellan lagringsplatser på fliken Mina pull-begäranden på organisationens startsida.
Om du vill ändra parametrarna för de anpassade vyerna väljer du knappen Anpassa bredvid vyn. Eller välj Anpassa vy och välj den vy som du vill ändra på skärmen Anpassa vy. Vissa vyer, till exempel Tilldelade till mig, kan inte anpassas, men de kan ordnas om eller tas bort.
På fliken PR-filer kan du använda flera filter för att välja filer och kommentarer för snabbare granskningar. Välj Filter och välj sedan bland alternativen.
Nyckelord: Ange ett nyckelord.
Granskad/ej granskad: Alla (standard), Väntande, Granskade.
Kommenterade filer: Alla filer (standard), Filer med kommentarer.
Kommentarer: Visa (standard), Nyheter, Dölj.
Kommentarsstatus: Aktiv (standard), Väntar, Löst, Enligt design, Kommer inte att åtgärda, Stängd.
Kommenterad av: Alla kommentarer (standard) eller en specifik person.
Du kan också skriva in en sträng i fältet Sök för att visa matchande resultat från föregående alternativ.
Så här filtrerar du pull-begäranden från Visual Studio:
I Git-menyn väljer du <dina Pull-begäranden för Git-tjänstens vy>>.
Filtrera efter författare, etikett eller andra attribut.
Från vyn Pull Requests för Team Explorer:
Välj Aktiv eller Tilldelad till mig eller mitt team för att filtrera PR-listorna efter PR-status eller tilldelning.
Du kan också skriva in typen här för att filtrera listfälten för att filtrera PR-listorna efter datum, författare, gren eller andra attribut.
Du kan använda flera az repos pr list-parametrar för att filtrera listan över prs, till exempel --creator, --project, --repository, --reviewer, --source-branch, --status, --target-branchoch --top.
Värdena --creator och --reviewer kan vara visningsnamn eller e-postadresser. Parametern --top definierar det maximala antalet PR:er som ska listas.
Om du till exempel vill visa information om den senaste pr-begäran som du skapade, oavsett status, använder du:
az repos pr list --creator "My Name" --status all --top 1
Azure DevOps CLI-kommandon stöds inte för Azure DevOps Server.
Öppna en pull-begäran
När du öppnar en PR från webbläsaren, från Visual Studio eller från Azure CLI öppnas sidan PR-översikt i webbläsaren.
Om du vill öppna en PR i webbläsaren väljer du PR i listan på sidan Pull-begäranden . PR öppnas på fliken Översikt . Fliken Översikt visar PR-rubrik, beskrivning, granskare, länkade arbetsobjekt, historik och status. Du kan se en sammanfattning av grenprinciper som skickas eller misslyckas och se kommentarer som granskare har gjort.
På fliken PR-filer kan du granska de faktiska ändringarna i PR-filerna. På flikarna Uppdateringar och incheckningar kan du se ändringar som författaren har gjort för att uppdatera PR-grenen.
Om du vill öppna en pull-begäran från Visual Studio går du till Git-menyn, väljer< dina Pull-begäranden för Git-tjänstens vy>>och väljer sedan en pull-begäran för att öppna den.
I vyn Pull Requests (Pull-begäranden för Team Explorer) högerklickar du på PR och väljer Öppna i webbläsaren för att öppna PR i webbportalen.
Kolla in en gren
I Visual Studio 2019 kan du kolla in en PR-källgren direkt från vyn Pull-begäranden . Högerklicka på en PR och välj Checkout Source Branch (Checkout Source Branch).
Kommentar
Visual Studio 2019 version 16.8 och senare versioner ger en ny Git-meny för att hantera Git-arbetsflödet med mindre kontextväxling än Team Explorer. Procedurer som anges i den här artikeln under fliken Visual Studio innehåller information om hur du använder Git-upplevelsen och Team Explorer. Mer information finns i Jämförelse sida vid sida av Git och Team Explorer.
Om du vill visa information om en enskild PR använder du az repos pr show med den obligatoriska --id parametern. Om du vill öppna PR i webbläsaren använder du --open.
az repos pr show --id
[--detect {false, true}]
[--open]
[--org]
[--query-examples]
[--subscription]
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.
--subscription
Namn eller ID för Azure-prenumeration. Du kan konfigurera standardprenumerationen med hjälp az account set -s <NAME_OR_ID>av .
Exempel
I följande exempel visas information om PR #21, kommandoutdata som en tabell och öppnar PR i webbläsaren:
az repos pr show --id 21 --open --output table
ID Created Creator Title Status IsDraft Repository
---- ---------- ------------------- ---------------------------- -------- --------- ------------
21 2021-10-31 jamalh@fabrikam.com Updated note-new-git-tool.md Active False Fabrikam
Kolla in en gren
Använd az repos pr checkout med den obligatoriska --id parametern för att checka ut en PR-gren lokalt, så länge det inte finns några lokala ändringar.
az repos pr checkout --id
[--remote-name]
[--subscription]
Parametrar
Parameter
Description
--id
ID för pull-begäran.
--remote-name
Namnet på den git-fjärranslutning som PR är upphöjt till. Standardvärde: origin.
--subscription
Namn eller ID för Azure-prenumeration. Du kan konfigurera standardprenumerationen med hjälp az account set -s <NAME_OR_ID>av .
Exempel
Om du till exempel vill checka ut grenen för PR #21 lokalt använder du:
az repos pr checkout --id 21
Azure DevOps CLI-kommandon stöds inte för Azure DevOps Server.
Om du vill granska ändringar, göra kommentarer eller förslag eller godkänna eller rösta på PR läser du Granska pull-begäranden.
Visa och uppdatera pull-begäranden från en mobil enhet
Du kan använda mobila enheter för att visa alla Azure Repos PR-skärmar och vidta åtgärder.