ManualValidation@0 — задача проверки вручную версии 0

Статья
06/11/2024

Используйте эту задачу, чтобы приостановить выполнение конвейера YAML, чтобы дождаться ручного взаимодействия.

Синтаксис

# 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 дней в зависимости от того, какое из значений наступит раньше.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Используйте эту задачу в конвейере YAML, чтобы приостановить выполнение на этапе. Обычно это выполняется для выполнения различных действий, выполняемых вручную, а затем выполнение возобновляется или отклоняется.

Важно!

Эта задача поддерживается только в конвейерах YAML и может использоваться только в задании без агента конвейера YAML.

Задача "Проверка вручную " позволяет приостановить выполнение конвейера на этапе, обычно для выполнения некоторых действий вручную, а затем продолжить работу с конвейером. Например, пользователю может потребоваться вручную проверить определенные конфигурации развертывания, прежде чем конвейер запустит длительное ресурсоемкое вычислительное задание.

Конфигурация задачи "Проверка вручную " включает параметр инструкций , который используется для предоставления связанных сведений или указания действий, выполняемых пользователем во время приостановки. Вы можете настроить задачу для отправки Уведомления по электронной почте пользователям и группам пользователей, когда она ожидает проверки, и указать автоматический ответ (отклонение или возобновление) по истечении настраиваемого времени ожидания.

Значение времени ожидания для задачи можно указать с помощью необязательного timeoutInMinutes параметра, доступного в общих свойствах задачи.

Примечание

Для полного выполнения задачи значение задания (default = 60 minutes), содержащего эту задачу, timeoutInMinutes должно быть выше, чем 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@test.com
          example@example.com
        instructions: 'Please validate the build configuration and resume'
        onTimeout: 'resume'

В этом примере используется timeoutInMinutes свойство , которое является общим свойством задачи , доступным во всех задачах.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка
Выполняется в	Сервер
Требования	Нет
Capabilities	Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд	Любой
Устанавливаемые переменные	Любой
Версия агента	Все поддерживаемые версии агента.
Категория задач	Развертывание

Поделиться через