You need to enable JavaScript to run this app.
导航

创建构建加速实例

最近更新时间2023.12.19 20:56:28

首次发布时间2023.09.27 14:56:29

构建加速实例由持续交付托管,为您提供远端构建执行和远端缓存能力,帮助业务成倍提升编译构建效率。使用构建加速功能之前,需要先创建一个构建加速实例。本文为您介绍如何创建构建加速实例。

前提条件

使用限制

  • 每个火山引擎账号可创建的构建加速实例数量存在配额限制,具体请参见 使用限制

  • 访问构建加速实例的公网带宽存在上限,具体请参见 使用限制

  • 拥有 CPAdminAccess 权限的账号可以创建构建实例。子用户如需创建构建加速实例,请联系对应火山引擎账号授予该权限,具体操作请参考 创建子用户并授权

  • 为了更好地进行权限管控,推荐使用火山引擎账号创建构建加速实例,使用子用户(赋予 CPMemberAccess 权限)的 AK/SK 做日常的编译开发。

  • 构建加速实例可并发执行的最大任务数 = 构建加速实例的 CPU 总核数 ,超过后需排队等待。

操作步骤

  1. 登录 持续交付控制台

  2. 在左侧导航栏选择 构建加速

  3. 在构建加速页面,单击 创建加速实例

  4. 在创建加速实例页面,按要求配置实例信息。完成后单击 确认订单

    alt

    • 实例类型

      配置项说明

      实例类型

      选择实例类型,当前提供 Sailfish 和 Bazel 两种类型。

      • Sailfish:提供无侵入式构建加速能力。通过截获编译命令,在本地完成高效的依赖文件解析、创建编译请求、并拆解分发至远端集群并发执行;结合增量编译技术,提升软件编译效率。适用于安卓 AOSP 构建工程,C/C++/Objective-C 等场景。
      • Bazel:提供以 Bazel 生态为基础的远端构建执行和远端缓存服务,帮助企业成倍提升编译构建效率。支持各种编程语言,适用于使用 Bazel 构建系统的项目。
    • 基本信息

      配置项说明
      名称自定义构建加速实例的名称。

      地域

      选择构建加速实例所在的地域。当前支持 华北2(北京)华南1 (广州)

      说明

      实例创建后,所属地域不支持修改。请根据实际情况选择合适的地域,实现就近访问。

      remote-cache展示远端缓存的加速域名。系统将根据您填写的实例名称和地域信息,自动生成加速域名。
      remote-executor展示远端构建执行的加速域名。系统将根据您填写的实例名称和地域信息,自动生成加速域名。

      构建镜像

      选择远端构建集群使用的容器镜像。支持使用预置镜像和自定义镜像,请按需选择。

      • 预置镜像:持续交付预置的镜像,帮助简化您的接入成本。请下拉选择目标预置镜像。关于预置镜像的详细信息请参见 预置镜像说明

      • 自定义镜像:【邀测·申请试用】选择自定义镜像所在的实例、命名空间、镜像名称及版本。如果您的本地构建镜像中预先安装了多种依赖,建议使用您自己的镜像。保持远端环境和本地环境的一致性,提高远端编译构建成功率。

      注意

      • 建议基于 Ubuntu/Debian 基础镜像制作自定义镜像,使用其他 Linux 镜像可能导致集群创建失败。
      • 请确保镜像预装了 wget 和 tar 命令,否则集群会启动失败。
      计费类型当前仅支持按量计费。
    • 构建实例规模

      配置项说明

      CPU(Core)

      选择构建实例的 CPU 规模,当前提供 64/128/256/512 Core 共 4 种选择。系统将根据您选择的 CPU 规格(Core),按照 1 :2 的比例自动为您分配内存规格(GiB)。

      请根据您的构建任务并发规模选择合适的 CPU 核数。最大并发任务数 = 集群的 CPU 总核数 ,超过后需排队等待。例如: 64 Core CPU 最多可并发执行 64 个构建任务,第 65 个任务将排队等待。

    • 缓存资源

      配置项说明

      数据盘(GiB)

      展示单个缓存实例的数据盘大小,当前仅提供 1024 GiB 规格。

      缓存实例数设置缓存实例的个数。系统已根据您设置的 CPU 规模,为您推荐了合适的缓存实例个数。支持根据需要修改,最多可设置 10 个缓存实例。
    • 访问控制
      设置构建加速实例的访问控制策略。公网访问与私网访问请至少开启一个。

      说明

      如果您的业务部署在线下环境,且希望通过高速链路访问构建加速实例,可自行购买 专线连接 服务,打通二者的 VPC 网络。

      配置项说明

      公网访问

      是否开启公网访问。开启后,支持通过公网访问构建加速实例。

      注意

      开启公网访问后,可能产生公网流出流量费用。具体请参见 构建加速计费说明

      私网访问

      是否开启私有访问(默认开启,支持关闭)。开启后,支持通过内网访问构建加速实例,访问速度更快,构建加速效果更显著。适用于本地业务部署在火山引擎上的场景。
      开启私网访问开关后,需进一步添加您的私有网络信息,包括地域、私有网络、可用区及子网、安全组。

      • 地域:显示构建加速实例所属的地域。
      • 可用区及子网:选择私有网络的可用区及子网。必须与构建加速实例处于同一可用区,当前支持的可用区以控制台为准。
      • 安全组:选择私有网络的安全组。默认选中 default 安全组,支持修改。

      注意

  5. 在确认订单页面,确认构建加速实例配置和费用信息。

    • 确保待创建构建加速实例的相关配置符合预期,包括:配置详情、规格和计费类型。
    • 确认配置费用,包括:收费项、原价、折扣和折后价格。

    alt

  6. 阅读 《持续交付产品服务条款》 并勾选同意,单击 立即购买,将完成购买操作,开始创建构建加速实例。

    完成以上操作后,构建加速实例处于 创建中 状态。创建时长受集群规模和镜像大小影响,通常为 10-20 分钟,请耐心等待。

  7. 单击 去控制台,返回构建加速页面。
    查看创建的构建加速实例信息,状态为 运行中 表明创建成功。