Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Use esta tarefa para pausar uma execução de pipeline YAML para aguardar a interação manual.
Sintaxe
# 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.
Insumos
notifyUsers
-
Notificar os usuários
string. Obrigatório
Envia um e-mail de validação manual pendente para usuários (ou grupos) específicos. Somente usuários com permissão de compilação de fila podem agir em uma validação manual. Você pode enviar um e-mail 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 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 predefinido: 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
Nenhum.
Observações
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.
Sugestão
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@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 que é uma propriedade de tarefa comum disponível em todas as tarefas.
Requerimentos
| Requisito | 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 | Desplegar |