Configurare un criterio ramo per un servizio esterno

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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 usare l'API Stato richiesta pull per pubblicare lo stato dettagliato delle richieste pull. I criteri di ramo per i servizi esterni consentono a tali servizi di terze parti di partecipare al flusso di lavoro delle richieste pull e di stabilire i requisiti dei criteri. Questo articolo illustra il processo di configurazione di un criterio di ramo per un servizio che pubblica lo stato della richiesta pull. Per altre informazioni sullo stato della richiesta pull, vedere Personalizzare ed estendere i flussi di lavoro delle richieste pull con stato della richiesta pull.

Prerequisiti

• Un'organizzazione in Azure DevOps con un repository Git. Se non si ha un'organizzazione, iscriversi per caricare e condividere codice in repository Git privati gratuiti senza limiti.
• Servizio che invia lo stato alle richieste pull. Vedere Creare un server di stato della richiesta pull.

Configurare i criteri del ramo

1. Passare a Rami di codice>e trovare il ramo in cui si vuole configurare i criteri (in main genere develop o ). Dal menu di scelta rapida selezionare l'opzione Criteri ramo .

   

2. Scorrere verso il basso per trovare i controlli di stato. Seleziona 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.

   

   • Il requisito dei criteri determina se questo criterio è facoltativo o necessario per completare le richieste pull nel ramo.
   • L'identità autorizzata viene usata per imporre tale stato solo dall'identità specificata verrà conteggiata in base all'evasione dei criteri.
   • 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.
   • Facoltativamente, impostare un filtro Percorso. Altre 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.
   • Il nome visualizzato predefinito consente di specificare un nome visualizzato facoltativo per il criterio.

Creare una nuova richiesta pull

1. Creare una nuova richiesta pull nel ramo in cui è definito il criterio. 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, i criteri verranno visualizzati come non impostati finché il servizio esterno non ha registrato lo stato.

   

   Quando il servizio ha registrato lo stato, il criterio verrà aggiornato di conseguenza. Il completamento verrà bloccato finché il criterio non approva la richiesta pull.

   

   Quando vengono soddisfatti i criteri dei criteri e il servizio invia uno succeeded stato, la richiesta pull verrà approvata e il completamento verrà sbloccato.

   

Riepilogo

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