配置构建环境

1. 通过项目入口方式访问CodeArts Build服务首页。
2. 在编译构建服务首页搜索目标任务，单击构建任务名称，进入构建任务配置页面。

   CodeArts Build预置了“构建环境配置”步骤，参考表2配置参数。

   表2 构建环境配置参数说明

   参数	说明
   构建环境主机类型	X86服务器、ARM（鲲鹏）服务器。 说明： 在不同芯片架构上运行的软件，需要选择对应的环境主机。如软件最终在鲲鹏服务器上运行，则选择鲲鹏服务器。
   执行主机	选择用来执行编译构建任务的计算资源。在编译构建服务中，该计算资源为虚拟机。执行主机包括内置执行机和自定义执行机。 默认资源池：编译构建服务自身提供的执行主机，用户无需配置即可开箱即用。执行机默认规格为2U8G。 自定义资源池：用户自行提供表1的计算资源，通过注册的方式托管到编译构建服务中，通过编译构建服务进行调度并执行构建任务。 可根据实际情况选择资源池，自定义资源池为在资源池中添加的代理执行机，具体自定义操作可参考资源池管理。
   宿主机目录与容器目录映射	配置自定义执行机的目录和容器的目录映射，配置映射后，可将自定义执行机中的依赖项等文件挂载到容器中执行构建。当执行主机选择自定义执行时需要配置。 例如：宿主机目录填写“/home”，容器目录填写“/opt”，就会把执行机本地“/home”目录下的内容，挂载到容器内的“/opt”目录下。
   使用固定路径 （执行主机选择自定义执行机时需要配置）	在编译构建服务中，默认每一次构建都会使用一个空白的且随机的目录(比如/devcloud/ws/sMMM/workspace/j_X/)作为此次构建的根目录，这个根目录所代表的空间称为BuildSpace。 BuildSpace的路径默认是随机的，即使是同一个项目的不同构建任务的BuildSpace也会被随机分配。 但是在某些场景下固定一个BuildSpace的路径是有必要的，因此编译构建服务支持配置BuildSpace，以固定构建执行目录。 可选参数。将开关设置为开启状态，表示使用固定路径，否则不使用固定路径。
   固定路径后缀 （执行主机选择自定义执行机时需要配置）	可选参数。 当使用固定路径时，路径为：/devcloud/slavespace/usr1/+"${domainId}"+/。配置path参数，表示在前面的固定路径基础上拼接路径。 例如：“path”配置路径为“kk”，那么固定路径为：/devcloud/slavespace/usr1/+"${domainId}"+/kk。 说明： “使用固定路径”开关设置为开启状态时需要配置。
   执行后清理固定路径 （执行主机选择自定义执行机时需要配置）	开启：需要清理固定路径。即路径是固定的，但是每次执行完会清理路径下的文件。 关闭：不清理固定路径。但是工作空间有限的，当文件容量达到工作空间上限后，需要手动清理工作空间（开关设置为开启状态即可）。 说明： 工作空间指的是用户自定义的执行机的规格。 如果未配置清理固定路径，当文件容量达到工作空间上限后，会自动清理当前租户下的固定路径中所有文件。 “使用固定路径”开关设置为开启状态时需要配置。
   清理路径白名单 （执行主机选择自定义执行机时需要配置）	可选参数。单击“添加路径”，可添加清理路径白名单。即表示使用路径清理，但是排除白名单路径。仅支持指定固定路径下的一级文件夹。 说明： “使用固定路径”开关设置为开启状态时需要配置。

参考以下构建环境配置代码示例，修改在创建代码化构建使用的YAML文件中的env部分代码信息。

1
2
3
4
5
6
7

version: 2.0 # 必须是2.0，该版本号必填且唯一
env: # 定义构建环境信息。非必填，如果不填写，默认使用X86
  resource:
    type:docker # 资源池类型：docker或custom，其中docker表示使用默认执行机，custom表示使用自定义执行机
    arch:X86 # 构建环境主机类型：X86或ARM
    class:8U16G # 规格：2U8G、4U8G、8U16G、16U32G或16U64G，当type为custom时无需填写该参数
    pool：Mydocker #资源池名称，当type为custom时需要填写该参数

参考以下BuildSpace代码示例，在创建代码化构建使用的YAML文件中添加以下代码信息。

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

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