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 實例的服務連線。 按兩下 [管理] 連結以建立新的 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 下載成品工作中使用此變數，以下載此特定作業實例的成品。

備註

使用此工作將 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 並解壓縮至此位置。 外掛程式收集的每個結果類型集都會位於 team-results 目錄下， $ (Build.StagingDirectory) /jenkinsResults/Job Name/team-results/ResultType/。 這是下游工作 (可以發佈建置結果的目錄，例如發佈測試結果和發佈程式代碼涵蓋範圍結果) 。

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
在上執行	Agent、DeploymentGroup
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
可設定變數	任何
代理程式版本	2.144.0 或更新版本
工作類別	建置