Konfigurera en grenpolicy för en extern tjänst

2025-10-08

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Grenprinciper är en kraftfull funktion för att säkerställa kod av hög kvalitet på lagringsplatsen genom att fastställa krav för alla pull-begäranden. Externa tjänster kan använda PR-status-API:et för att publicera detaljerad status till dina pr-flöden. Grenprincipen för externa tjänster ger dessa tredjepartstjänster möjlighet att delta i PR-arbetsflödet och upprätta principkrav. Den här artikeln beskriver hur du konfigurerar en grenprincip för en tjänst som publicerar PR-status. Mer information om pull request-status finns i Anpassa och utöka arbetsflöden för pull requests med pull request-status.

Förutsättningar

Kategori	Krav
Åtkomst till projekt	Medlem av ett -projekt.
behörigheter	Visa kod i privata projekt: Minst grundläggande åtkomst . – Klona eller bidra till kod i privata projekt: Medlem i Bidragsgivare säkerhetsgrupp eller projektets motsvarande behörigheter. – Ange behörigheter för gren eller lagringsplats: Hantera behörigheter behörigheter för grenen eller lagringsplatsen. – Ändra standardgren: Redigera principer behörigheter för lagringsplatsen. – Importera en lagringsplats: Medlem i Projektadministratörer säkerhetsgrupp eller Git-projektnivå Skapa lagringsplats behörighet inställd på Tillåt. Mer information finns i Ange Behörigheter för Git-lagringsplats.
Tjänster	Repos aktiverat.
Verktyg	Valfritt. Använd kommandona az repos: Azure DevOps CLI.

Anmärkning

I offentliga projekt har användare med åtkomst på intressentnivå fullständig åtkomst till Azure Repos, inklusive att se, klona och bidra till kod.

Kategori	Krav
Åtkomst till projekt	Medlem av ett -projekt.
behörigheter	– Visa kod: Minst Grundläggande åtkomst. – Klona eller bidra till kod: Medlem i Contributors säkerhetsgrupp eller motsvarande behörigheter i projektet.
Tjänster	Repos aktiverat.

Konfigurera grenprincipen

Gå till Kodgrenar> och leta reda på den gren som du vill konfigurera principen på (vanligtvis main eller develop). På snabbmenyn väljer du alternativet Grenprinciper .
Rulla nedåt för att hitta statuskontroller. Välj knappen +.
Välj den tjänst som du vill skapa en princip för i listan. Om statusen har publicerats tidigare kan du välja den från listan. om det är en ny princip kan du skriva in namnet på principen.
- Principkrav avgör om den här principen är valfri eller krävs för att slutföra pull-begäranden till grenen.
- Auktoriserad identitet används för att framtvinga att status endast från den angivna identiteten räknas mot principuppfyllelse.
- Återställningsvillkor används för att avgöra när en bokförd status inte längre är giltig. Om statusen som publiceras är specifik för den senaste koden (t.ex. en version) kontrollerar du Återställningsstatus när det finns nya ändringar för att återställa statusen när källgrenen ändras.
- Du kan också ange ett sökvägsfilter. Läs mer om sökvägsfilter i grenprinciper.
- Principens tillämplighet avgör om den här principen gäller så snart en pull-begäran har skapats eller om principen tillämpas först efter att den första statusen har publicerats i pull-begäran.
- Standardvisningsnamn låter dig ange ett valfritt visningsnamn för policyn.

Skapa en ny pull-begäran

Skapa en ny pullförfrågan i grenen där principen definieras. Mer information finns i Skapa en pull-begäran.
När du har skapat PR:en kommer den nya policyn att visas i avsnittet Policys i vyn för PR-detaljer. Från början visas policyn som inte angiven förrän den externa tjänsten har angett status.

När tjänsten har publicerat status uppdateras principen i enlighet med detta. Slutförande blockeras tills principen godkänner PR.

När kriterierna för policyn är uppfyllda och tjänsten publicerar en succeeded status, kommer PR:n att godkännas och slutförandet att avblockeras.

Sammanfattning

I den här artikeln har du lärt dig hur du konfigurerar en grenprincip för en extern tjänst.

Feedback

Var den här sidan till hjälp?