持续交付预置 **制品上传** 步骤，支持将通用格式的制品上传至制品仓库进行归档。后续任务可引用该制品进行消费，例如部署制品。本文为您介绍如何进行制品上传。 ## 背景信息制品上传的内容可以来自： * 代码仓库。 * 流水线构建产物。例如：通过 **Java 编译构建 \> 制品上传**，对 Java 项目进行编译构建，并将构建产物上传至制品仓库进行归档。 ## 前提条件 * 制品仓库 * 已开通火山引擎制品仓库。 :::tip 制品仓库当前为邀测阶段，如需试用请 [申请试用](https://www.volcengine.com/docs/6461/1130730)。 ::: * 已创建制品仓库实例。具体操作可参见 [创建基础版实例](https://www.volcengine.com/docs/6420/1764549)。 * 已创建 Generic 制品格式仓库，且仓库的发布策略要求为非只读策略。具体操作可参见 [创建 Generic 仓库](https://www.volcengine.com/docs/6420/1764555)。 * 持续交付 * 首次使用制品上传，需完成跨服务授权。具体操作可参见 [跨服务授权](https://www.volcengine.com/docs/6461/1148757)。 ## 添加步骤本文以 **Java 编译构建 \> 制品上传** 说明如何添加制品上传步骤。 :::warning 流水线中每个任务共享一个工作空间。对于构建上传场景，**编译构建** 和 **制品上传** 必须位于同一任务中，否则无法获得构建产物。 ::: 1. 创建或编辑流水线时，在 **流程编排** 页签，单击 **添加任务**，弹出 **添加任务** 抽屉。任务模板选择 **构建 \>** **Java** **编译构建**。 2. 单击 **添加步骤**，选择 **预置步骤 \> 制品 \> 制品上传**，在 **Java** **编译构建** 步骤下添加串行步骤 **制品上传。** ## 参数说明下文介绍制品上传步骤的参数。 * **多文件上传** 会将多个文件打包为 tgz 包，再上传到制品仓库。 |配置项 |说明 | |---|---| |步骤名称 |默认为制品上传，支持自定义步骤名称。 | |地域 |选择制品仓库所在的地域。|\ | |目前支持的地域请参见 [制品仓库开服地域](https://www.volcengine.com/docs/6420/1764535)。 | |实例 |选择要上传的制品仓库实例。 | |仓库地址 |选择要上传的目标仓库。仅支持选择非只读策略的 Generic 制品格式仓库。 | |制品文件路径 |填写制品上传后，存储在制品仓库中的目录路径。|\ | ||\ | |* 默认为`/`，表示制品会上传到仓库根目录下。|\ | |* 如果填写的目录路径不存在，会新建目录。例如:`demo`，表示上传到目标仓库的 demo 目录下。 | |制品名称 |自定义制品仓库中归档的文件名称，默认为`Artifact-$(PIPELINE_ID)-$(CP_STEP_NAME)-$(DATETIME).gzip`。|\ | |:::warning|\ | |名称冲突时可能上传失败，具体与您设置的仓库发布策略有关。|\ | ||\ | |:::| |是否上传单文件 |本场景关闭该开关。多个文件上传，会将多个文件打包为 tgz 包，再上传到制品库。 | |打包路径 |填写需要打包的路径。系统会将所有路径下的文件打包为一个压缩文件，上传至制品仓库。|\ | ||\ | |* 支持目录路径（例如`./target/`）和文件路径（例如`./target/jar-jdk8-v1.jar`）。|\ | |* 默认为`.`，表示打包当前目录下的所有文件。|\ | ||\ | |:::warning|\ | |如果需要在步骤间传递产物，请将文件放置在 workspace 目录下。例如：对于 **编译构建 \> 制品上传** 场景，构建产物需要放置在 workspace 目录下。|\ | ||\ | |:::| |是否包含打包路径的目录 |是否将打包路径的目录一起上传。|\ | ||\ | |* 开启：制品中会包含文件的原始路径。|\ | |* 关闭：制品中的所有文件都在根目录下，平铺展示。|\ | ||\ | |:::tip|\ | |该开关默认关闭。当包含多个打包路径时，将强制开启，避免多个路径下存在同名文件时无法分辨。|\ | ||\ | |:::| |失败时跳过 |可选配置。|\ | ||\ | |* 开启：当前步骤运行失败直接跳过，当前任务其余步骤可继续执行，流水线也可继续向下运行。|\ | |* 关闭：当前步骤失败后，当前任务其余步骤不再执行，流水线将运行失败。 | * **单文件上传** 直接将您的文件上传至制品仓库，平台不会做压缩处理。 |配置项 |说明 | |---|---| |步骤名称 |默认为制品上传，支持自定义步骤名称。 | |地域 |选择制品仓库所在的地域。目前支持的地域请参见 [制品仓库开服地](https://www.volcengine.com/docs/6420/1764535)。 | |实例 |选择要上传的制品仓库实例。 | |仓库地址 |选择要上传的目标仓库。仅支持选择非只读策略的 Generic 制品格式仓库。 | |制品文件路径 |填写制品上传后，存储在制品仓库中的目录路径。|\ | ||\ | |* 默认为`/`，表示制品会上传到仓库根目录下。|\ | |* 如果填写的目录路径不存在，会新建目录。例如:`demo`，表示上传到目标仓库的 demo 目录下。 | |制品名称 |选填。支持自定义制品仓库中归档的文件名称。不填则默认使用所上传文件的名称。|\ | |注意|\ | |名称冲突时可能上传失败，具体与您设置的仓库发布策略有关。 | |是否上传单文件 |本场景打开该开关。平台直接将您的文件上传至制品仓库，不会做压缩处理。 | |打包路径 |填写需要打包的路径。仅支持上传一个文件路径（例如`./mygolang`）。|\ | |:::warning|\ | |如果需要在步骤间传递产物，请将文件放置在 workspace 目录下。例如：对于 **编译构建 \> 制品上传** 场景，构建产物需要放置在 workspace 目录下。|\ | ||\ | |:::| |失败时跳过 |可选配置。|\ | ||\ | |* 开启：当前步骤运行失败直接跳过，当前任务其余步骤可继续执行，流水线也可继续向下运行。|\ | |* 关闭：当前步骤失败后，当前任务其余步骤不再执行，流水线将运行失败。 | ## 高级设置 * **资源限制**：支持设置 CPU 和内存的上限。 * **磁盘容量限制**：支持设置磁盘容量的上限，最大为 100 GiB。 * **超时时间**：设置整个任务的超时时间，任务超时后自动失败。一个任务可以包含多个串行步骤，每个步骤的超时时间受限于任务的超时时间。 * [Webhook 通知](https://www.volcengine.com/docs/6461/1251516)：支持通过 Webhook 和飞书机器人两种方式推送任务维度的消息，帮助您及时掌握任务动态。 * **失败自动重试**：开启后，填写最多支持重试的次数。任务在执行失败时，会按照配置的最大重试次数，进行至多次指定次数的重试。 :::warning **私有构建资源池** 中流水线任务，仅 Agent 版本大于等于 `v2.34.0` 及以上时支持 **失败自动重试**。`v2.34.0` 以下版本重新添加 Agent 即可升级为最新版本。添加 Agent 的方法参见 [创建私有资源池](https://www.volcengine.com/docs/6461/1251519) 中 **后续操作**。 ::: ## 日志及产物该步骤运行完成后，流水线展示如下信息。 * 运行日志：实时展示制品上传的运行日志。 * 任务配置：展示该任务的配置参数，包括所有步骤的配置参数。 * 产物：任务运行成功后，会输出制品下载地址和制品详情地址。