Dela via


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

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 .

    Välj Grenprinciper på snabbmenyn

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

    Välj knappen Lägg till princip

  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.

    Välj principen i listan

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

    Principstatus visas i avsnittet Principer

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

    Uppdateringar av principstatus

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

    Principstatus godkänd och slutförande avblockerad

Sammanfattning

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