文档首页/ 编译构建 CodeArts Build/ 用户指南/ 配置构建任务/ 配置构建步骤/ 从OBS下载文件
更新时间：2026-08-10 GMT+08:00
查看PDF
分享

从OBS下载文件

CodeArts Build支持从OBS下载文件，您可以根据实际情况选择使用该构建步骤。

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

图形化构建

在配置构建步骤中，添加“从OBS下载文件”构建步骤，参考表1配置参数。

表1 从OBS下载文件参数说明

参数

说明

步骤显示名称

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

  • 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。
  • 字符长度范围为1~128。

授权用户

选择需要下载文件的OBS所属用户。

  • 当前用户：从当前用户的OBS桶下载文件。
  • 其他用户：可以通过选择IAM账号的方式下载指定用户的OBS文件。

OBS终端节点

可选参数。

从其他区域的OBS下载文件时，需要配置此参数。

填写目标OBS域名。不填写默认为当前区域。

注意：

如果填写了非当前Region的OBS终端节点，需确保执行机（包括默认执行机或者自定义执行机）与OBS终端节点的网络可以正常访问，否则会下载OBS文件失败。例如日志会报错：“Name or service not known”。

OBS桶名

填写目标OBS的桶名。

OBS桶内文件路径

可选参数。

源文件在OBS桶内的对象路径（ObjectKey），既支持下载单个文件，如 build/20240101/app.jar，也支持下载目录下的所有文件，如 build/sdk/。

本地文件所在路径

可选参数。

下载到构建工作目录下的目标路径，如 downloads/。支持相对路径或绝对路径，留空时下载到工作目录根目录。

失败后是否继续运行

当前步骤执行失败后是否继续执行下一个步骤，根据实际使用场景选择是或否。
父主题： 配置构建步骤