Dokončení, opuštění nebo vrácení žádostí o přijetí změn

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

Visual Studio 2019 | Visual Studio 2022

Jakmile všichni povinní kontroloři schválí vaši žádost o přijetí změn a žádost o přijetí změn splní všechny požadavky zásad větve, můžete změny sloučit do cílové větve a dokončit žádost o přijetí změn. Nebo pokud se rozhodnete pokračovat ve změnách žádosti o přijetí změn, můžete žádost o přijetí změn opustit.

Pokud chcete řešit změny revidujících a reagovat na komentáře ke kontrole a vyřešit je, přečtěte si téma Komentáře k adrese.

Požadavky

• Úložiště musí být ve vašem projektu povolená. Pokud se centrum Repos a přidružené stránky nezobrazují, přečtěte si téma Zapnutí nebo vypnutí služby Azure DevOps a opětovné povolení úložišť.

• K dokončení žádosti o přijetí změn musíte být členem skupiny zabezpečení Přispěvatelé nebo mít odpovídající oprávnění v projektu, ve které se žádost o přijetí změn nachází.

• Abyste mohli přispívat k žádosti o přijetí změn, musíte být členem skupiny zabezpečení Čtenáři nebo mít odpovídající oprávnění.

• Pokud chcete zobrazit nebo zkontrolovat žádosti o přijetí změn, musíte mít k projektu Azure DevOps základní nebo vyšší přístup.

• Pokud nejste členem projektu, do kterého chcete přispívat, můžete přidat.

  Poznámka:

  U veřejných projektů mají uživatelé udělený přístup účastníka k Azure Repos plný přístup.

• Další informace ooprávněních

• V Azure DevOps Services můžete spravovat žádosti o přijetí změn a další prostředky z rozhraní příkazového řádku Azure (CLI) s rozšířením azure-devops . Informace o tom, jak pracovat s rozhraním příkazového řádku Azure DevOps Services, najdete v tématu Začínáme s Azure DevOps CLI. Příkazy rozhraní příkazového řádku Azure Repos pro žádosti o přijetí změn používají příkazy az repos pr.

Kontrola změn sloučení

Po dokončení žádosti o přijetí změn Git přidá na konec hlavní větve nové potvrzení sloučení. Toto sloučení potvrzení propojuje dřívější historie hlavní větve a zdrojové větve žádosti o přijetí změn. Pokud chcete zobrazit náhled potvrzení sloučení a zkontrolovat konflikty při sloučení, vyberte nabídku Další možnosti v pravém horním rohu na stránce Přehled žádosti o přijetí změn a pak vyberte Zobrazit změny sloučení.

Pokud jste po vytvoření žádosti o přijetí změn změnili cílovou větev, výběrem možnosti Restartovat sloučení vytvořte nové potvrzení sloučení ve verzi Preview a aktualizujte zobrazení rozdílu změn sloučení.

Kontrola zásad větví

Týmy můžou nastavit zásady větví, které vyžadují žádosti o přijetí změn v chráněných větvích, aby splňovaly konkrétní kritéria před sloučením žádostí o přijetí změn. Pro vaši žádost o přijetí změn uvidíte zásady větví, jestli jsou potřeba ke sloučení a jestli žádost o přijetí změn předává nebo selhává.

Prohlížeč

Karta Přehled žádosti o přijetí změn shrnuje zásady větví, které se předávají nebo selhávají pro žádost o přijetí změn. Přehled obsahuje jenom neúspěšné zásady, ale všechny kontroly zásad můžete zobrazit výběrem možnosti Zobrazit <n> kontrol.

Na stránce Přehled žádosti o přijetí změn mají požadavky na zásady větví ikonu. Vyberte Další možnosti vedle požadavku a pak výběrem možnosti Zobrazit zásadu přejděte na stránku Zásady větve v Projectu Nastavení.

Visual Studio

Žádost o přijetí změn můžete otevřít v sadě Visual Studio a pak zkontrolovat zásady větví, jak je popsáno na kartě Prohlížeč.

Pokud chcete otevřít žádost o přijetí změn ze sady Visual Studio, v nabídce Git vyberte< svou službu>>Git View Pull Requests a výběrem žádosti o přijetí změn ji otevřete.

Visual Studio 2019 verze 16.8 a novější verze poskytují prostředí pro správu verzí Gitu při zachování uživatelského rozhraní Git Team Exploreru. Pokud chcete použít Team Explorer, zrušte zaškrtnutí políčka Možnosti nástrojů>>Ve verzi Preview Nové>uživatelské prostředí Gitu na řádku nabídek. Funkce Gitu můžete provádět zaměnitelně z libovolného rozhraní.

Přístup k žádosti o přijetí změn z Visual Studio Team Exploreru:

1. Připojení do projektu ze sady Visual Studio.

2. Výběrem možnosti Zobrazit>Team Explorer otevřete Team Explorer. Můžete také stisknout ctrl+\, Ctrl+M.

3. Na domovské stránce vyberte Žádosti o přijetí změn, abyste zobrazili seznamy žádostí o přijetí změn, které jste otevřeli vy nebo které jste jim přiřadili.

4. Pokud chcete na webovém portálu otevřít žádost o přijetí změn a zobrazit zásady, klikněte pravým tlačítkem myši na žádost o přijetí změn a vyberte Otevřít v prohlížeči.

Rozhraní příkazového řádku Azure DevOps

Pokud chcete zobrazit všechny zásady větve, které platí pro žádost o přijetí změn, použijte příkaz az repos pr policy list s požadovaným id parametrem.

az repos pr policy list --id
                        [--detect {false, true}]
                        [--org]
                        [--query-examples]
                        [--skip]
                        [--subscription]
                        [--top]

Parametry

Parametr	Popis
--id	ID žádosti o přijetí změn. Povinný:
--detect	Automaticky rozpozná organizaci. Přijaté hodnoty: false, true.
--org --organization	Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí .az devops configure -d organization=<ORG_URL> Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
--query-examples	Doporučený řetězec JMESPath Můžete zkopírovat jeden z dotazů a vložit ho --query za parametr v uvozovkách, aby se zobrazily výsledky. Můžete přidat jedno nebo více pozičních klíčových slov, takže návrhy jsou založené na těchto klíčových slovech.
--skip	Počet zásad, které se mají přeskočit
--subscription	Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí .az account set -s <NAME_OR_ID>
--top	Maximální počet zásad, které se mají zobrazit.

Příklad

Pokud chcete například zobrazit zásady, které platí pro pr č. 28, spusťte následující příkaz:

az repos pr policy list --id 28 --output table

Evaluation ID                         Policy                                         Blocking    Status    Expired    Build ID
------------------------------------  ---------------------------------------------  ----------  --------  ---------  ----------
84e7ca6d-0b42-4819-9f62-f41df5e319f3  Minimum number of reviewers (1)                True        Approved
1ba061d8-9e9f-401b-ab61-e2ed1c200aba  Required reviewers (1)                         True
37620a4b-adc4-483d-9ca2-3f4e6ffe2990  Comment requirements                           False       Approved
34b7cae8-812a-4c14-9229-f71a0e662e8b  Required reviewers (1) ([Fabrikam Fiber]\Web)  False
a6e4380e-9f38-4aa5-863c-0fc496027362  Work item linking                              False       Rejected

Dokončení žádosti o přijetí změn

Jakmile vyřešíte všechny konflikty při slučování a žádost o přijetí změn splňuje všechny zásady větví a má všechna požadovaná schválení, můžete žádost o přijetí změn dokončit.

Prohlížeč

1. Výběrem možnosti Dokončit v pravém horním rohu dokončete žádost o přijetí změn. Nebo vyberte šipku rozevíracího seznamu vedle tlačítka Dokončit a vyberte jednu z možností.

   

   • Dokončeno: Dokončete žádost o přijetí změn a sloučíte změny do cílové větve.
   • Nastavit automatické dokončování: Nakonfigurujte žádost o přijetí změn tak, aby se dokončila a sloučila, jakmile splňuje všechny požadované zásady větve.
   • Označit jako koncept: Vraťte žádost o přijetí změn do stavu konceptu a odeberte všechny hlasy.
   • Opuštění: Zavřete žádost o přijetí změn bez sloučení změn.

2. V podokně Dokončit žádost o přijetí změn v části Typ sloučení vyberte jednu z možností sloučení.

   

   • Sloučení (bez rychlého předávání):: Sloučit s nelineární historií, která zachovává všechna potvrzení.
   • Squash commit: Sloučení s lineární historií, která kombinuje všechny zdrojové potvrzení do jednoho potvrzení v cíli, nebo squash slučuje pr. Mějte na paměti, že pro cílovou větev se vytvoří nové potvrzení bez zachování historie potvrzení ze zdrojové větve.
   • Změna základu a rychlého přesměrování: Znovu naskladněte zdrojové potvrzení do cíle a rychle dopředu.
   • Pololineární sloučení: Rebase source commits to the target a create a two-parent merge.

   Poznámka:

   Vynucují se existující zásady. Pokud má například vaše větev aktuálně zásadu "squash merge only", musíte tuto zásadu změnit, pokud chcete použít jiný typ sloučení.

3. Vyberte některou z následujících možností po dokončení. Některé možnosti nejsou k dispozici pro některé typy sloučení.

   • Dokončení přidružených pracovních položek po sloučení: Dokončete všechny propojené pracovní položky.
   • Odstranit <název> větve po sloučení: Po sloučení odstraňte zdrojovou větev žádosti o přijetí změn.
   • Přizpůsobení zprávy potvrzení sloučení: Přidejte vlastní zprávu potvrzení sloučení. Pokud vyberete tuto možnost, aktualizujte zprávu potvrzení sloučení.
   • Přepište zásady větve a povolte sloučení. Sloučení vynuťte, i když žádost o přijetí změn nevyhovuje všem zásadám větve. Tato možnost je dostupná jenom v případě, že máte oprávnění k vynucování zásad vyloučené.

4. Vyberte Dokončit sloučení.

Po dokončení sloučení se všechny propojené pracovní položky automaticky aktualizují, aby se zobrazilo dokončení žádosti o přijetí změn.

Visual Studio

Pokud chcete žádost o přijetí změn dokončit, otevřete žádost o přijetí změn v prohlížeči a na stránce Přehled vyberte Dokončit nebo nastavte další možnosti.

Pokud chcete otevřít žádost o přijetí změn ze sady Visual Studio, v nabídce Git vyberte< svou službu>>Git View Pull Requests a výběrem žádosti o přijetí změn ji otevřete.

Přístup k žádosti o přijetí změn ze sady Visual Studio 2019 Team Explorer:

1. Připojení do projektu ze sady Visual Studio.

2. Výběrem možnosti Zobrazit>Team Explorer otevřete Team Explorer. Můžete také stisknout ctrl+\, Ctrl+M.

3. Na domovské stránce vyberte Žádosti o přijetí změn, abyste zobrazili seznamy žádostí o přijetí změn, které jste otevřeli vy nebo které jste jim přiřadili.

4. Pokud chcete otevřít žádost o přijetí změn na webovém portálu, klikněte pravým tlačítkem na žádost o přijetí změn a vyberte Otevřít v prohlížeči.

Rozhraní příkazového řádku Azure DevOps

K dokončení žádosti o přijetí změn a sloučení změn použijte příkaz az repos pr update a aktualizujte žádost o --status přijetí změn na completed.

Například k dokončení žádosti o přijetí změn č. 21 použijte:

az repos pr update --id 21 --status completed

Nastavení možností dokončení

Možnosti dokončení žádosti o přijetí změn můžete nastavit při vytváření žádosti o přijetí změn s možnostmi az repos pr createvytváření nebo při vytváření aktualizací v existujících žádostech o přijetí změn s az repos pr update.

Mezi možnosti dokončení žádosti o přijetí změn patří:

• bypass-policy {false, true}: Jestli chcete obejít požadované zásady a dokončit žádost o přijetí změn, jakmile bude možné ji sloučit.
• bypass-policy-reason: Důvod obejití požadovaných zásad.
• delete-source-branch {false, true}: Zda se má zdrojová větev odstranit po dokončení a sloučení žádosti o přijetí změn.
• merge-commit-message: Přizpůsobte zprávu potvrzení sloučení.
• squash {false, true}: Určuje, zda se zdrojové potvrzení zamknou do jednoho cílového potvrzení pro sloučení.
• transition-work-items {false, true}: Zda se mají vyřešit propojené pracovní položky při sloučení žádosti o přijetí změn.

Pokud chcete nastavit možnosti dokončení a dokončit existující žádost o přijetí změn, použijte az repos pr update s požadovaným id parametrem.

az repos pr update --id
                   [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--org]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--subscription]
                   [--title]
                   [--transition-work-items {false, true}]

Parametry

Parametr	Popis
--id	ID žádosti o přijetí změn. Povinný:
--auto-complete	Nastavte žádost o přijetí změn tak, aby se dokončila automaticky, když byly předány všechny zásady a zdrojová větev se dá sloučit do cílové větve. Přijaté hodnoty: false, true.
--bypass-policy	Vynechte všechny požadované zásady a dokončete žádost o přijetí změn, jakmile je možné ji sloučit. Přijaté hodnoty: false, true.
--bypass-policy-reason	Důvod obejití požadovaných zásad
--delete-source-branch	Odstraňte zdrojnou větev po dokončení žádosti o přijetí změn a sloučení do cílové větve. Přijaté hodnoty: false, true.
--description -d	Nový popis žádosti o přijetí změn Může obsahovat Markdown. Každá hodnota je nový řádek. Například: --description "First Line" "Second Line".
--detect	Automaticky rozpozná organizaci. Přijaté hodnoty: false, true.
--draft	Převeďte žádost o přijetí změn do režimu konceptu nebo ji publikujte. Přijaté hodnoty: false, true.
--merge-commit-message	Zpráva, která se má zobrazit při sloučení potvrzení
--org --organization	Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí .az devops configure -d organization=<ORG_URL> Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
--squash	Při slučování do cílové větve zamkni potvrzení ve zdrojové větvi. Přijaté hodnoty: false, true.
--status	Nastavte nový stav žádosti o přijetí změn. Přijaté hodnoty: abandoned, active, completed.
--subscription	Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí .az account set -s <NAME_OR_ID>
--title	Nový název žádosti o přijetí změn
--transition-work-items	Převést všechny pracovní položky propojené s žádostí o přijetí změn do dalšího logického stavu, například Vyřešeno. Přijaté hodnoty: false, true.

Příklad

Následující příklad dokončí žádost o přijetí změn č. 21, odstraní její zdrojovou větev, přeloží propojené pracovní položky a přidá zprávu potvrzení sloučení:

az repos pr update --id 21 --status completed --delete-source-branch true --transition-work-items true --merge-commit-message "This update is complete."

Změna základu během dokončování žádosti o přijetí změn

Při opětovném obnovení během dokončování žádosti o přijetí změn není možné provést několik situací:

• Pokud zásada v cílové větvi zakáže použití strategií pro změnu základu, potřebujete k opětovnému vytvoření základu oprávnění přepsat zásady větve.
• Pokud zdrojová větev žádosti o přijetí změn obsahuje zásady, nemůžete ji nabít znovu. Opětovnébasování by změnilo zdrojová větev bez toho, aby prošla procesem schvalování zásad.
• Pokud jste k řešení konfliktů při slučování použili rozšíření konfliktů při sloučení, nemůžete převést základ. Řešení konfliktů použitá u trojcestné sloučení jsou zřídka úspěšná nebo platná při opakovaném použití všech potvrzení žádosti o přijetí změn jednotlivě.

Ve všech těchto případech můžete svou větev znovu místně nasdílit a pak nasdílit upstream nebo po dokončení žádosti o přijetí změn změny znovu sloučit.

Problém s více základy sloučení

V některýchpřípadechch Pokud mají soubory v žádosti o přijetí změn v různých základech sloučení různé verze, zobrazí se upozornění na více základů sloučení. Další informace a náprava naleznete v tématu Více základů sloučení.

Vyřešení konfliktů při slučování

Změny souboru ve vaší větvi můžou být v konfliktu se změnami v jiné větvi. Pokud není jasné, jak sloučit změny, Git zobrazí soubory, které jsou v konfliktu na stránce Přehled žádosti o přijetí změn. Před sloučením žádosti o přijetí změn nebo nastavením žádosti o přijetí změn musíte vyřešit všechny konflikty při slučování mezi větví žádosti o přijetí změn a cílovou větví. Pokyny k řešení konfliktů při sloučení najdete v tématu Řešení konfliktů při slučování.

Nastavení žádosti o přijetí změn na automatické dokončování

Prohlížeč

V rozevíracím seznamu Dokončení vyberte Nastavit automatické dokončování, abyste dokončili a sloučili změny žádosti o přijetí změn, jakmile podmínky splňují všechny zásady větve. Po dokončení žádosti o přijetí změn obdržíte e-mailové oznámení. Pokud konflikt nebo chyba brání dokončení žádosti o přijetí změn, pošle vám e-mail oznámení o problému.

Poznámka:

Možnost Nastavit automatické dokončování je dostupná v Azure Repos a TFS 2017 a novějších, pokud máte zásady větví. Pokud možnost Nastavit automatické dokončování nevidíte, nemáte žádné zásady větve. Další informace najdete v tématu Zásady větve.

Ve výchozím nastavení čeká žádost o přijetí změn nastavená na automatické dokončování pouze u požadovaných zásad. Na panelu Povolit automatické dokončování můžete také počkat na volitelné zásady.

Od TFS 2018 Update 2 se na stránce Přehled žádosti o přijetí změn zobrazí seznam nevyřízených kritérií zásad, na která pr čeká. Pokud jste na panelu Povolit automatické dokončování nastavili požadovanou zásadu, můžete ji nastavit zpět na volitelnou na stránce Přehled .

Pokud chcete automatické dokončování vypnout, vyberte Zrušit automatické dokončování .

Žádost o přijetí změn nastavená na automatické dokončování zobrazí na stránce Žádosti o přijetí změn odznáček Automatické dokončování.

Visual Studio

Otevřete žádost o přijetí změn na webovém portálu. Na stránce Přehled vyberte Nastavit automatické dokončování.

Pokud chcete otevřít žádost o přijetí změn ze sady Visual Studio, v nabídce Git vyberte< svou službu>>Git View Pull Requests a výběrem žádosti o přijetí změn ji otevřete.

Přístup k žádosti o přijetí změn ze sady Visual Studio 2019 Team Explorer:

1. Připojení do projektu ze sady Visual Studio.

2. Výběrem možnosti Zobrazit>Team Explorer otevřete Team Explorer. Můžete také stisknout ctrl+\, Ctrl+M.

3. Na domovské stránce vyberte Žádosti o přijetí změn, abyste zobrazili seznamy žádostí o přijetí změn, které jste otevřeli vy nebo které jste jim přiřadili.

4. Pokud chcete na webovém portálu otevřít žádost o přijetí změn a zobrazit zásady, klikněte pravým tlačítkem myši na žádost o přijetí změn a vyberte Otevřít v prohlížeči.

Rozhraní příkazového řádku Azure DevOps

Nastavte automatické dokončování tak, aby se žádost o přijetí změn dokončila automaticky, když projde všemi požadovanými schváleními a zásadami větví. Automatické dokončování můžete nastavit při vytváření žádosti o přijetí změn nebo aktualizovat existující žádost o přijetí změn.

• Chcete-li nastavit automatické dokončování při vytváření žádosti o přijetí změn, použijte az repos pr create --auto-complete true.
• Chcete-li aktualizovat existující žádost o přijetí změn pro automatické dokončování, použijte az repos pr update --id <PR Id> --auto-complete true.

Opuštění nebo opětovná aktivace žádosti o přijetí změn

Prohlížeč

Pokud chcete změny opustit a žádost o přijetí změn bez sloučení, vyberte v rozevíracím seznamu na tlačítku Dokončit možnost Opustit. Stále můžete zobrazit opuštěnou žádost o přijetí změn a zůstane propojená s pracovními položkami.

Pokud chcete žádost o přijetí změn kdykoli znovu aktivovat, otevřete žádost o přijetí změn z karty Opuštěná v zobrazení Žádosti o přijetí změn a vyberte Znovu aktivovat v pravém horním rohu.

Visual Studio

Otevřete žádost o přijetí změn na webovém portálu. Na stránce Přehled vyberte Opustit.

Pokud chcete žádost o přijetí změn otevřít na webovém portálu, použijte postup dokončení žádosti o přijetí změn.

Rozhraní příkazového řádku Azure DevOps

Pokud chcete žádost o přijetí změn opustit bez sloučení změn, použijte az repos pr update --id <PR Id> –-status abandoned. Žádost o přijetí změn můžete znovu aktivovat nastavením stavu na active.

Vrácení dokončené žádosti o přijetí změn

Chcete-li vrátit zpět změny z žádosti o přijetí změn, postupujte takto. Další informace naleznete v tématu Vrácení změn zpět.

1. Otevřete dokončenou žádost o přijetí změn a vyberte Zpět. Tato akce vytvoří novou větev se změnami, které vrátí žádost o přijetí změn v existující cílové větvi v úložišti.

2. V podokně Vrátit žádost o přijetí změn:

   1. V části Cílová větev vyberte větev, ve které chcete vrátit změny žádosti o přijetí změn.
   2. V části Název větve Téma je povinný, pokud chcete změnit název větve žádosti o přijetí změn.
   3. Vyberte Vrátit zpět.

3. Na obrazovce Nová žádost o přijetí změn vyberte Vytvořit.

4. Sloučením nové žádosti o přijetí změn dokončete vrácení změn.

Poznámka:

Větev vytvořená během této změny obsahuje jediné potvrzení, které vrátí všechny změny souboru z původní žádosti o přijetí změn. Větev neobsahuje vrácené potvrzení pro každé potvrzení v původní žádosti o přijetí změn.

Další kroky

Kopírování změn pomocí výběru třešně

Související články

• Oznámení o aktualizaci žádostí o přijetí změn
• Informace o žádostech o přijetí změn a oprávněních