JenkinsQueueJob@2 - Jenkins 큐 작업 v2 작업
이 작업을 사용하여 Jenkins 서버에서 작업을 큐에 대기합니다.
구문론
# 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.
# 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.
입력
serverEndpoint
-
Jenkins 서비스 연결
string; 필수 사항입니다.
Jenkins 인스턴스에 대한 서비스 연결을 지정합니다. 관리 링크를 클릭하여 새 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=
변수가 지원됩니다.
commitId 매개 변수 값을 빌드의 Git 커밋 ID로 설정하려면 다음을 사용할 수 있습니다. commitId=$(Build.SourceVersion). 자세한 내용은 변수 대한설명서를 참조하세요.
지원되는 Jenkins 매개 변수 형식은 다음과 같습니다.
BooleanChoicePasswordString
불안정한 결과failOnUnstableResult - 실패
boolean; 기본값은 false입니다.
성공 정의의 엄격성을 지정하거나 불안정을 실패로 간주할지 여부를 지정합니다.
false 값은 엄격한 버전이 아니고 true 엄격한 버전용입니다.
true설정하면 불안정한 빌드 결과가 실패로 처리됩니다. 그렇지 않으면 불안정한 결과가 성공으로 처리됩니다.
retryCount
-
실패한 연결 대한 재시도 횟수
string; 기본값은 3입니다.
연결 실패 또는 오류가 발생할 때 연결 재시도의 양을 지정합니다.
다시 시도 간 delayBetweenRetries - 시간
string; 기본값은 60입니다.
오류가 발생할 때 연결 재시도 사이의 시간을 지정합니다. 이 값은 초 단위로 지정됩니다.
작업 제어 옵션
모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성참조하세요.
출력 변수
이 작업은 다운스트림 단계, 작업 및 단계에서 사용할 수 있는 다음 출력 변수정의합니다.
JENKINS_JOB_ID
이 태스크에서 큐에 대기하는 Jenkins 작업 인스턴스의 ID입니다. Jenkins 아티팩트 다운로드 태스크에서 이 변수를 사용하여 이 특정 작업 인스턴스에 대한 아티팩트 다운로드
비고
이 작업을 사용하여 Jenkins 서버에서 작업을 큐에 대기합니다.
Team Foundation Server 플러그 인
Team Foundation Server 플러그 인(버전 5.2.0 이상)을 사용하여 Jenkins 작업 영역에서 파일을 자동으로 수집하고 빌드에 다운로드할 수 있습니다.
설정하려면 다음을 수행합니다.
Jenkins 서버에 Team Foundation Server 플러그 인 설치합니다.
Jenkins 서버에서 결과를 수집하려는 각 작업에 대해 빌드 후 작업을 Azure Pipelines/TFS에 대한 결과 수집 추가한 다음 하나 이상의 결과 형식 쌍으로 구성하고 파일 패턴을 포함합니다.
Jenkins 큐 작업에서 빌드 작업은 캡처 콘솔 출력을 사용하도록 설정하고 완료 루트 수준 작업에서 결과를 수집할 때까지 기다리거나 파이프라인 출력을 캡처하고 파이프라인 완료 모든 파이프라인 작업에서 결과를 수집할 때까지 기다립니다.
결과는 $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results.zip 다운로드되고 이 위치로 추출됩니다. 플러그 인에서 수집한 각 결과 형식 집합은 $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/팀 결과 디렉터리 아래에 있습니다. 이 디렉터리에서는 다운스트림 작업(예: 테스트 결과 게시 및 코드 검사 결과 게시)에서 빌드 결과를 게시할 수 있습니다.