DownloadPipelineArtifact@1 - 下载管道项目 v1 任务

使用此任务可从此管道的早期阶段或另一个管道下载管道项目。

此任务有较新版本。 有关详细信息,请参阅 DownloadPipelineArtifact@2

注释

有关详细信息,包括 Azure CLI 命令,请参阅 下载项目

使用此任务可从此管道的早期阶段或另一个管道下载管道项目。

重要

仅 Azure DevOps Services 支持此任务。 如果在 Azure DevOps Server 上使用它,将收到类似于 Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. 使用 下载生成项目(如果使用 Azure DevOps Server 或 TFS 2018)的错误消息。

语法

# 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 - 项目
stringbuildType == specific时是必需的。

指定要从中下载管道项目的项目名称或 GUID。


pipeline - 生成管道
输入别名definition. stringbuildType == specific时是必需的。

管道的定义 ID。 在正在运行的管道中,可以在 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 - 生成版本以下载
stringbuildType == specific时是必需的。 允许的值:latestlatestFromBranch(特定分支的最新版本和指定的生成标记)、specific(特定版本)。 默认值:latest

指定要下载的生成版本。


branchName - 分支名称
stringbuildType == specific && buildVersionToDownload == latestFromBranch时是必需的。 默认值:refs/heads/master

指定分支/ref 名称上的筛选器。 例如: refs/heads/develop


pipelineId - 生成
输入别名buildId. stringbuildType == specific && buildVersionToDownload == specific时是必需的。

从中下载项目的管道运行的标识符。 在正在运行的管道中,可以在 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

重要

仅 Azure DevOps Services 支持此任务。 如果在 Azure DevOps Server 上使用它,将收到类似于 Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. 使用 下载生成项目(如果使用 Azure DevOps Server 或 TFS 2018)的错误消息。

默认情况下,项目下载到 $(Pipeline.Workspace)。 如果未指定项目名称,则会为每个下载的项目创建一个子目录。 可以使用 文件匹配模式 来限制要下载的文件。

如何查找要从中下载项目的管道 ID?

查找特定管道定义的 definitionId

在正在运行的管道中,可以在 definitionId 变量中找到 。 还可以从 Azure DevOps 门户中管道概述页上的 URL 检索 definitionId。 在以下 URL 示例中,definitionId 为 78:https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary。 若要从特定管道定义下载项目,请从该管道捕获 definitionId,并将其指定为 pipeline 参数。

查找特定管道运行的 buildId

从中下载项目的管道运行的标识符。 在正在运行的管道中,可以在 buildId 变量中找到 。 还可以从 Azure DevOps 门户中管道运行摘要页上的 URL 检索 buildId。 在以下 URL 示例中,buildId 为 1088:https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results。 若要从特定管道运行下载项目,请从该运行中捕获 buildId,并将其指定为 buildId 参数。

要求

要求 说明
管道类型 YAML,经典版本,经典版本
运行时间 代理,DeploymentGroup
需求 没有
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任何
Settable 变量 任何
代理版本 2.155.1 或更高版本
任务类别 效用