ManualValidation@0 - Attività di convalida manuale v0

Articolo
06/11/2024

Usare questa attività per sospendere l'esecuzione di una pipeline YAML per attendere l'interazione manuale.

Sintassi

# Manual validation v0
# [PREVIEW] Pause a pipeline run to wait for manual interaction. Works only with YAML pipelines.
- task: ManualValidation@0
  inputs:
    notifyUsers: # string. Required. Notify users. 
    #instructions: # string. Instructions. 
    #onTimeout: 'reject' # 'reject' | 'resume'. On timeout. Default: reject.

Input

notifyUsers - Notifica agli utenti
string. Obbligatorio.

Invia un messaggio di posta elettronica di convalida manuale in sospeso a utenti specifici (o gruppi). Solo gli utenti con autorizzazione di compilazione della coda possono agire su una convalida manuale. È possibile inviare un messaggio di posta elettronica a un gruppo usando la [org name]\group name sintassi.

Questo input dell'attività è obbligatorio, ma è possibile specificare una stringa vuota se non si vuole inviare una notifica a nessuno, ad esempio durante un'esecuzione di test: notifyUsers: ''.

instructions - Istruzioni
string.

Specifica le istruzioni visualizzate all'utente durante la ripresa o il rifiuto dell'intervento manuale. In base a queste istruzioni, l'utente prenderà una decisione informata su questo intervento manuale.

onTimeout - Timeout
string. Valori consentiti: reject, resume. Valore predefinito: reject.

Rifiuta o riprende automaticamente questa convalida manuale dopo che è in sospeso per il timeout specificato o 30 giorni, che tuttavia è precedente.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Usare questa attività in una pipeline YAML per sospendere un'esecuzione all'interno di una fase. Questa operazione viene in genere eseguita per eseguire vari passaggi manuali o azioni e quindi l'esecuzione viene ripresa o rifiutata.

Importante

Questa attività è supportata solo nelle pipeline YAML e può essere usata solo in un processo senza agente di una pipeline YAML.

L'attività Convalida manuale consente di sospendere l'esecuzione di una pipeline all'interno di una fase, in genere per eseguire alcuni passaggi o azioni manuali e quindi continuare con la pipeline. Ad esempio, l'utente potrebbe dover convalidare manualmente determinate configurazioni di distribuzione prima che la pipeline inizi un processo con utilizzo intensivo di calcolo a esecuzione prolungata.

La configurazione dell'attività Convalida manuale include un parametro di istruzioni usato per fornire informazioni correlate o per specificare i passaggi manuali eseguiti dall'utente durante la pausa. È possibile configurare l'attività per inviare notifiche di posta elettronica agli utenti e ai gruppi di utenti quando è in attesa di una revisione e specificare la risposta automatica (rifiutare o riprendere) dopo un timeout configurabile.

È possibile specificare il valore di timeout per l'attività usando il parametro facoltativo timeoutInMinutes , disponibile nelle proprietà dell'attività comuni.

Nota

Affinché l'attività venga eseguita completamente, il timeoutInMinutes valore del processo (default = 60 minutes) contenente questa attività deve essere superiore al timeoutInMinutes valore dell'attività stessa. Vedere i valori di timeout del processo predefiniti.

Suggerimento

È possibile usare le variabili per specificare gli indirizzi di posta elettronica nel notifyUsers parametro.

Quando l'attività Convalida manuale viene attivata durante una pipeline, viene visualizzata una barra dei messaggi con un collegamento che apre la finestra di dialogo Convalida manuale che contiene le istruzioni. Dopo aver eseguito i passaggi manuali, l'amministratore o l'utente può scegliere di riprendere l'esecuzione o rifiutarla. Gli utenti con l'autorizzazione Queue build per la pipeline possono riprendere o rifiutare l'esecuzione.

Esempio

  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: |
          test@test.com
          example@example.com
        instructions: 'Please validate the build configuration and resume'
        onTimeout: 'resume'

In questo esempio viene timeoutInMinutes utilizzata una proprietà di attività comune disponibile in tutte le attività.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Esecuzione in	Server
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	Tutte le versioni dell'agente supportate.
Categoria attività	Distribuire

Condividi tramite