JenkinsDownloadArtifacts@1 - Jenkins 下载项目 v1 任务

使用此任务下载 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 服务连接
输入别名:serverEndpointstring。 必填。

指定 Jenkins 实例的服务连接。 若要创建新的服务连接,请单击“管理”链接。


jobName - 作业名称
string。 必填。

指定要从中下载项目的 Jenkins 作业的名称。 这必须与 Jenkins 服务器上的作业名称完全匹配。


jenkinsJobType - Jenkins 作业类型
string。 可选。 当 jobName = invalidjobName时使用。

自动指定 Jenkins 作业类型。


saveTo - 保存到
string。 必填。 默认值:jenkinsArtifacts

指定下载并保存 Jenkins 项目的目录。 如果该目录不存在,则会创建此目录。


jenkinsBuild - 下载由 生成的项目
string。 必填。 允许的值:LastSuccessfulBuild(上次成功生成)、BuildNumber(生成号)。 默认值:LastSuccessfulBuild

下载上次成功生成或从特定生成实例生成的项目。


jenkinsBuildNumber - Jenkins 内部版本号
stringjenkinsBuild == 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}.jsonworkitem_{suffix}.json创建的。 如果未提供此输入,则会使用名称 commits.jsonworkitems.json创建附件。


propagatedArtifacts - 项目传播到 Azure
boolean。 默认值:false

如果 Jenkins 项目传播到 Azure,请使用此输入。 若要将 Jenkins 项目上传到 Azure,请参阅此 Jenkins 插件


artifactProvider - 项目提供程序
stringpropagatedArtifacts == notValid时是必需的。 允许的值:azureStorage(Azure 存储)。 默认值:azureStorage

指定 Jenkins 作业中用于上传项目的外部存储提供程序。


ConnectedServiceNameARM - Azure 订阅
stringpropagatedArtifacts == true时是必需的。

指定项目的 Azure 资源管理器订阅。


storageAccountName - 存储帐户名称
stringpropagatedArtifacts == true时是必需的。

指定 Azure 经典或资源管理器存储帐户。 选择传播项目的存储帐户名称。


containerName - 容器名称
stringpropagatedArtifacts == true时是必需的。

指定上传项目的存储帐户中的容器的名称。


commonVirtualPath - 通用虚拟路径
string。 可选。 当 propagatedArtifacts == true时使用。

指定 Azure 存储容器中项目的路径。


任务控制选项

除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性

输出变量

没有。

注解

使用此任务下载 Jenkins 作业生成的项目。

要求

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