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.

# 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 認可識別碼，例如，您可以使用： 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 作業實例識別碼。 在 Jenkins 下載成品工作中使用此變數，以下載此特定作業實例的成品。