Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте эту задачу, чтобы приостановить выполнение конвейера YAML в ожидании ручного взаимодействия.
Синтаксис
# 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.
Входные данные
notifyUsers
-
уведомлять пользователей
string. Обязательное.
Отправляет электронное письмо с ожиданием проверки вручную определенным пользователям (или группам). Только пользователи с разрешением на сборку очереди могут выполнять проверку вручную. Вы можете отправить электронное письмо группе, используя этот [org name]\group name синтаксис.
Для ввода этой задачи требуется, но можно указать пустую строку, если вы не хотите уведомлять кого-либо, например во время тестового выполнения: notifyUsers: ''.
Инструкции instructions -
string.
Указывает инструкции, отображаемые пользователю при возобновлении или отклонении проверки вручную. На основе этих инструкций пользователь примет информированное решение об этой проверке вручную.
onTimeout
-
время ожидания
string. Допустимые значения: reject, resume. Значение по умолчанию: reject.
Автоматически отклоняет или возобновляет эту проверку вручную после ожидания указанного времени ожидания или 30 дней, в зависимости от того, что раньше.
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.
Выходные переменные
Нет.
Замечания
Используйте эту задачу в конвейере YAML для приостановки выполнения на этапе. Обычно это выполняется для выполнения различных действий вручную или действий, а затем выполнение возобновляется или отклоняется.
Это важно
Эта задача поддерживается только в конвейерах YAML и может использоваться только в задании без агента конвейера YAML.
Задача ручной проверки позволяет приостановить выполнение конвейера на этапе, как правило, выполнить некоторые действия вручную или действия, а затем продолжить работу с конвейером. Например, пользователю может потребоваться вручную проверить определенные конфигурации развертывания, прежде чем конвейер начнет длительное вычислительное интенсивное задание.
Конфигурация задачи
Можно указать значение времени ожидания для задачи с помощью необязательного параметра timeoutInMinutes, доступного в общих свойств задач.
Замечание
Чтобы задача выполнялась полностью, timeoutInMinutes значение задания (default = 60 minutes) с этой задачей должно быть выше, чем значение timeoutInMinutes самой задачи. См. значения времени ожидания задания по умолчанию.
Подсказка
Переменные можно использовать для указания адресов электронной почты в параметре notifyUsers.
При активации задачи ручной проверки во время конвейера отображается строка сообщений со ссылкой, которая открывает диалоговое окно проверки вручную, содержащее инструкции. Выполнив действия вручную, администратор или пользователь может возобновить выполнение или отклонить его. Пользователи с очереди создают разрешения на конвейере могут возобновить или отклонить выполнение.
Примеры
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@contoso.com
example@fabrikam.com
instructions: 'Please validate the build configuration and resume'
onTimeout: 'resume'
В этом примере используется timeoutInMinutes, который является общим свойством задачи доступны во всех задачах.
Требования
| Требование | Описание |
|---|---|
| Типы конвейеров | YAML, классическая сборка |
| Выполняется в | Сервер |
| Требования | Отсутствует |
| Возможности | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
| ограничения команд | Любое |
| переменные settable | Любое |
| Версия агента | Все поддерживаемые версии агента. |
| Категория задач | Развертывание |