JenkinsDownloadArtifacts@1 - Jenkins 下載成品 v1 工作

使用此工作來下載 Jenkins 作業所產生的成品。

語法

# Jenkins download artifacts v1
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@1
  inputs:
    jenkinsServerConnection: # string. Alias: serverEndpoint. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #jenkinsJobType: # string. Optional. Use when jobName = invalidjobName. Jenkins job type. 
    saveTo: 'jenkinsArtifacts' # string. Required. Save to. Default: jenkinsArtifacts.
  # Advanced
    jenkinsBuild: 'LastSuccessfulBuild' # 'LastSuccessfulBuild' | 'BuildNumber'. Required. Download artifacts produced by. Default: LastSuccessfulBuild.
    #jenkinsBuildNumber: '1' # string. Required when jenkinsBuild == BuildNumber. Jenkins build number. Default: 1.
    #itemPattern: '**' # string. Item Pattern. Default: **.
    #downloadCommitsAndWorkItems: false # boolean. Download Commits and WorkItems. Default: false.
    #startJenkinsBuildNumber: # string. Optional. Use when downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber. Download commits and work items from. 
    #artifactDetailsFileNameSuffix: # string. Optional. Use when downloadCommitsAndWorkItems == invalid. Commit and WorkItem FileName. 
  # Propagated Artifacts
    #propagatedArtifacts: false # boolean. Artifacts are propagated to Azure. Default: false.
    #artifactProvider: 'azureStorage' # 'azureStorage'. Required when propagatedArtifacts == notValid. Artifact Provider. Default: azureStorage.
    #ConnectedServiceNameARM: # string. Required when propagatedArtifacts == true. Azure Subscription. 
    #storageAccountName: # string. Required when propagatedArtifacts == true. Storage Account Name. 
    #containerName: # string. Required when propagatedArtifacts == true. Container Name. 
    #commonVirtualPath: # string. Optional. Use when propagatedArtifacts == true. Common Virtual Path.

輸入

jenkinsServerConnection - Jenkins 服務連線
輸入別名：serverEndpoint。 string。 必須的。

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

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

指定要從中下載成品的 Jenkins 作業名稱。 這必須完全符合 Jenkins 伺服器上的作業名稱。

jenkinsJobType - Jenkins 作業類型
string。 選擇性。 jobName = invalidjobName時使用 。

自動指定 Jenkins 作業類型。

saveTo - 儲存至
string。 必須的。 預設值：jenkinsArtifacts。

指定下載並儲存 Jenkins 成品的目錄。 如果目錄不存在，就會建立此目錄。

jenkinsBuild - 下載 所產生的成品
string。 必須的。 允許的值：LastSuccessfulBuild（上次成功建置）、BuildNumber（組建編號）。 預設值：LastSuccessfulBuild。

下載最後一次成功組建或從特定組建實例產生的成品。

jenkinsBuildNumber - Jenkins 組建編號
string。 jenkinsBuild == BuildNumber時為必要項。 預設值：1。

下載此組建所產生的成品。

itemPattern - 專案模式
string。 預設值：**。

指定要下載為多行迷你模式的檔案。 檔案比對模式的詳細資訊。

默認模式 ** 會跨 Jenkins 作業所產生的所有成品下載所有檔案。 若要下載成品置放中的所有檔案，請使用 drop/**。

downloadCommitsAndWorkItems - 下載認可和 WorkItems
boolean。 預設值：false。

啟用下載與 Jenkins 作業相關聯的認可和工作專案詳細數據。

startJenkinsBuildNumber - 從 下載認可和工作專案
string。 選擇性。 downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber時使用 。

啟動下載認可和工作專案的組建編號。 如果提供，則會下載開始組建編號和作為下載成品輸入的組建編號之間的所有認可和工作專案。

artifactDetailsFileNameSuffix - Commit 和 WorkItem FileName
string。 選擇性。 downloadCommitsAndWorkItems == invalid時使用 。

指定認可和工作專案附件的檔名後綴。 附件會以 commits_{suffix}.json 和 workitem_{suffix}.json建立。 如果未提供此輸入，則會使用名稱 commits.json 建立附件，並 workitems.json。

propagatedArtifacts - 成品會傳播至 Azure
boolean。 預設值：false。

如果 Jenkins 成品傳播至 Azure，請使用此輸入。 若要將 Jenkins 成品上傳至 Azure，請參閱此 Jenkins 外掛程式。

artifactProvider - 成品提供者
string。 propagatedArtifacts == notValid時為必要項。 允許的值：azureStorage （Azure 記憶體）。 預設值：azureStorage。

指定 Jenkins 作業中用來上傳成品的外部記憶體提供者。

ConnectedServiceNameARM - Azure 訂用帳戶
string。 propagatedArtifacts == true時為必要項。

指定成品的 Azure Resource Manager 訂用帳戶。

storageAccountName - 記憶體帳戶名稱
string。 propagatedArtifacts == true時為必要項。

指定 Azure 傳統或 Resource Manager 儲存器帳戶。 選取傳播成品的記憶體帳戶名稱。

containerName - 容器名稱
string。 propagatedArtifacts == true時為必要項。

指定上傳成品之記憶體帳戶中的容器名稱。

commonVirtualPath - 一般虛擬路徑
string。 選擇性。 propagatedArtifacts == true時使用 。

指定 Azure 記憶體容器內成品的路徑。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。

輸出變數

沒有。

備註

使用此工作來下載 Jenkins 作業所產生的成品。

需求

要求	說明
管線類型	YAML、傳統組建、傳統版本
執行於	Agent、DeploymentGroup
需求	沒有
功能	此工作不符合作業中後續工作的任何需求。
命令限制	任意
Settable 變數	任意
代理程式版本	2.144.0 或更新
工作類別	效用