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.
# 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 内部版本号
string. 当 jenkinsBuild == BuildNumber 时,需要此选项。 默认值:1

下载此生成生成的项目。


itemPattern - 项模式
string. 默认值:**

指定要下载为多行小型匹配模式的文件。 有关 文件匹配模式的详细信息

默认模式 ** 将下载 Jenkins 作业生成的所有项目中的所有文件。 若要下载项目放置中的所有文件,请使用 drop/**


downloadCommitsAndWorkItems - 下载 Commits 和 WorkItems
boolean. 默认值:false

允许下载与 Jenkins 作业关联的提交和工作项详细信息。


startJenkinsBuildNumber - 从 下载提交和工作项
string. 可选。 在 时 downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber使用 。

启动用于下载提交和工作项的内部版本号。 如果提供,则会下载开始生成号与作为下载项目输入的内部版本号之间的所有提交和工作项。


artifactDetailsFileNameSuffix - Commit 和 WorkItem FileName
string. 可选。 在 时 downloadCommitsAndWorkItems == invalid使用 。

指定提交和工作项附件的文件名后缀。 使用 和 workitem_{suffix}.json创建commits_{suffix}.json附件。 如果未提供此输入,则会使用 名称和 commits.jsonworkitems.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 作业生成的项目。

要求

要求 说明
管道类型 YAML,经典内部版本,经典版本
运行平台 Agent、DeploymentGroup
需求
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置的变量 任意
代理版本 2.144.0 或更高版本
任务类别 实用工具
要求 说明
管道类型 YAML,经典内部版本,经典版本
运行平台 Agent、DeploymentGroup
需求
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置的变量 任意
代理版本 所有支持的代理版本。
任务类别 实用工具