Usare porte e approvazioni per gestire la distribuzione

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

Usando una combinazione di approvazioni manuali, gate e interventi manuali nella pipeline di rilascio, è possibile configurare rapidamente e facilmente la distribuzione per soddisfare tutti i requisiti specifici di pre-distribuzione del flusso di lavoro.

In questa esercitazione si approfondiranno i seguenti argomenti:

Prerequisiti

• Completare l'esercitazione Definire la pipeline di rilascio a più fasi.

• Query di un elemento di lavoro. Creare una query dell'elemento di lavoro in Azure Boards se non ne hai già una.

Configurare i controlli

È possibile utilizzare le verifiche per garantire che la pipeline di rilascio soddisfi criteri specifici prima della distribuzione, senza richiedere l'intervento dell'utente.

1. Selezionare Pipelines>Release, e quindi selezionare la pipeline di release. Selezionare Modifica per aprire l'editor della pipeline.

   

2. Selezionare l'icona di pre-distribuzione per il tuo stadio e quindi selezionare il pulsante di commutazione per abilitare Gates.

   

3. Specificare il tempo di ritardo prima che le porte aggiunte vengano valutate. Questa volta è consentire alle funzioni gate di inizializzare e stabilizzarsi prima di restituire i risultati.

   

4. Selezionare Aggiungi e quindi selezionare Query Work Items (Esegui query su elementi di lavoro).

   Una schermata che mostra come aggiungere un'attività di query degli elementi di lavoro.

5. Selezionare una query dell'elemento di lavoro esistente dal menu a discesa. A seconda di quanti elementi di lavoro ci si aspetta che la query restituisca, impostare le soglie massime e minime.

   

6. Selezionare la sezione Opzioni di valutazione e quindi specificare il timeout e l'intervallo di campionamento. I valori minimi che è possibile specificare sono timeout di 6 minuti e intervallo di campionamento di 5 minuti.

   

7. Al termine, seleziona Salva.

   

Configurare l'intervento manuale

A seconda dello scenario, potresti dover aggiungere un intervento manuale alla pipeline di rilascio. Puoi farlo aggiungendo l'attività Intervento manuale alla tua pipeline.

1. Selezionare Pipeline>Rilasci. Selezionare la pipeline di versione e quindi selezionare Attività e scegliere la fase.

   

2. Selezionare i puntini di sospensione (...), quindi selezionare Aggiungi un processo senza agente.

   

3. Trascina e posiziona il processo senza agenti all'inizio del processo di distribuzione. Selezionare il segno (+) e quindi selezionare Aggiungi l'attività Intervento manuale.

   

4. Immettere un nome visualizzato e le istruzioni che verranno visualizzate quando viene attivata l'attività. È anche possibile specificare un elenco di utenti per ricevere una notifica e un'azione di timeout (rifiutare o riprendere) se non si è verificato alcun intervento entro il periodo di timeout.

   

5. Al termine, seleziona Salva.

Configurare la convalida manuale

È possibile usare l'attività Convalida manuale nella pipeline YAML per sospendere e attendere l'approvazione manuale. La convalida manuale è particolarmente utile negli scenari in cui si desidera convalidare le impostazioni di configurazione o compilare pacchetti prima di avviare un processo a elevato utilizzo di calcolo.

Il waitForValidation processo sospende l'esecuzione e attiva un prompt dell'interfaccia utente per esaminare e convalidare l'attività. Gli indirizzi di posta elettronica elencati in notifyUsers ricevono una notifica per approvare o negare l'esecuzione della pipeline.

pool: 
   vmImage: ubuntu-latest

jobs:
- job: waitForValidation
  displayName: Wait for external validation  
  pool: server    
  timeoutInMinutes: 4320 # job times out in 3 days
  steps:   
   - task: ManualValidation@0
     timeoutInMinutes: 1440 # task times out in 1 day
     inputs:
         notifyUsers: |
            [email protected]
         instructions: 'Please validate the build configuration and resume'
         onTimeout: 'resume'

Visualizzare i log di distribuzione

I log di distribuzione sono utili per eseguire il debug dei problemi di distribuzione, ma è anche possibile usarli per controllare le esecuzioni della pipeline e verificare le approvazioni e il modo in cui sono stati concessi e da chi.

1. Selezionare Pipeline>Versioni, e quindi selezionare la pipeline di rilascio.

   

2. Questa vista mostrerà lo stato in tempo reale di ogni fase della pipeline. La fase QA in questo esempio richiede un intervento. Selezionare Riprendi.

   

3. Immettere il commento e quindi selezionare Riprendi.

   

4. La distribuzione della fase QA ha avuto esito positivo e le approvazioni di pre-deployment vengono attivate per la fase di produzione.

   

5. Selezionare Approva, immettere il commento e quindi selezionare Approva per continuare la distribuzione.

   

6. Lo stato live indica che i gate vengono elaborati per la fase di Produzione prima che il rilascio continui.

   

7. Tornare alla pipeline di rilascio, passare il puntatore del mouse sullo stadio e quindi selezionare Registri per visualizzare i registri di distribuzione.

   

Articoli correlati

• Attivatori di rilascio
• Distribuire gli Artifact delle richieste pull
• Aggiungere fasi, dipendenze e condizioni