ManualValidation@0 - Attività di convalida manuale v0
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 |