使用此任务可从此管道的早期阶段或另一个管道下载管道项目。
此任务有较新版本。 有关详细信息,请参阅 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
-
项目
string
。
buildType == specific
时是必需的。
指定要从中下载管道项目的项目名称或 GUID。
pipeline
-
生成管道
输入别名: definition
.
string
。
buildType == 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
-
生成版本以下载
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
时是必需的。
从中下载项目的管道运行的标识符。 在正在运行的管道中,可以在 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
。
指定要下载的项目的名称。 如果该值留空,任务将下载与管道运行关联的所有项目。
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
参数。