Compartir a través de

ManualValidation@0: tarea validación manual v0

  • Artículo

Use esta tarea para pausar una ejecución de canalización de YAML para esperar a la interacción 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 a los usuarios
string. Obligatorio.

Envía un correo electrónico pendiente de validación manual a usuarios específicos (o grupos). Solo los usuarios con permiso de compilación de cola pueden actuar en una validación manual. Puede enviar un correo electrónico a un grupo mediante la [org name]\group name sintaxis .

Esta entrada de tarea es necesaria, pero puede especificar una cadena vacía si no desea notificar a nadie, por ejemplo durante una ejecución de prueba: notifyUsers: ''.


instructions - Instrucciones
string.

Especifica las instrucciones que se muestran al usuario al reanudar o rechazar la intervención manual. En función de estas instrucciones, el usuario tomará una decisión informada sobre esta intervención manual.


onTimeout - Al expirar el tiempo de espera
string. Valores permitidos: reject, resume. Valor predeterminado: reject.

Rechaza o reanuda automáticamente esta validación manual después de que esté pendiente para el tiempo de espera especificado o 30 días, lo que sea anterior.


Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

Use esta tarea en una canalización DE YAML para pausar una ejecución dentro de una fase. Normalmente se ejecuta para realizar varios pasos o acciones manuales y, a continuación, se reanuda o rechaza la ejecución.

Importante

Esta tarea solo se admite en canalizaciones YAML y solo se puede usar en un trabajo sin agente de una canalización YAML.

La tarea Validación manual permite pausar una ejecución de canalización dentro de una fase, normalmente para realizar algunos pasos o acciones manuales y, a continuación, continuar con la canalización. Por ejemplo, es posible que el usuario tenga que validar manualmente ciertas configuraciones de implementación antes de que la canalización inicie un trabajo intensivo de cálculo de larga duración.

La configuración de la tarea Validación manual incluye un parámetro de instrucciones que se usa para proporcionar información relacionada o para especificar los pasos manuales que ejecuta el usuario durante la pausa. Puede configurar la tarea para enviar notificaciones por correo electrónico a usuarios y grupos de usuarios cuando está esperando una revisión y especificar la respuesta automática (rechazar o reanudar) después de que se produzca un tiempo de espera configurable.

Puede especificar el valor de tiempo de espera de la tarea mediante el parámetro opcional timeoutInMinutes , disponible en las propiedades comunes de la tarea.

Nota

Para que la tarea se ejecute por completo, el timeoutInMinutes valor del trabajo (default = 60 minutes) que contiene esta tarea debe ser mayor que el timeoutInMinutes valor de la propia tarea. Consulte los valores predeterminados de tiempo de espera del trabajo.

Sugerencia

Puede usar variables para especificar direcciones de correo electrónico en el parámetro notifyUsers.

Cuando la tarea Validación manual se activa durante una canalización, muestra una barra de mensajes con un vínculo que abre el cuadro de diálogo Validación manual, que contiene las instrucciones. Después de llevar a cabo los pasos manuales, el administrador o el usuario pueden optar por reanudar la ejecución o rechazarla. Los usuarios con permiso queue builds en la canalización pueden reanudar o rechazar la ejecución.

Ejemplos

  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'

En este ejemplo se usa timeoutInMinutes una propiedad de tarea común disponible en todas las tareas.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica
Se ejecuta en Server
Peticiones None
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente Todas las versiones de agente compatibles.
Categoría de la tarea: Implementación