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

配置BuildSpace

背景说明

在编译构建服务中，默认每一次构建都会使用一个空白的且随机的目录(比如/devcloud/ws/sMMM/workspace/j_X/)作为此次构建的根目录，这个根目录所代表的空间称为BuildSpace。 BuildSpace的路径默认是随机的，即使是同一个项目的不同构建任务的BuildSpace也会被随机分配。

但是在某些场景下固定一个BuildSpace的路径是有必要的，因此编译构建服务支持配置BuildSpace，以固定构建执行目录。

前提条件

可使用的环境为自定义执行机、构建并发包和构建加速包L3。

配置说明

在Yaml文件中，添加如下代码：

version: 2.0
buildspace: #表示使用BuildSpace
  fixed: true
  path: kk  
  clean: true
  clean_exclude:
    - cache #排除的具体路径
    - aa #排除的具体路径
    - bb #排除的具体路径

代码参数说明如下：

参数名

参数类型

描述

是否必填

默认值

fixed

string
  • true：使用固定路径。
  • false：不使用固定路径。

否

false

path

string

当使用固定路径时，路径为：/devcloud/slavespace/usr1/+"${domainId}"+/。配置path参数，表示在前面的固定路径基础上拼接路径。

例如：“path”配置路径为“kk”，那么固定路径为：/devcloud/slavespace/usr1/+"${domainId}"+/kk。

否

无

clean

string
  • true：需要清理固定路径。即路径是固定的，但是每次执行完会清理路径下的文件。
  • false：不清理固定路径。但是工作空间有限的，当文件容量达到工作空间上限后，需要手动清理工作空间(clean配置为true即可)。
    说明：
    • 如果未配置清理固定路径，当文件容量达到工作空间上限后，会自动清理当前租户下的固定路径中所有文件。
    • 工作空间指的是用户自定义的执行机的规格。

否

true

clean_exclude

string

表示使用路径清理，但是排除以下路径。仅支持指定固定路径下的一级文件夹。

否

不涉及
父主题： 配置构建步骤