Konfigurera en grenprincip för en extern tjänst

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

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 PR-status finns i Anpassa och utöka arbetsflöden för pull-begäranden med pull-begärandestatus.

Förutsättningar

• En organisation i Azure DevOps med en Git-lagringsplats. Om du inte har en organisation kan du registrera dig för att ladda upp och dela kod i kostnadsfria obegränsade privata Git-lagringsplatser.
• En tjänst som publicerar status till PR:er. Se Skapa en statusserver för pull-begäran.

Konfigurera grenprincipen

1. 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 .

   

2. Rulla nedåt för att hitta statuskontroller. Välj knappen +.

   

3. 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.
   • Med standardvisningsnamnet kan du ange ett valfritt visningsnamn för principen.

Skapa en ny pull-begäran

1. Skapa en ny pull-begäran i grenen där principen definieras. Mer information finns i Skapa en pull-begäran.

2. När du har skapat PR visas den nya principen i avsnittet Principer i vyn PR-information. Från början visas principen som inte inställd förrän den externa tjänsten har bokfört status.

   

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

   

   När principkriterierna uppfylls och tjänsten publicerar en succeeded status godkänns pr och slutförandet avblockeras.

   

Sammanfattning

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