ManualValidation@0 - Tarefa de validação manual v0

Artigo
06/11/2024

Utilize esta tarefa para colocar em pausa uma execução de pipeline YAML para aguardar a interação manual.

Syntax

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

Entradas

notifyUsers - Notificar utilizadores
string. Obrigatório.

Envia uma validação manual pendente de e-mail para utilizadores (ou grupos) específicos. Apenas os utilizadores com permissão de compilação de filas podem agir numa validação manual. Pode enviar um e-mail para um grupo com a [org name]\group name sintaxe.

Esta entrada de tarefa é necessária, mas pode especificar uma cadeia vazia se não quiser notificar ninguém, por exemplo, durante uma execução de teste: notifyUsers: ''.

instructions - Instruções
string.

Especifica as instruções que são apresentadas ao utilizador ao retomar ou rejeitar a intervenção manual. Com base nestas instruções, o utilizador tomará uma decisão informada sobre esta intervenção manual.

onTimeout - Tempo limite excedido
string. Valores permitidos: reject, resume. Valor predefinido: reject.

Rejeita ou retoma automaticamente esta validação manual depois de estar pendente para o tempo limite especificado, ou 30 dias, o que for anterior.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Utilize esta tarefa num pipeline YAML para colocar uma execução em pausa numa fase. Normalmente, esta ação é executada para executar vários passos ou ações manuais e, em seguida, a execução é retomada ou rejeitada.

Importante

Esta tarefa só é suportada em pipelines YAML e só pode ser utilizada numa tarefa sem agente de um pipeline YAML.

A tarefa Validação Manual permite-lhe colocar em pausa uma execução de pipeline numa fase, normalmente para executar alguns passos ou ações manuais e, em seguida, continuar com o pipeline. Por exemplo, o utilizador poderá ter de validar manualmente determinadas configurações de implementação antes de o pipeline iniciar uma tarefa de execução intensiva computacional de execução prolongada.

A configuração da tarefa Validação Manual inclui um parâmetro de instruções que é utilizado para fornecer informações relacionadas ou para especificar os passos manuais que o utilizador executa durante a pausa. Pode configurar a tarefa para enviar notificações por e-mail a utilizadores e grupos de utilizadores quando esta aguarda uma revisão e especificar a resposta automática (rejeitar ou retomar) depois de ocorrer um tempo limite configurável.

Pode especificar o valor de tempo limite para a tarefa com o parâmetro opcional timeoutInMinutes , disponível nas propriedades comuns da tarefa.

Nota

Para que a tarefa seja executada completamente, o timeoutInMinutes valor da tarefa (default = 60 minutes) que contém esta tarefa deve ser superior ao timeoutInMinutes valor da própria tarefa. Veja os valores de tempo limite predefinidos da tarefa.

Dica

Pode utilizar variáveis para especificar endereços de e-mail no notifyUsers parâmetro .

Quando a tarefa Validação Manual é ativada durante um pipeline, apresenta uma barra de mensagens com uma ligação que abre a caixa de diálogo Validação manual, que contém as instruções. Depois de executar os passos manuais, o administrador ou utilizador pode optar por retomar a execução ou rejeitá-la. Os utilizadores com permissão de compilação de Filas no pipeline podem retomar ou rejeitar a execução.

Exemplos

  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'

Este exemplo utiliza timeoutInMinutes uma propriedade de tarefa comum disponível em todas as tarefas.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica
É executado em	Servidor
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de tabelas definidas	Qualquer
Versão do agente	Todas as versões de agente suportadas.
Categoria da tarefa	Implementação

Partilhar via