Konfigurovat zásady větve pro externí službu

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

Zásady větví jsou účinným nástrojem pro zajištění vysoce kvalitního kódu v úložišti tím, že stanoví požadavky pro všechny pull requesty. Externí služby můžou používat Status API žádosti o přijetí změn k publikování podrobného stavu do vašich žádostí o přijetí změn. Zásady větve pro externí služby přinášejí možnost, aby se tyto služby třetích stran zapojily do pracovního postupu žádosti o přijetí změn a vytvořily požadavky na zásady. Tento článek vás provede procesem konfigurace politiky větve pro službu, která zveřejňuje stav pull requestu. Další informace o stavu žádosti o přijetí změn (PR) najdete v části Přizpůsobení a rozšíření pracovních postupů pro žádosti o přijetí změn s ohledem na jejich stav.

Požadavky

Kategorie	Požadavky
Přístup k projektu	Člen projektu.
Oprávnění	- Zobrazit kód v soukromých projektech: Alespoň Základní přístup. - Klonování nebo přispívání do kódu v soukromých projektech: Člen skupiny zabezpečení Contributors nebo osoba s odpovídajícími oprávněními v projektu. – Nastavte oprávnění pro větev nebo úložiště: Správa oprávnění oprávnění pro větev nebo úložiště. – Změnit výchozí větev: Upravit zásady oprávnění pro úložiště. – Import úložiště: Člen skupiny zabezpečení Projektoví administrátoři nebo oprávnění Vytvořit úložiště na úrovni projektu Git nastavená na Povolit. Další informace najdete v tématu Nastavení oprávnění úložiště Git.
Služby	Repozitáře povoleny.
Nástroje	Volitelný. Použijte příkazy az repos: Azure DevOps CLI.

Poznámka:

Ve veřejných projektech mají uživatelé s přístupem Stakeholder plný přístup do Azure Repos, kde mohou zobrazovat, klonovat a přispívat ke kódu.

Nakonfigurujte zásady větve

1. Přejděte na kód>větve a vyhledejte větev, pro kterou chcete politiku nakonfigurovat (obvykle main nebo develop). V místní nabídce vyberte možnost politiky větve.

   

2. Posuňte se dolů a vyhledejte kontroly stavu. Vyberte tlačítko +.

   

3. Ze seznamu vyberte službu, pro kterou chcete vytvořit zásadu. Pokud byl stav dříve publikován, můžete ho vybrat ze seznamu; pokud se jedná o novou zásadu, můžete zadat název zásady.

   

   • Požadavek zásad určuje, zda je tato zásada volitelná nebo povinná k dokončení pull requestů do větve.
   • Autorizovaná identita slouží k zajištění, že pouze zadaná identita bude započítána do naplnění politiky.
   • Podmínky resetování, slouží k určení, kdy oznámený stav již není platný. Pokud je stav publikovaný specifický pro nejnovější kód (tj. sestavení), zkontrolujte resetování stavu vždy, když dojde k novým změnám, abyste obnovili stav při změně zdrojové větve.
   • Volitelně můžete nastavit filtr cesty. Přečtěte si další informace o filtrech cest ve větevních politikách.
   • použitelnost zásad určuje, jestli se tato zásada použije, jakmile se vytvoří žádost o přijetí změn, nebo jestli se zásada použije až po odeslání prvního stavu do žádosti o přijetí změn.
   • Výchozí zobrazovaný název umožňuje zadat volitelný zobrazovaný název pro vaši politiku.

Vytvořit nový pull request

1. Ve větvi, ve které je zásada definována, vytvořte nový pull request (žádost o přijetí změn). Další informace najdete v Vytvoření pull requestu.

2. Po vytvoření PR se nová zásada zobrazí v části Zásady v zobrazení podrobností PR. Zpočátku se zásada zobrazí jako nenastavená, až externí služba zveřejní stav.

   

   Jakmile služba zveřejní stav, zásady se odpovídajícím způsobem aktualizují. Dokončení bude zablokováno, dokud politika neschválí PR.

   aktualizace stavu zásad

   Když jsou splněna kritéria zásad a služba zveřejní status succeeded, pull request bude schválen a dokončení bude odblokováno.

   

Shrnutí

V tomto článku jste zjistili, jak nakonfigurovat zásady větve pro externí službu.