다음을 통해 공유


ManualValidation@1 - 수동 유효성 검사 v1 작업

파이프라인 실행을 일시 중지하여 수동 상호 작용을 기다립니다. 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.

입력

사용자에게 알림
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'

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

요구 사항

요구 묘사
파이프라인 유형 YAML, 클래식 빌드
다음에서 실행 서버
요구 없음
기능 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 어떤
settable 변수 어떤
에이전트 버전 지원되는 모든 에이전트 버전입니다.
작업 범주 전개시키다