Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Use esta tarea para pausar la ejecución de una canalización de YAML a fin de esperar la interacción manual.
Sintaxis
# 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.
Entradas
notifyUsers
-
Notificar a los usuarios
string
. Obligatorio.
Envía un correo electrónico pendiente de validación manual a usuarios (o grupos) específicos. 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 utilizando 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 validación manual. En función de estas instrucciones, el usuario tomará una decisión informada sobre esta validación manual.
onTimeout
-
al 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 sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.
Variables de salida
Ninguno.
Observaciones
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, la ejecución se reanuda o rechaza.
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 determinadas 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
Puede especificar el valor de tiempo de espera de la tarea mediante el parámetro opcional timeoutInMinutes
, disponible en las propiedades de tarea comunes .
Nota:
Para que la tarea se ejecute completamente, el valor timeoutInMinutes
del trabajo (default = 60 minutes
) que contiene esta tarea debe ser mayor que el valor timeoutInMinutes
de la propia tarea. Consulte valores de tiempo de espera de trabajo predeterminados.
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 Queue compila permiso 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
que es 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 | Servidor |
demandas | Ninguno |
Capacidades | Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo. |
restricciones de comandos | Cualquiera |
variables settable | Cualquiera |
Versión del agente | Todas las versiones de agente admitidas. |
Categoría de tarea | Desplegar |