Partilhar via


ManualValidation@1 - Validação manual v1 tarefa

Pause uma execução de pipeline para aguardar a interação manual. Funciona apenas com pipelines YAML.

Sintaxe

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

Insumos

notifyUsers - Notificar os usuários
string. Necessário.

Envie um e-mail pendente de validação manual para uma lista separada por vírgulas de usuários (ou grupos) específicos. Você pode enviar um e-mail para um grupo usando a sintaxe do nome [org name]\group.

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


approvers - Aprovadores
string.

Especifique uma lista separada por vírgulas de usuários/grupos/equipes de projeto para agir em uma validação manual. Na ausência de entrada, os usuários com permissão de compilação de fila poderão agir.


allowApproversToApproveTheirOwnRuns - Permitir que os aprovadores aprovem seus próprios de execução
boolean. Valor padrão: false.

Se isso for verdade, o aprovador poderá aprovar sua própria corrida.

Importante

A funcionalidade do allowApproversToApproveTheirOwnRuns ainda está sendo implantada no Azure DevOps e atualmente não está habilitada.


instructions - Instruções
string.

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


onTimeout - No tempo limite
string. Valores permitidos: reject, resume. Valor padrão: reject.

Rejeita ou retoma automaticamente essa validação manual depois que ela estiver pendente pelo tempo limite especificado, ou 30 dias, o que ocorrer primeiro.


Opções de controlo de tarefas

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

Variáveis de saída

Nenhuma.

Comentários

Use esta tarefa em um pipeline YAML para pausar uma execução dentro de um estágio. Isso geralmente é executado para executar várias etapas 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 usada em um de trabalho sem agente de um pipeline YAML.

A tarefa Validação Manual permite pausar a execução de um pipeline dentro de 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 computacional intensivo de longa duração.

A configuração da tarefa Validação Manual inclui um instruções parâmetro 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 e-mail 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 a ocorrência de um tempo limite configurável.

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

Observação

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

Dica

Você pode usar variáveis para especificar endereços de e-mail 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 Fila cria permissão 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@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'

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

Requerimentos

Exigência Descrição
Tipos de pipeline YAML, construção clássica
Funciona em Servidor
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria de tarefa Implantar