ManualValidation@1 - Attività convalida manuale v1

Articolo
11/21/2024

Sospendere un'esecuzione della pipeline per attendere l'interazione manuale. Funziona solo con le pipeline YAML.

Sintassi

# Manual validation v1
# Pause a pipeline run to wait for manual interaction. Works only with YAML pipelines.
- task: ManualValidation@1
  inputs:
    notifyUsers: # string. Required. Notify users. 
    #approvers: # string. Approvers. 
    #allowApproversToApproveTheirOwnRuns: false # boolean. Allow approvers to approve their own run. Default: false.
    #instructions: # string. Instructions. 
    #onTimeout: 'reject' # 'reject' | 'resume'. On timeout. Default: reject.

Ingressi

notifyUsers - notificare agli utenti
string. Obbligatorio.

Inviare un messaggio di posta elettronica di convalida manuale in sospeso a un elenco delimitato da virgole di utenti specifici (o gruppi). È possibile inviare un messaggio di posta elettronica a un gruppo usando la sintassi del nome [org name]\group.

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: ''.

approvers - responsabili approvazione
string.

Specificare un elenco delimitato da virgole di utenti/gruppi/team di progetto per agire su una convalida manuale. In assenza di input, gli utenti con autorizzazione di compilazione della coda potranno intervenire.

allowApproversToApproveTheirOwnRuns - Consentire ai responsabili approvazione di approvare il proprio di esecuzione
boolean. Valore predefinito: false.

Se questo è vero, il responsabile approvazione sarà in grado di approvare la propria esecuzione.

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 attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di 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 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à .

Nota

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.

Mancia

È 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@1
      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'

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

Fabbisogno

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Viene eseguito in	Server
richieste	Nessuno
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	Tutte le versioni dell'agente supportate.
Categoria attività	Schierare

Condividi tramite