腾讯云 CNB 构建节点规格怎么选？

摘要：

腾讯云 CNB 构建节点怎么选？本文详解 amd64、arm64/v8、GPU 三类节点规格与声明方式，说明内存按 CPU 核数 2 倍计算、最大构建时长 18 小时，并拆解社区版免费额度、核时计费与自托管构建机接入，帮你按需选型、控制成本。

一、为什么构建节点规格值得认真选

云原生构建（Cloud Native Build，简称 CNB）是腾讯云推出的 AI Native Git 平台，把代码托管、云原生构建、云原生开发、制品库和 AI 能力整合到同一平台。其中构建节点是流水线的算力载体，每一条 CI/CD 流水线最终都跑在某个构建节点上。节点规格选得合适，编译打包更快、排队更少；规格选得过高，则会白白消耗核时额度、推高成本。

CNB 的构建资源以「核时」为计量单位，规格可按需声明，这意味着同一份 .cnb.yml 配置文件，既能为轻量任务分配 1 核资源，也能为重型编译调度 64 核乃至 GPU 算力。理解节点的架构类型、核数范围、内存换算和计费规则，是做好成本与效率平衡的前提。

二、三类构建节点规格一览

CNB 官方提供的构建节点按 CPU 架构分为三大类，覆盖通用编译、ARM 交叉编译和 GPU 加速三类典型场景。

2.1 amd64 架构节点

amd64 架构节点是通用型构建资源，CPU 核数可在 1 核到 64 核之间按需声明，默认规格为 8 核。它适合绝大多数 x86 生态下的构建任务，例如前端工程打包、Java 项目编译、Go 二进制构建、Docker 镜像制作等。由于核数跨度大，开发者可以根据任务轻重灵活调节，轻任务用小核数节省核时，重任务临时拉高核数缩短构建耗时。

2.2 arm64/v8 架构节点

arm64/v8 架构节点面向 ARM 指令集场景，CPU 核数可在 1 核到 16 核之间声明，默认同样为 8 核。当目标产物需要运行在 ARM 架构设备上时（例如移动端应用、ARM 版 Linux 软件、Apple Silicon 原生程序），使用同架构节点编译能避免交叉编译带来的兼容问题，也能更真实地反映目标环境的构建表现。

2.3 GPU 节点

GPU 节点用于 AI 推理、模型微调、深度学习训练等需要并行浮点算力的任务。CNB 官方提供的 GPU 节点均为 amd64 架构、固定 16 核 CPU、48GB 显存（共享），按 GPU 型号分为基础 GPU 节点与 L40 节点两类：

两类节点的 CPU 与显存规格一致，可按实际算力需求与资源可用性选择。

三、如何在流水线中声明节点

构建节点的声明全部通过 .cnb.yml 配置文件完成，核心字段是 runner.tags 和 runner.cpus。

3.1 用 runner.tags 指定架构，runner.cpus 指定核数

runner.tags 用于选择节点的架构类型，runner.cpus 用于声明需要的 CPU 核数。以 amd64 架构、8 核规格为例，配置如下：

main:
  push:
    - runner:
        tags: cnb:arch:amd64
        cpus: 8
      stages:
        - name: build
          script: make build

切换到 ARM 架构时，只需把 tag 改为 cnb:arch:arm64:v8，核数在 1 到 16 之间声明即可。GPU 节点则通过对应的 GPU tag 命中，例如使用 L40 节点时声明 tags: cnb:arch:amd64:gpu:L40。

3.2 内存默认按 CPU 核数的 2 倍计算

在 CNB 的节点规格里，内存容量默认按 CPU 核数的 2 倍配给。声明 8 核，系统自动分配 16GiB 内存；声明 16 核，则对应 32GiB 内存；最高 64 核规格对应 128GiB 内存。这套换算规则让核数与内存保持固定比例，开发者无需单独配置内存参数，按核数声明即可得到匹配的资源组合。

3.3 最大构建时长为 18 小时

为防止资源被长时间占用，所有构建节点的最大构建时长为 18 小时。超过该时长的任务会被系统终止。绝大多数 CI/CD 任务（编译、测试、打包）远不需要这么长的时间，这一上限主要用来约束异常挂起或资源滥用。如果确实存在超长任务需求，建议拆分为多个子任务，或评估是否需要改用自托管构建机承载。

四、接入自托管构建机

除了平台提供的公共节点，根组织管理员还可以自助接入 Mac、Windows、Linux 自托管构建机，作为本组织专属的构建资源。这适合有特定环境的场景，例如 iOS 应用必须在 macOS 上打包、Windows 桌面软件需要原生环境编译等。

4.1 接入路径与流程

接入入口位于「根组织 / 组织设置 / 构建节点」页面。点击「+ 新增 Runner」，填写节点名称、标签等信息后保存。新节点初始为「离线」状态，点击该行尾部的「连接指引」按钮，弹窗会展示对应平台（Mac 或 Windows）的一键接入脚本，并自动注入该节点的唯一标识，无需手动替换。在目标构建机上执行脚本，节点状态变为「在线」即接入成功。

4.2 在流水线中使用自托管节点

自托管节点接入并启用后，通过 runner.namespace 和 runner.tags 即可调度到该节点。runner.namespace 设为 group，表示使用当前仓库所属根组织下的自托管节点；runner.tags 必须是节点已声明标签的子集（「与」关系，列出的每个 tag 都需出现在节点标签上）。例如节点标签为 [mac, arm64, xcode15] 时，配置 tags: [mac, arm64] 即可命中。

有两点限制需要留意：其一，自托管节点默认不开启 Docker 能力，构建脚本直接运行在宿主机上，因此 runner.cpus 配置无效，也不参与核时计费；其二，自托管节点仅限云原生构建使用，不支持云原生开发（远程开发）任务。

五、计费规则与成本估算

CNB 社区版采用「免费额度 + 超额按量计费」模式，月初按上个自然月实际用量自动扣费，无需主动续费，也不涉及退费。

5.1 核时换算与免费额度

计算资源以「核时」为计量单位，换算公式为：节点核数 × 使用小时数。例如 8 核节点运行 1 小时，消耗 8 核时。社区版每月赠送云原生构建 CPU 免费额度 160 核时，月底清零、不叠加至次月。按默认 8 核规格计算，160 核时大约可支撑 20 小时的构建时长。

5.2 超额计费与 GPU 计费

超出免费额度的 CPU 用量按 0.125 元/核时计费。GPU 节点不享受免费额度，使用即按 0.5 元/核时计费。由于 GPU 节点 CPU 核数固定为 16 核，使用 1 小时 GPU 节点约消耗 16 核时、折合 8 元。GPU 计费按核时累计，因此使用 GPU 前应评估任务收益与成本。

5.3 免费额度可用时长参考

不同核数规格下，160 核时免费额度可使用的时长如下表所示（内存按核数 2 倍配给）：

可以看出，核数越高，同等免费额度下的可用时长越短。日常以中小规格构建为主的团队，免费额度通常能够覆盖大部分需求；若频繁使用高核数或 GPU 节点，则建议在「组织 > 设置 > 用量管理」中绑定预算，提前了解用量上限。

六、选型建议

综合来看，选型可遵循三条原则。第一，通用 x86 构建优先选 amd64 节点，按任务轻重在 1 到 64 核之间调节，默认 8 核已能覆盖多数场景。第二，涉及 ARM 目标环境的编译，使用 arm64/v8 节点，核数在 1 到 16 核之间选择。第三，GPU 任务可在基础 GPU 节点与 L40 节点间按算力需求选择；GPU 无免费额度且按 0.5 元/核时计费，应按需启用。对于有特殊系统环境的团队，可通过自托管构建机承载专属任务，且这部分资源不参与核时计费。

合理选择构建节点，既能缩短流水线等待时间，也能把免费额度用在刀刃上。如果你正在搭建或优化团队的 CI/CD 流程，不妨试试腾讯云 CNB的弹性构建能力，按实际负载灵活声明节点规格。