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

Статья
11/21/2024

Приостановка выполнения конвейера для ожидания взаимодействия вручную. Работает только с конвейерами YAML.

Синтаксис

# Manual validation v1
# Pause a pipeline run to wait for manual interaction. Works only with YAML pipelines.
- task: ManualValidation@1
  inputs:
    notifyUsers: # string. Required. Notify users. 
    #approvers: # string. Approvers. 
    #allowApproversToApproveTheirOwnRuns: false # boolean. Allow approvers to approve their own run. Default: false.
    #instructions: # string. Instructions. 
    #onTimeout: 'reject' # 'reject' | 'resume'. On timeout. Default: reject.

Входы

notifyUsers - уведомлять пользователей
string. Обязательно.

Отправьте сообщение электронной почты, ожидающее проверки вручную, в разделенный запятыми список определенных пользователей (или групп). Вы можете отправить сообщение электронной почты в группу с помощью синтаксиса имени [org name]\group.

Для ввода этой задачи требуется, но можно указать пустую строку, если вы не хотите уведомлять кого-либо, например во время тестового выполнения: notifyUsers: ''.

approvers - утверждающие
string.

Укажите разделенный запятыми список пользователей, групп или проектов, чтобы выполнить проверку вручную. При отсутствии входных данных пользователи с разрешением на сборку очереди смогут принять меры.

allowApproversToApproveTheirOwnRuns - Разрешить утверждающие утвердить собственные запуска
boolean. Значение по умолчанию: false.

Если это верно, утверждающий сможет утвердить свой собственный запуск.

Важный

Функции allowApproversToApproveTheirOwnRuns по-прежнему развертываются в Azure DevOps и в настоящее время не включены.

Инструкции 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@1
      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, классическая сборка
Выполняется в	Сервер
требования	Никакой
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любой
переменные settable	Любой
Версия агента	Все поддерживаемые версии агента.
Категория задач	Развертывать

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