DownloadPipelineArtifact@1 - 下載管線成品 v1 工作

發行項
2025-03-24

使用此工作可從此管線的舊階段，或從另一個管線下載管線成品。

此工作有較新版本。如需詳細資訊，請參閱 DownloadPipelineArtifact@2。

備註

如需詳細資訊，包括 Azure CLI 命令，請參閱下載成品。

使用此工作可從此管線的舊階段，或從另一個管線下載管線成品。

這很重要

Azure DevOps Services 僅支援這項工作。如果您在 Azure DevOps Server 上使用，如果您使用 Azure DevOps Server 或 TFS 2018，則會收到類似 Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. 使用下載組建成品的錯誤訊息。

語法

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@1
  inputs:
    buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when buildType == specific. Project. 
    #pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

輸入

buildType - 下載所產生的成品
string。必須的。允許的值：current（目前的組建）、specific（特定組建）。預設值：current。

下載目前管線執行或從特定管線執行所產生的成品。

project - Project
string。 buildType == specific時為必要項。

指定要從中下載管線成品的項目名稱或 GUID。

pipeline - 建置管線
輸入別名：definition。 string。 buildType == specific時為必要項。

管線的定義標識碼。在執行中的管線中，definitionId 可以在 System.DefinitionId 變數中找到。您也可以從 Azure DevOps 入口網站中管線概觀頁面上的 URL 擷取 definitionId。在下列 URL 範例中，definitionId 為 78：https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary。若要從特定管線定義下載成品，請從該管線擷取 definitionId，並將其指定為 pipeline 參數。

specificBuildWithTriggering - 適當時，請從觸發組建下載成品。
boolean。選擇性。 buildType == specific時使用。預設值：false。

如果核取，工作會從觸發組建下載成品。如果沒有從指定的管線觸發組建，工作會從下列選項中指定的組建下載成品。

buildVersionToDownload - 組建版本以下載
string。 buildType == specific時為必要項。允許的值：latest、latestFromBranch（來自特定分支的最新和指定的組建標籤）、specific（特定版本）。預設值：latest。

指定要下載的組建版本。

branchName - 分支名稱
string。 buildType == specific && buildVersionToDownload == latestFromBranch時為必要項。預設值：refs/heads/master。

指定分支/ref 名稱上的篩選。例如： refs/heads/develop 。

pipelineId - 組建
輸入別名：buildId。 string。 buildType == specific && buildVersionToDownload == specific時為必要項。

要從中下載成品的管線執行標識符。在執行中的管線中，您可以在 Build.BuildId 變數中找到 buildId。您也可以從 Azure DevOps 入口網站中管線執行摘要頁面上的 URL 擷取 buildId。在下列 URL 範例中，buildId 為 1088：https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results。若要從特定管線執行下載成品，請從該執行擷取 buildId，並將其指定為 buildId 參數。

tags - 建置標籤
string。選擇性。 buildType == specific && buildVersionToDownload != specific時使用。

工作用來傳回標記組建的標記逗號分隔清單。未標記的組建不會傳回。

artifactName - 成品名稱
string。

指定要下載的成品名稱。如果值保留空白，工作會下載與管線執行相關聯的所有成品。

itemPattern - 比對模式
string。預設值：**。

限制所下載檔案的檔案比對模式。值可以是一或多個以新行分隔的檔案比對模式。深入瞭解檔案比對模式。

targetPath - 目的地目錄
輸入別名：downloadPath。 string。必須的。預設值：$(System.ArtifactsDirectory)。

將下載成品之代理程式電腦上的路徑。

工作控制選項

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

輸出變數

沒有。

備註

此工作有較新版本。如需詳細資訊，請參閱 DownloadPipelineArtifact@2。

這很重要

根據預設，成品會下載至 $(Pipeline.Workspace)。如果您未指定成品名稱，則會為每個下載的成品建立子目錄。您可以使用檔案比對模式來限制您想要下載的檔案。

如何尋找要從中下載成品的管線標識碼？

若要尋找特定管線定義的 definitionId

在執行中的管線中，您可以在 System.DefinitionId 變數中找到 definitionId。您也可以從 Azure DevOps 入口網站中管線概觀頁面上的 URL 擷取 definitionId。在下列 URL 範例中，definitionId 為 78：https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary。若要從特定管線定義下載成品，請從該管線擷取 definitionId，並將其指定為 pipeline 參數。

尋找特定管線執行的 buildId

需求

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

共用方式為