文档中心

持续交付

制品管理

制品上传

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

背景信息

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

代码仓库。

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

前提条件

制品仓库

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

说明

制品仓库当前为邀测阶段，如需试用请申请试用。

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

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

持续交付

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

添加步骤

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

注意

流水线中每个任务共享一个工作空间。对于构建上传场景，编译构建和制品上传必须位于同一任务中，否则无法获得构建产物。

创建或编辑流水线时，在流程编排页签，单击添加任务，弹出添加任务抽屉。任务模板选择构建 > Java 编译构建。

单击添加步骤，选择预置步骤 > 制品 > 制品上传，在 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 目录下。
失败时跳过	可选配置。开启：当前步骤运行失败直接跳过，当前任务其余步骤可继续执行，流水线也可继续向下运行。关闭：当前步骤失败后，当前任务其余步骤不再执行，流水线将运行失败。

高级设置

资源限制：支持设置 CPU 和内存的上限。

磁盘容量限制：支持设置磁盘容量的上限，最大为 100 GiB。

超时时间：设置整个任务的超时时间，任务超时后自动失败。一个任务可以包含多个串行步骤，每个步骤的运行时长总和需要小于任务的超时时间。

Webhook 通知：支持通过 Webhook 和飞书机器人两种方式推送任务维度的消息，帮助您及时掌握任务动态。

失败自动重试：开启后，填写最多支持重试的次数。任务在执行失败时，会按照配置的最大重试次数，进行至多次指定次数的重试。

注意

私有构建资源池中流水线任务，仅 Agent 版本大于等于 v2.34.0 及以上时支持失败自动重试。v2.34.0 以下版本重新添加 Agent 即可升级为最新版本。添加 Agent 的方法参见创建私有资源池中后续操作。

日志及产物

该步骤运行完成后，流水线展示如下信息。

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

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

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

最近更新时间：2026.01.27 14:25:41

这个页面对您有帮助吗？

有用

无用