JenkinsQueueJob@2 - Jenkins 큐 작업 v2 작업

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

Syntax

# Jenkins queue job v2
# Queue a job on a Jenkins server.
- task: JenkinsQueueJob@2
  inputs:
    serverEndpoint: # string. Required. Jenkins service connection. 
    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
    #isParameterizedJob: false # boolean. Alias: parameterizedJob. Parameterized job. Default: false.
    #jobParameters: # string. Optional. Use when parameterizedJob = true. Job parameters. 
    #failOnUnstableResult: false # boolean. Fail on unstable result. Default: false.
    #retryCount: '3' # string. Number of retries for failed connection. Default: 3.
    #delayBetweenRetries: '60' # string. Time between retries. Default: 60.

입력

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 빌드 파이프라인이 실행될 때까지 기다리지 않고 이 작업이 성공적으로 완료됩니다.

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

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

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

한 줄당 하나씩 의 형식 <parameterName>=<parameterValue>으로 작업 매개 변수를 지정합니다.

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

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

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

• Boolean
• Choice
• Password
• String

failOnUnstableResult - 불안정한 결과에서 실패
boolean. 기본값은 false입니다.

성공 정의의 엄격성 또는 불안정을 실패로 간주할지 여부를 지정합니다. 값은 false 비고급 버전에 대한 것이며 true 는 strict 버전용입니다. 로 true설정하면 불안정한 빌드 결과가 실패로 처리됩니다. 그렇지 않으면 불안정한 결과가 성공으로 처리됩니다.

retryCount - 실패한 연결에 대한 재시도 횟수
string. 기본값은 3입니다.

연결 실패 또는 오류가 발생할 때 연결 다시 시도의 양을 지정합니다.

delayBetweenRetries - 재시도 사이의 시간
string. 기본값은 60입니다.

오류가 발생할 때 연결 재시도 사이의 시간을 지정합니다. 이 값은 초 단위로 지정됩니다.

작업 제어 옵션

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

출력 변수

이 작업은 다운스트림 단계, 작업 및 단계에서 사용할 수 있는 다음 출력 변수를 정의합니다.

JENKINS_JOB_ID
Jenkins 작업의 ID는 이 작업에서 큐에 대기할 instance 있습니다. Jenkins 아티팩트 다운로드 태스크에서 이 변수를 사용하여 이 특정 작업 instance 대한 아티팩트 다운로드를 참조하세요.

설명

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

Team Foundation Server 플러그 인

Team Foundation Server 플러그 인(버전 5.2.0 이상)을 사용하여 Jenkins 작업 영역에서 파일을 자동으로 수집하고 빌드에 다운로드할 수 있습니다.

설정하려면 다음을 수행합니다.

1. Jenkins 서버에 Team Foundation Server 플러그 인 을 설치합니다.

2. Jenkins 서버에서 결과를 수집하려는 각 작업에 대해 Azure Pipelines/TFS 빌드 후 작업에 대한 결과 수집 작업을 추가한 다음 하나 이상의 결과 형식 쌍으로 구성하고 파일 패턴을 포함합니다.

3. Jenkins 큐 작업에서 빌드 작업은 캡처 콘솔 출력을 사용하도록 설정하고 완료가 루트 수준 작업 또는 캡처 파이프라인 출력에서 결과를 수집할 때까지 기다렸다가 파이프라인 완료가 모든 파이프라인 작업에서 결과를 수집할 때까지 기다립니다.

결과는 $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results.zip 다운로드되고 이 위치로 추출됩니다. 플러그 인에서 수집한 각 결과 형식 집합은 팀 결과 디렉터리 $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/아래에 있습니다. 다운스트림 작업(예: 테스트 결과 게시 및 코드 검사 결과 게시)에서 빌드 결과를 게시할 수 있는 디렉터리입니다.

요구 사항

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