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

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

Syntax

# 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 - 下載 Commits 和 WorkItems
boolean. 預設值：false。

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

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

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

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

指定認可和工作專案附件的檔名後綴。 附件是使用 commits_{suffix}.json 和 workitem_{suffix}.json建立。 如果未提供此輸入，則會使用名稱和 commits.jsonworkitems.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
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
可設定變數	任何
代理程式版本	2.144.0 或更新版本
工作類別	公用程式