다음을 통해 공유

JenkinsQueueJob@1 - Jenkins 큐 작업 v1 작업

  • 아티클

이 작업을 사용하여 Jenkins 서버에서 작업을 큐에 대기합니다.

Syntax

# Jenkins Queue Job v1
# Queue a job on a Jenkins server.
- task: JenkinsQueueJob@1
  inputs:
    serverEndpoint: # string. Required. Jenkins service endpoint. 
    jobName: # string. Required. Job name. 
    #isMultibranchJob: false # boolean. Job is of Multibranch Pipeline type. Default: false.
    #multibranchPipelineBranch: # string. Required when isMultibranchJob = true. Multibranch Pipeline Branch. 
    #captureConsole: true # boolean. Capture console output and wait for completion. Default: true.
    #capturePipeline: true # boolean. Optional. Use when captureConsole = true. Capture pipeline output and wait for pipeline completion. Default: true.
  # Advanced
    #parameterizedJob: false # boolean. Parameterized job. Default: false.
    #jobParameters: # string. Optional. Use when parameterizedJob = true. Job parameters.

입력

serverEndpoint - Jenkins 서비스 엔드포인트
string. 필수 요소.

Jenkins instance 대한 서비스 엔드포인트를 지정합니다. 관리 링크(작업 도우미 사용하는 경우)를 클릭하여 새 Jenkins 서비스 엔드포인트를 만듭니다.


jobName - 작업 이름
string. 필수 요소.

큐에 대기할 Jenkins 작업의 이름입니다. Jenkins 서버의 작업 이름과 정확히 일치해야 합니다.


isMultibranchJob - 작업은 멀티브랜치 파이프라인 유형입니다.
boolean. 기본값은 false입니다.

이 작업은 멀티브랜치 파이프라인입니다. 지정한 경우 적절한 분기 이름을 추가합니다. 이 입력을 사용하려면 Jenkins v5.3.4 이상용 Team Foundation Server 플러그 인이 필요합니다.


multibranchPipelineBranch - 멀티브랜치 파이프라인 분기
string. 필요한 경우 isMultibranchJob = true입니다.

지정된 분기에 이 멀티브랜치 파이프라인 작업을 큐에 대기합니다. 이 입력을 사용하려면 Jenkins v5.3.4 이상용 Team Foundation Server 플러그 인이 필요합니다.


captureConsole - 콘솔 출력 캡처 및 완료 대기
boolean. 기본값은 true입니다.

지정된 경우 이 입력은 Jenkins 빌드 콘솔 출력을 캡처하고 Jenkins 빌드가 완료될 때까지 대기하며 Jenkins 빌드 결과에 따라 성공/실패합니다. 그렇지 않으면 Jenkins 작업이 큐에 추가되면 Jenkins 빌드가 실행될 때까지 기다리지 않고 이 단계가 성공적으로 완료됩니다.


capturePipeline - 파이프라인 출력 캡처 및 파이프라인 완료 대기
boolean. 선택 사항입니다. 을 사용할 때 captureConsole = true사용합니다. 기본값은 true입니다.

지정된 경우 이 입력은 전체 Jenkins 빌드 파이프라인 콘솔 출력을 캡처하고 전체 Jenkins 빌드 파이프라인이 완료될 때까지 대기하며 Jenkins 빌드 파이프라인 결과에 따라 성공/실패합니다. 그렇지 않으면 첫 번째 Jenkins 작업이 완료되면 전체 Jenkins 빌드 파이프라인이 실행될 때까지 기다리지 않고 이 입력이 성공적으로 완료됩니다.


parameterizedJob - 매개 변수가 있는 작업
boolean. 기본값은 false입니다.

Jenkins 작업이 매개 변수를 허용하는지 지정합니다. 모든 기본 매개 변수 값이 사용되고 매개 변수가 실제로 지정되지 않은 경우에도 이 입력을 사용합니다.


jobParameters - 작업 매개 변수
string. 선택 사항입니다. 을 사용할 때 parameterizedJob = true사용합니다.

한 줄당 하나씩 작업 매개 변수를 지정합니다(예: <parameterName>=<parameterValue>).

매개 변수를 기본값을 재정의하는 데 유용한 빈 값으로 설정하려면 매개 변수 값을 둡니다. 예를 들어 를 지정합니다 <parameterName>=.

변수가 지원됩니다. 예를 들어 매개 변수 값을 빌드의 Git 커밋 ID 설정 commitId 하려면 를 사용할 commitId=$(Build.SourceVersion)수 있습니다. 자세한 내용은 변수에 대한 설명서를 참조하세요.

지원되는 Jenkins 매개 변수 형식은 다음과 같습니다.

  • Boolean
  • Choice
  • Password
  • String

작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

없음

요구 사항

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