下载 Jenkins 作业生成的项目。
注释
此版本的任务使用 Azure RBAC 连接到 Azure 存储。 有关详细信息,请参阅 配置 Azure RBAC 以访问 Azure 存储。
语法
# Jenkins download artifacts v2
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@2
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 实例选择服务连接。 要创建一个连接,请单击 Manage 链接并创建新的 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
。 默认值:**
。
指定要下载为多行 minimatch 模式的文件。 详细信息
默认模式 (**) 将下载 Jenkins 作业生成的所有工件中的所有文件。 要下载 artifact drop 中的所有文件,请使用 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 Resource Manager 订阅。
注释
此版本的任务使用 Azure RBAC 连接到 Azure 存储。 有关详细信息,请参阅 配置 Azure RBAC 以访问 Azure 存储。
storageAccountName
-
存储帐户名称
string
。
propagatedArtifacts == true
时是必需的。
将列出 Azure 经典帐户和 Resource Manager 存储库帐户。 选择在其中传播项目的 Storage account name (存储帐户名称)。
containerName
-
容器名称
string
。
propagatedArtifacts == true
时是必需的。
项目上传到的存储帐户中的容器的名称。
commonVirtualPath
-
通用虚拟路径
string
。 可选。 当 propagatedArtifacts == true
时使用。
Azure 存储容器中项目的路径。
任务控制选项
除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性。
输出变量
没有。
注解
配置 Azure RBAC 以访问 Azure 存储
此版本的任务使用使用工作负载联合身份验证和 Azure RBAC 配置的 Azure 资源管理器服务连接 来连接到 Azure 存储,而不是存储帐户密钥或共享访问签名 (SAS)。 若要从此任务连接到 Azure 存储,必须将存储帐户上的 “存储 Blob 数据参与者 ”角色分配给为 ConnectedServiceNameARM
配置的服务连接的标识。 有关详细信息,请参阅分配 Azure 角色以访问 blob 数据和分配角色的步骤。