다음을 통해 공유


ManualValidation@0 - 수동 유효성 검사 v0 작업

이 작업을 사용하여 수동 상호 작용을 기다리도록 YAML 파이프라인 실행을 일시 중지합니다.

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.

입력

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@test.com
          example@example.com
        instructions: 'Please validate the build configuration and resume'
        onTimeout: 'resume'

이 예제에서는 모든 작업에서 사용할 수 있는 일반적인 작업 속성인 를 사용합니다timeoutInMinutes.

요구 사항

요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드
실행 중 서버
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
설정 가능한 변수 모두
에이전트 버전 지원되는 모든 에이전트 버전.
작업 범주 배포