Condividi tramite


Usare attività di controllo e approvazioni per controllare la distribuzione

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

Usando una combinazione di approvazioni, controlli e intervento manuale della distribuzione manuale nella pipeline di versione, è possibile configurare rapidamente e facilmente la distribuzione in modo da soddisfare tutti i requisiti specifici di pre-distribuzione per il flusso di lavoro.

In questa esercitazione si approfondiranno i seguenti argomenti:

  • Controlli di pre-distribuzione
  • Intervento manuale
  • Convalida manuale
  • Log di distribuzione

Prerequisiti

Configurare i controlli

È possibile usare i controlli per assicurarsi che la pipeline di versione soddisfi criteri specifici prima della distribuzione senza richiedere l'intervento dell'utente.

  1. Selezionare Versioni pipeline>e quindi selezionare la pipeline di versione. Selezionare Modifica per aprire l'editor della pipeline.

    Screenshot che mostra il pulsante di modifica per le pipeline di versione.

  2. Selezionare l'icona di pre-distribuzione per la fase e quindi selezionare l'interruttore per abilitare Gates.

    Screenshot che mostra come abilitare i controlli.

  3. Specificare il tempo di ritardo prima della valutazione dei controlli aggiunti. Questa volta è consentire alle funzioni gate di inizializzare e stabilizzarsi prima di restituire i risultati.

    Screenshot che mostra come impostare il tempo di ritardo per i controlli di pre-distribuzione.

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

    Screenshot che mostra come aggiungere un'attività Elementi di lavoro query.

  5. Selezionare una query dell'elemento di lavoro esistente dal menu a discesa. A seconda del numero di elementi di lavoro previsti per la restituzione della query, impostare le soglie massime e minime.

    Screenshot che mostra come configurare l'attività Query Work Items .

  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.

    Screenshot che mostra come configurare le opzioni di valutazione per l'attività query degli elementi di lavoro.

  7. Al termine, seleziona Salva.

    Screenshot che mostra come salvare una pipeline di versione.

Configurare un intervento manuale

A seconda dello scenario, a volte potrebbe essere necessario aggiungere un intervento manuale alla pipeline di versione. È possibile eseguire questa operazione aggiungendo l'attività Intervento manuale alla pipeline.

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

    Screenshot che mostra come passare alle attività di staging in una pipeline di versione.

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

    Screenshot che mostra come aggiungere un processo senza agente.

  3. Trascinare e rilasciare il processo senza agente nella parte superiore del processo di distribuzione. Selezionare il segno (+) e quindi selezionare Aggiungi l'attività Intervento manuale.

    Screenshot che mostra come aggiungere l'attività di 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.

    Screenshot che mostra come configurare l'attività Intervento manuale.

  5. Al termine, seleziona Salva.

Nota

L'attività Intervento manuale può essere usata solo in un processo senza agente.

Configurare una 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.

Screenshot che mostra la richiesta di convalida manuale.

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: |
            someone@example.com
         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 Versioni pipeline>e quindi selezionare la pipeline di versione.

    Screenshot che mostra un elenco di definizioni di versione.

  2. Questa visualizzazione mostrerà lo stato attivo di ogni fase della pipeline. La fase qa in questo esempio è in attesa di intervento. Selezionare Riprendi.

    Screenshot che mostra l'intervento della fase qa in sospeso.

  3. Immettere il commento e quindi selezionare Riprendi.

    Screenshot che mostra come rispondere a una richiesta di intervento manuale in sospeso.

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

    Screenshot che mostra l'approvazione della pre-distribuzione attivata per la fase successiva.

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

    Screenshot che mostra come rispondere a una richiesta di approvazione in sospeso.

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

    Screenshot che mostra i controlli di elaborazione di produzione.

  7. Tornare alla pipeline di versione, passare il puntatore del mouse sulla fase e quindi selezionare Log per visualizzare i log di distribuzione.

    Screenshot che mostra come accedere ai log di distribuzione.