文档首页/ 编译构建 CodeArts Build/ 用户指南（联盟区域）/ 用户指南/ 配置构建步骤/ 上传文件到OBS
更新时间：2026-01-08 GMT+08:00
查看PDF
分享

上传文件到OBS

对象存储服务（OBS）的使用限制请参考。

图形化构建

在配置构建步骤中，添加“上传文件到OBS”构建步骤。

参数说明如下：

参数项

说明

步骤显示名称

构建步骤的名称，可自定义修改。

授权用户
  • 当前用户：上传到当前租户的OBS桶。
  • 其他用户：可以通过选择IAM账号的方式上传到指定租户的OBS桶。

构建产物路径

构建结果所在路径，OBS存储文件名为空时，可使用通配符上传多个文件。如：maven可以使用**/target/*.?ar匹配所有构建出来的jar包和war包。

桶名

目标OBS桶名（不支持跨region上传）。

OBS存储目录

构建结果在OBS上的存储目录（如：application/version/），可留空，或填写“./”表示存储到OBS根目录。

OBS存储文件名

构建结果在OBS上的存储文件名（不包含目录），留空时可上传多个文件，取构建产物文件名为OBS存储文件名；不为空时只能上传单个文件，如：application.jar。

OBS头域

上传文件时加入一个或多个自定义的响应头，当用户下载此对象或查询此对象元数据时，加入的自定义响应头会在返回消息的头域中出现。如：“键”填写成“x-frame-options”，“值”填写成“false”，即可禁止OBS中存放的网页被第三方网页嵌入。

代码化构建

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
 
version: 2.0 # 必须是2.0
steps:
  BUILD:
    - upload_obs:
          inputs:
            artifact_path: "**/target/*.?ar"
            bucket_name: codecitest-obs
            obs_directory: test
          #   artifact_dest_name: ""
          #   upload_directory: true
          #   headers:
          #     x-frame-options: true
          #     test: test
          #     commit: ${commitId}

参数名

参数类型

描述

是否必填

默认值

artifact_path

string

要上传的产物路径，支持正则。

否

bin/*

bucket_name

string

要上传到的obs桶名。

是

无

obs_directory

string

要上传到的obs文件夹路径。默认上传到桶的根目录。

否

./

artifact_dest_name

string

上传到obs后的文件名。产物需要重命名时填写。

否

无

upload_directory

bool

是否上传文件夹。false时会将匹配到的所有产物平铺上传到obs_directory。

否

false

headers

map

上传的头域信息。

否

无
父主题： 配置构建步骤