使用此任务下载 Jenkins 作业生成的项目。
语法
# 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
-
下载提交和 WorkItems
boolean
。 默认值:false
。
启用下载与 Jenkins 作业关联的提交和工作项详细信息。
startJenkinsBuildNumber
-
从 下载提交和工作项
string
。 可选。 当 downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber
时使用。
启动用于下载提交和工作项的生成号。 如果提供,则下载开始内部版本号和生成号之间的所有提交和工作项(作为下载项目的输入)。
artifactDetailsFileNameSuffix
-
Commit 和 WorkItem FileName
string
。 可选。 当 downloadCommitsAndWorkItems == invalid
时使用。
指定提交和工作项附件的文件名后缀。 附件是使用 commits_{suffix}.json
和 workitem_{suffix}.json
创建的。 如果未提供此输入,则会使用名称 commits.json
和 workitems.json
创建附件。
propagatedArtifacts
-
项目传播到 Azure
boolean
。 默认值:false
。
如果 Jenkins 项目传播到 Azure,请使用此输入。 若要将 Jenkins 项目上传到 Azure,请参阅此 Jenkins 插件。
artifactProvider
-
项目提供程序
string
。
propagatedArtifacts == notValid
时是必需的。 允许的值:azureStorage
(Azure 存储)。 默认值:azureStorage
。
指定 Jenkins 作业中用于上传项目的外部存储提供程序。
ConnectedServiceNameARM
-
Azure 订阅
string
。
propagatedArtifacts == true
时是必需的。
指定项目的 Azure 资源管理器订阅。
storageAccountName
-
存储帐户名称
string
。
propagatedArtifacts == true
时是必需的。
指定 Azure 经典或资源管理器存储帐户。 选择传播项目的存储帐户名称。
containerName
-
容器名称
string
。
propagatedArtifacts == true
时是必需的。
指定上传项目的存储帐户中的容器的名称。
commonVirtualPath
-
通用虚拟路径
string
。 可选。 当 propagatedArtifacts == true
时使用。
指定 Azure 存储容器中项目的路径。
任务控制选项
除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性。
输出变量
没有。
注解
使用此任务下载 Jenkins 作业生成的项目。