DownloadBuildArtifacts@1 - 下载生成项目 v1 任务
语法
# Download build artifacts v1
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@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.
#allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
#branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
#buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build.
#tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags.
downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
artifactName: # string. Required when downloadType == single. Artifact name.
#itemPattern: '**' # string. Matching pattern. Default: **.
downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
#cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
# Advanced
#parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
#checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
#retryDownloadCount: '4' # string. Retry count. Default: 4.
#extractTars: # boolean. Extract all files that are stored inside tar archives.
输入
buildType
- 下载生成的项目
string
. 必需。 允许的值: current
(当前生成) , specific
(特定生成) 。 默认值:current
。
是下载当前生成生成的项目,还是从特定内部版本下载项目。
project
- 项目
string
. 当 buildType == specific
时,需要此选项。
要从中下载生成项目的项目。
pipeline
- 生成管道
输入别名: definition
。 string
. 当 buildType == specific
时,需要此选项。
指定生成管道名称。
specificBuildWithTriggering
- 适当时,请从触发生成下载项目。
boolean
. 可选。 在 时 buildType == specific
使用 。 默认值:false
。
如果 true
为 ,则此生成任务会尝试从触发生成下载项目。 如果没有从指定的管道触发生成,它将从以下选项中指定的生成下载项目。
buildVersionToDownload
- 要下载的内部版本
string
. 当 buildType == specific
时,需要此选项。 允许的值: latest
、 latestFromBranch
(来自特定分支的 Latest 和指定的生成标记) , specific
(特定版本) 。 默认值:latest
。
指定要下载的内部版本。
- 选择
latest
下载最新的可用内部版本。 - 选择
latestFromBranch
下载 由branchName
指定的分支的最新可用内部版本和 指定的tags
标记。 - 选择
specific
下载 指定的buildId
生成版本。
allowPartiallySucceededBuilds
- 甚至从部分成功的生成下载项目。
boolean
. 可选。 在 时 buildType == specific && buildVersionToDownload != specific
使用 。 默认值:false
。
如果 true
为 ,则无论生成成功还是部分成功,此生成任务都会尝试下载项目。
branchName
- 分支名称
string
. 当 buildType == specific && buildVersionToDownload == latestFromBranch
时,需要此选项。 默认值:refs/heads/master
。
指定是否根据分支/引用名称进行筛选,例如: refs/heads/develop
。
buildId
- 建立
string
. 当 buildType == specific && buildVersionToDownload == specific
时,需要此选项。
要从中下载项目的生成。
tags
- 生成标记
string
. 可选。 在 时 buildType == specific && buildVersionToDownload != specific
使用 。
以逗号分隔的标记列表。 仅返回具有这些标记的生成。
downloadType
- 下载类型
string
. 必需。 允许的值: single
(特定项目) , specific
(特定文件) 。 默认值:single
。
从生成中下载特定项目或特定文件。
- 如果只想指定一个特定项目,请选择
single
“ (特定项目”)artifactName
- 如果需要所选生成的所有项目,请选择
specific
(特定文件)
artifactName
- 项目名称
string
. 当 downloadType == single
时,需要此选项。
要下载的项目的名称。
itemPattern
- 匹配模式
string
. 默认值:**
。
指定要下载为多行小型匹配模式的文件。 有关详细信息,请参阅 文件匹配模式参考。
如果选择“特定文件”选项,则默认模式 \*\*
将下载生成中所有项目中的所有 文件 。 若要下载项目放置中的所有文件,请使用 drop/**
。
downloadPath
- 目标目录
string
. 必需。 默认值:$(System.ArtifactsDirectory)
。
下载项目的代理计算机上的路径。
cleanDestinationFolder
- 清理目标文件夹
boolean
. 默认值:false
。
在下载项目之前,请删除目标文件夹中的所有现有文件。
parallelizationLimit
- 并行化限制
string
. 默认值:8
。
要同时下载的文件数。
checkDownloadedFiles
- 检查下载的文件
boolean
. 默认值:false
。
如果 true
为 ,则此生成任务会检查是否已完全下载所有文件。
retryDownloadCount
- 重试计数
string
. 默认值:4
。
下载失败时重试下载生成项目的次数。
extractTars
- 提取存储在 tar 存档中的所有文件
boolean
.
true
设置为 可提取扩展名为 .tar 的所有已下载文件。 这很有用,因为如果要保留 Unix 文件权限,则需要将项目文件打包到 tar 中。 启用StoreAsTar
“发布生成项目”任务中的 选项将自动将项目存储为 .tar 文件。
任务控制选项
除了任务输入,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性。
输出变量
注解
注意
Azure Pipelines 团队建议从 生成项目 升级到 管道项目 ,以提高性能。
要求
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈