Configurare una politica di ramo per un servizio esterno

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

I criteri di ramo sono una funzionalità potente per garantire codice di alta qualità nel repository stabilendo i requisiti per tutte le richieste pull. I servizi esterni possono utilizzare l'API Status per pubblicare uno stato dettagliato sui tuoi Pull Request. La politica di ramo per i servizi esterni consente a tali servizi di terze parti di partecipare al flusso di lavoro delle richieste pull e di stabilire i requisiti della politica. Questo articolo illustra il processo di configurazione di un criterio di gestione dei rami per un servizio che pubblica lo stato della pull request. Per altre informazioni sullo stato delle richieste pull, vedere Personalizzare ed estendere i flussi di lavoro delle richieste pull con lo stato delle richieste pull.

Prerequisiti

Configurare i criteri di branch

1. Passare a Branch di codice> e trovare il ramo su cui si desidera configurare i criteri (tipicamente main o develop). Dal menu di scelta rapida selezionare l'opzione Criteri ramo .

   

2. Scorrere verso il basso per trovare i controlli di stato. Selezionare il + pulsante .

   

3. Selezionare il servizio per cui si vuole creare un criterio dall'elenco. Se lo stato è stato pubblicato in precedenza, è possibile selezionarlo dall'elenco; se si tratta di un nuovo criterio, è possibile digitare il nome del criterio.

   

   • Requisito di criterio determina se questo criterio è facoltativo o necessario per completare le richieste di pull nel ramo.
   • L'identità autorizzata viene utilizzata per far rispettare tale stato, in modo che solo l'identità specificata venga conteggiata ai fini dell'adempimento della politica.
   • Le condizioni di reimpostazione vengono usate per determinare quando uno stato registrato non è più valido. Se lo stato pubblicato è specifico del codice più recente (ad esempio una compilazione), controllare Reimposta stato ogni volta che sono presenti nuove modifiche per reimpostare lo stato quando cambia il ramo di origine.
   • Impostare facoltativamente un filtro percorso. Ulteriori informazioni sui filtri di percorso nei criteri dei rami.
   • L'applicabilità dei criteri determina se questo criterio viene applicato non appena viene creata una richiesta pull o se il criterio viene applicato solo dopo la pubblicazione del primo stato alla richiesta pull.
   • Nome visualizzato predefinito consente di specificare un nome facoltativo per la tua policy.

Creare una nuova richiesta di pull

1. Creare una nuova pull request nel branch in cui è definita la policy. Per altre informazioni, vedere Creare una richiesta pull.

2. Dopo aver creato la richiesta pull, i nuovi criteri verranno visualizzati nella sezione Criteri della visualizzazione dei dettagli della richiesta pull. Inizialmente, la politica verrà visualizzata come non impostata fino a quando il servizio esterno non avrà registrato lo stato.

   

   Quando il servizio ha pubblicato lo stato, il criterio verrà aggiornato di conseguenza. Il completamento sarà bloccato fino a quando la politica non avrà approvato la richiesta di pull.

   

   Quando vengono soddisfatti i criteri della policy e il servizio pubblica uno succeeded stato, la pull request verrà approvata e il completamento verrà sbloccato.

   

Riassunto

In questo articolo si è appreso come configurare criteri di ramo per un servizio esterno.