Condividi tramite


Configurare criteri di ramo per un servizio esterno

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

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

Categoria Requisiti
Accesso al progetto Membro di un progetto.
Autorizzazioni - Visualizzare il codice nei progetti privati: almeno l'accesso di base .
- Clonare o contribuire al codice nei progetti privati: membro del gruppo di sicurezza Collaboratori o delle autorizzazioni corrispondenti nel progetto.
- Impostare le autorizzazioni del ramo o del repository: gestire le autorizzazioni per il ramo o il repository.
- Modificare il ramo predefinito: modificare le autorizzazioni dei criteri per il repository.
- Importare un repository: membro del gruppo di sicurezza Amministratori progetti o Autorizzazione di creazione repository a livello di progetto Git impostato su Consenti. Per altre informazioni, vedere Impostare le autorizzazioni del repository Git.
Services Repository abilitati.
Strumenti Optional. Usare i comandi az repos : interfaccia della riga di comando di Azure DevOps.

Annotazioni

Nei progetti pubblici gli utenti con accesso stakeholder hanno accesso completo a Azure Repos, tra cui visualizzazione, clonazione e contributo al codice.

Categoria Requisiti
Accesso al progetto Membro di un progetto.
Autorizzazioni - Visualizzare il codice: almeno l'accesso di base .
- Clonare o contribuire al codice: membro del gruppo di sicurezza Collaboratori o delle autorizzazioni corrispondenti nel progetto.
Services Repository abilitati.

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 o develop). Dal menu di scelta rapida selezionare l'opzione Criteri ramo .

    Selezionare Criteri ramo dal menu di scelta rapida

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

    Selezionare il pulsante Aggiungi criterio

  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.

    Selezionare il criterio dall'elenco

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

    Lo stato dei criteri è visibile nella sezione Criteri

    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.

    Aggiornamenti dello stato dei criteri

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

    Stato dei criteri approvato e completato sbloccato

Riassunto

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