ManualValidation@0 - Attività di convalida manuale v0

Articolo
2025-05-10

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

Sintassi

# Manual validation v0
# 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.

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

Ingressi dati

notifyUsers - notificare agli utenti
string. Obbligatorio.

Invia un'email manuale in attesa di convalida a utenti (o gruppi) specifici. Solo gli utenti con l'autorizzazione per la creazione della coda possono eseguire una convalida manuale. Puoi inviare un'email a un gruppo utilizzando 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 della convalida manuale. In base a queste istruzioni, l'utente prenderà una decisione informata su questa convalida manuale.

onTimeout - In caso di timeout
string. Valori consentiti: reject, resume. Valore predefinito: reject

Rifiuta o riprende automaticamente la convalida manuale dopo che è in sospeso per il timeout specificato o 30 giorni, a qualunque punto sia 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 uscita

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 o azioni manuali 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 in 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 avvii un processo a elevato utilizzo di calcolo a esecuzione prolungata.

La configurazione dell'attività convalida manuale include un istruzioni parametro usato per fornire informazioni correlate o per specificare i passaggi manuali eseguiti dall'utente durante la pausa. È possibile configurare l'attività per inviare notifiche tramite posta elettronica a utenti e 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à comuni dell'attività .

Annotazioni

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

Suggerimento

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

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 compilazioni coda'autorizzazione per la pipeline possono riprendere o rifiutare l'esecuzione.

Esempi

  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]
          [email protected]
        instructions: 'Please validate the build configuration and resume'
        onTimeout: 'resume'

Questo esempio usa timeoutInMinutes che è una proprietà attività comune disponibile in tutte le attività.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Viene eseguito in	Servidor
Richieste	Nessuno
Funzionalità	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
Restrizioni dei comandi	Qualunque
Variabili impostabili	Qualunque
Versione agente	Tutte le versioni dell'agente supportate.
Categoria attività	Distribuire

Condividi tramite