Compartilhar via


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

Use essa tarefa para pausar 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 usuários
string. Obrigatórios.

Envia um email pendente de validação manual para usuários específicos (ou grupos). Somente usuários com permissão de build de fila podem agir em uma validação manual. Você pode enviar um email para um grupo usando a [org name]\group name sintaxe .

Essa entrada de tarefa é necessária, mas você pode especificar uma cadeia de caracteres 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 mostradas ao usuário ao retomar ou rejeitar a intervenção manual. Com base nessas instruções, o usuário tomará uma decisão informada sobre essa intervenção manual.


onTimeout - Tempo limite
string. Valores Permitidos: reject e resume. Valor padrão: reject.

Rejeita ou retoma automaticamente essa validação manual depois que ela está pendente para o tempo limite especificado, ou 30 dias, o que for anterior.


Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Use essa tarefa em um pipeline YAML para pausar uma execução em um estágio. Normalmente, isso é executado para executar várias etapas ou ações manuais e, em seguida, a execução é retomada ou rejeitada.

Importante

Essa tarefa só tem suporte em pipelines YAML e só pode ser usada em um trabalho sem agente de um pipeline YAML.

A tarefa Validação Manual permite pausar uma execução de pipeline em um estágio, normalmente para executar algumas etapas ou ações manuais e, em seguida, continuar com o pipeline. Por exemplo, o usuário pode precisar validar manualmente determinadas configurações de implantação antes que o pipeline inicie um trabalho com uso intensivo computacional de execução prolongada.

A configuração da tarefa Validação Manual inclui um parâmetro de instruções que é usado para fornecer informações relacionadas ou para especificar as etapas manuais que o usuário executa durante a pausa. Você pode configurar a tarefa para enviar notificações por email para usuários e grupos de usuários quando estiver aguardando uma revisão e especificar a resposta automática (rejeitar ou retomar) após um tempo limite configurável.

Você pode especificar o valor de tempo limite para a tarefa usando o parâmetro opcional timeoutInMinutes , disponível nas propriedades comuns da tarefa.

Observação

Para que a tarefa seja executada completamente, o timeoutInMinutes valor do trabalho (default = 60 minutes) que contém essa tarefa deve ser maior do que o timeoutInMinutes valor da tarefa em si. Confira valores de tempo limite de trabalho padrão.

Dica

Você pode usar variáveis para especificar endereços de email no parâmetro notifyUsers.

Quando a tarefa Validação Manual é ativada durante um pipeline, ela exibe uma barra de mensagens com um link que abre a caixa de diálogo Validação manual, que contém as instruções. Depois de executar as etapas manuais, o administrador ou usuário pode optar por retomar a execução ou rejeitá-la. Os usuários com permissão de builds de fila 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 usa timeoutInMinutes uma propriedade de tarefa comum disponível em todas as tarefas.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico
É executado em Servidor
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente Todas as versões do agente com suporte.
Categoria da tarefa Implantar