持续交付预置 TOS 上传 步骤，支持将工作空间下的单个文件或文件夹上传至火山引擎的 对象存储 TOS。
背景信息
TOS 上传的内容可以来自：
代码仓库
流水线构建产物。多用于前端静态资源发布场景：通过 Node.js 编译构建 > TOS 上传，对 Node.js 项目进行编译构建，并将构建产物上传至 TOS，后续可引用静态资源的 TOS 地址。
前提条件
使用限制
- 仅支持上传至同一火山引擎账号下的 TOS 服务。
- 上传的文件或文件夹总容量不能超过 10 GB。
添加步骤
本文以 Node.js 编译构建 > TOS 上传 说明如何添加 TOS 上传步骤。
注意
流水线中每个任务共享一个工作空间。对于构建上传场景，编译构建 和 TOS 上传 必须位于同一任务中，否则无法获得构建产物。
创建或编辑流水线时，在 流程编排 页签，单击 添加任务，弹出 添加任务 抽屉。任务模板选择 构建 > NodeJS 编译构建。
单击 添加步骤，选择 预置步骤 > 制品 > TOS 上传，在 NodeJS 编译构建 步骤下添加串行步骤 TOS 上传。
参数说明
下文介绍 TOS 上传步骤的参数。
| 配置项 | 说明 |
|---|---|
| 步骤名称 | 默认为 TOS 上传，支持自定义步骤名称。 |
源文件路径 | 上传文件/文件夹路径。起始位置为项目文件夹的相对路径，不支持通配符。
注意 如果需要在步骤间传递产物，请将文件放置workspace 目录下。例如：对于 编译构建 > TOS 上传 场景，构建产物需要放置在 workspace 目录下。 |
TOS 文件路径 | 上传至 TOS Bucket 的目录。如果目标目录不存在，会新建目录。
注意 如果上传单个文件，例如
|
| Bucket 地域 | 选择待上传的 Bucket 所在的地域。 |
| Bucket 名称 | 选择待上传的目标 Bucket。 |
上传时包含相对父目录 | 是否将相对父目录一起上传。
|
失败时跳过 | 可选配置。
|
高级设置
- 资源限制：支持设置 CPU 和内存的上限。
- 磁盘容量限制：支持设置磁盘容量的上限，最大为 100 GiB。
- 超时时间：设置整个任务的超时时间，任务超时后自动失败。一个任务可以包含多个串行步骤，每个步骤的超时时间受限于任务的超时时间。
- Webhook 通知：支持通过 Webhook 和飞书机器人两种方式推送任务维度的消息，帮助您及时掌握任务动态。
- 失败自动重试：开启后，填写最多支持重试的次数。任务在执行失败时，会按照配置的最大重试次数，进行至多次指定次数的重试。
注意
私有构建资源池 中流水线任务，仅 Agent 版本大于等于
v2.34.0及以上时支持 失败自动重试。v2.34.0以下版本重新添加 Agent 即可升级为最新版本。添加 Agent 的方法参见 创建私有资源池 中 后续操作。
日志及产物
下文为您介绍该步骤运行完成后，流水线展示的详情信息。
运行日志：实时展示 TOS 上传的运行日志。
任务配置：展示该任务的配置参数，包括所有步骤的配置参数。
产物：任务运行成功后，会输出 TOS 的上传路径。