持续交付预置 制品上传 步骤，支持将通用格式的制品上传至火山引擎的 制品仓库 进行归档。后续任务可引用该制品进行消费，例如部署制品。本文为您介绍如何进行制品上传。

背景信息

制品上传的内容可以来自：

• 代码仓库。

• 流水线构建产物。例如：通过 Java 编译构建 > 制品上传，对 Java 项目进行编译构建，并将构建产物上传至制品仓库进行归档。

前提条件

• 制品仓库

  • 已开通火山引擎制品仓库。

    说明

    制品仓库当前处于公测状态，如需体验，请优先联系您的售前经理或解决方案经理。

  • 已创建制品仓库实例。具体操作可参见 创建基础版实例。

  • 已创建 Generic 制品格式仓库，且仓库的发布策略要求为非只读策略。 具体操作可参见 创建 Generic 仓库。

• 持续交付

  • 首次使用制品上传，需完成跨服务授权。具体操作可参见 跨服务授权。

添加步骤

本文以 Java 编译构建 > 制品上传 说明如何添加制品上传步骤。

1. 创建或编辑流水线时，在 流程编排 页签，单击 添加任务，弹出 添加任务 抽屉。任务模板选择 构建 > Java 编译构建。
2. 单击 添加步骤，选择 预置步骤 > 制品 > 制品上传，在 Java 编译构建 步骤下添加串行步骤 制品上传。

参数说明

下文介绍制品上传步骤的参数。

• 多文件上传
  会将多个文件打包为 tgz 包，再上传到制品仓库。

  配置项	说明
  步骤名称	默认为制品上传，支持自定义步骤名称。
  地域	选择制品仓库所在的地域。 目前支持的地域请参见 制品仓库开服地域。
  实例	选择要上传的制品仓库实例。
  仓库地址	选择要上传的目标仓库。仅支持选择非只读策略的 Generic 制品格式仓库。
  制品文件路径	填写制品上传后，存储在制品仓库中的目录路径。 默认为/，表示制品会上传到仓库根目录下。 如果填写的目录路径不存在，会新建目录。例如:demo，表示上传到目标仓库的 demo 目录下。
  制品名称	自定义制品仓库中归档的文件名称，默认为Artifact-$(PIPELINE_ID)-$(CP_STEP_NAME)-$(DATETIME).gzip。 注意 名称冲突时可能上传失败，具体与您设置的仓库发布策略有关。
  是否上传单文件	本场景关闭该开关。多个文件上传，会将多个文件打包为 tgz 包，再上传到制品库。
  打包路径	填写需要打包的路径。系统会将所有路径下的文件打包为一个压缩文件，上传至制品仓库。 支持目录路径（例如./target/）和文件路径（例如./target/jar-jdk8-v1.jar）。 默认为.，表示打包当前目录下的所有文件。 注意 如果需要在步骤间传递产物，请将文件放置在 workspace 目录下。例如：对于 编译构建 > 制品上传 场景，构建产物需要放置在 workspace 目录下。
  是否包含打包路径的目录	是否将打包路径的目录一起上传。 开启：制品中会包含文件的原始路径。 关闭：制品中的所有文件都在根目录下，平铺展示。 说明 该开关默认关闭。当包含多个打包路径时，将强制开启，避免多个路径下存在同名文件时无法分辨。
  失败时跳过	可选配置。 开启：当前步骤运行失败直接跳过，当前任务其余步骤可继续执行，流水线也可继续向下运行。 关闭：当前步骤失败后，当前任务其余步骤不再执行，流水线将运行失败。

• 单文件上传
  直接将您的文件上传至制品仓库，平台不会做压缩处理。

  配置项	说明
  步骤名称	默认为制品上传，支持自定义步骤名称。
  地域	选择制品仓库所在的地域。 目前支持的地域请参见 制品仓库开服地域。
  实例	选择要上传的制品仓库实例。
  仓库地址	选择要上传的目标仓库。仅支持选择非只读策略的 Generic 制品格式仓库。
  制品文件路径	填写制品上传后，存储在制品仓库中的目录路径。 默认为/，表示制品会上传到仓库根目录下。 如果填写的目录路径不存在，会新建目录。例如:demo，表示上传到目标仓库的 demo 目录下。
  制品名称	选填。支持自定义制品仓库中归档的文件名称。不填则默认使用所上传文件的名称。 注意 名称冲突时可能上传失败，具体与您设置的仓库发布策略有关。
  是否上传单文件	本场景打开该开关。平台直接将您的文件上传至制品仓库，不会做压缩处理。
  打包路径	填写需要打包的路径。仅支持上传一个文件路径（例如./mygolang）。 注意 如果需要在步骤间传递产物，请将文件放置在 workspace 目录下。例如：对于 编译构建 > 制品上传 场景，构建产物需要放置在 workspace 目录下。
  失败时跳过	可选配置。 开启：当前步骤运行失败直接跳过，当前任务其余步骤可继续执行，流水线也可继续向下运行。 关闭：当前步骤失败后，当前任务其余步骤不再执行，流水线将运行失败。

日志及产物

下文为您介绍该步骤运行完成后，流水线展示的详情信息。

• 运行日志：实时展示制品上传的运行日志。

• 任务配置：展示该任务的配置参数，包括所有步骤的配置参数。

• 产物：任务运行成功后，会输出制品下载地址和制品详情地址。