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.

輸入

serverEndpoint - Jenkins 服務連線
string。 必須的。

指定 Jenkins 實例的服務連線。 按兩下 [管理] 連結以建立新的 Jenkins 服務連線。

jobName - 作業名稱
string。 必須的。

要排入佇列的 Jenkins 作業名稱。 這必須完全符合 Jenkins 伺服器上的作業名稱。

isMultibranchJob - 作業是多任務管線類型
boolean。 預設值：false。

此作業是多任務運算管線。 如果指定，請新增適當的分支名稱。 此輸入需要適用於 Jenkins v5.3.4 或更新版本的 Team Foundation Server 外掛程式。

multibranchPipelineBranch - Multibranch 管線分支
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
需求	沒有
功能	此工作不符合作業中後續工作的任何需求。
命令限制	任意
Settable 變數	任意
代理程式版本	2.144.0 或更新
工作類別	建造