Agent Runtime 创建集群和节点池

准备第一次运行代码助手、办公 Agent 或批量沙箱任务时，先创建 Agent 集群，再创建节点池，为任务提供计算资源。本文以开发测试集群 agc-docs-demo 为例，介绍通过控制台完成资源准备的过程。
内测期间仅支持新建 TKE 集群，存量 TKE 集群接入能力正在加速开发中。尚未开通时，请先填写 内测申请。
开始前准备
使用具有集群、节点池和网络资源管理权限的腾讯云账号。
确定集群所在地域，准备同一地域的 VPC 和节点子网，并确认子网剩余地址能够满足扩容需要。
规划容器网络，避免与 VPC、对等连接以及其他需要互通的网络地址重叠。
确认节点能够访问镜像仓库，任务能够访问所需的模型、工具和存储服务。
开启镜像加速时，准备创建页面需要选择的 TCR 实例。
首次运行可先准备一个节点；需要按照快速入门验证工作区跨节点迁移时，准备两个配置相同的节点。节点规格需要覆盖业务资源和系统组件开销，费用构成见 资源与费用说明。
第一步：创建 Agent 集群
1. 登录 Agent Runtime 控制台，进入 集群总览，选择目标地域。
2. 单击 新建 Agent 集群，在 基础与网络 页面填写配置。
配置项
如何选择
集群名称
例如 agc-docs-demo，便于与生产环境区分。
描述和标签
记录用途、负责人或所属项目，方便后续查找和管理。
集群规格
根据计划管理的节点数和 Pod 数选择。集群规格管理的是集群规模，任务的 CPU 和内存由节点池提供。
开启自动升配
需要随集群规模增长提升管理规格时开启；固定规模的首次测试可以保持关闭。该选项不会增加计算节点，也不包含自动降配。
VPC
选择准备好的业务网络，确认与镜像仓库、模型服务和工作区存储的连通方式。
容器网络
填写已规划的网段，核对页面显示的单节点 Pod 上限、Service 上限及集群最大节点数。容器网络创建后不能修改。
镜像加速与 TCR 实例
开启后选择对应的 TCR 实例；准备阶段即确认实例和镜像访问权限。
删除保护
保持开启，避免误删。需要清理集群时再关闭。
3. 单击 下一步：参数预检，检查配置结果。存在阻断项时，返回修改对应配置；提示信息应结合网络规划和资源需求处理。
4. 核对集群名称、地域、VPC、网段、规格和镜像加速配置，提交创建。
5. 返回集群列表查看进度，记录集群 ID。等待创建完成后，进入详情继续创建节点池。
提交后出现超时或页面报错时，先刷新列表并按名称查找已有集群，确认是否创建成功，再决定是否重新提交，避免重复创建资源。
第二步：创建节点池
从目标集群的节点池管理入口进入节点池页面。若跳转到容器服务控制台，先核对页面中的集群 ID 与 Agent 集群详情展示的关联集群一致，再进入 节点管理 > 节点池，单击 新建。
配置项
本例的选择方法
节点池名称
使用 agc-test-pool，与生产节点池分开。
可用区和子网
选择有足够地址的子网，同时满足工作区存储的挂载范围。
机型、CPU 和内存
按测试任务的资源需求选择，并为系统组件及运行时留出空间；镜像架构应与节点架构一致。
操作系统与运行环境
选择与 Agent 工作负载运行环境匹配的配置。节点加入集群后，还需检查运行环境是否可用。
磁盘
为系统、镜像缓存和任务临时文件预留空间；需要跨节点保留的文件使用持久化工作区。
节点数量
单节点运行测试选择 1 个；跨节点工作区测试选择 2 个。
弹性伸缩
首次测试使用固定数量，完成验证后再按业务需求配置伸缩范围。
标签和污点
与工作负载的节点选择和容忍配置一致，避免节点正常但任务无法调度。
核对配置和计费方式后提交，进入节点池查看节点创建进度。
第三步：确认可以运行任务
在节点池的节点列表中确认目标数量已经到位，节点为就绪状态，且允许调度。节点创建失败时，先查看失败原因，检查机型库存、账号配额、子网地址和节点配置。
随后按 通过 Kubernetes API 访问 Agent 集群 获取访问配置，集群创建完成和节点就绪后，通过实际任务确认镜像、运行环境和业务依赖能够正常工作。
使用办公助手时，可继续 部署和管理 AgentWay。
常见问题
现象
检查方法
集群列表加载失败
检查当前地域是否已开通、账号权限和页面错误信息；加载失败不表示没有集群。
VPC 或 TCR 实例无法选择
核对资源地域、账号权限及资源是否已创建。
参数预检不通过
根据提示检查网络冲突、必填项、规格和资源可用性。
集群创建后没有计算节点
继续创建节点池；创建集群不会替代节点容量准备。
节点数量不足或节点不就绪
查看节点池事件和节点状态，检查配额、库存、网络及初始化结果。
节点正常但任务等待运行
检查任务资源、调度约束、镜像和工作区。

配置项	如何选择
集群名称	例如 `agc-docs-demo`，便于与生产环境区分。
描述和标签	记录用途、负责人或所属项目，方便后续查找和管理。
集群规格	根据计划管理的节点数和 Pod 数选择。集群规格管理的是集群规模，任务的 CPU 和内存由节点池提供。
开启自动升配	需要随集群规模增长提升管理规格时开启；固定规模的首次测试可以保持关闭。该选项不会增加计算节点，也不包含自动降配。
VPC	选择准备好的业务网络，确认与镜像仓库、模型服务和工作区存储的连通方式。
容器网络	填写已规划的网段，核对页面显示的单节点 Pod 上限、Service 上限及集群最大节点数。容器网络创建后不能修改。
镜像加速与 TCR 实例	开启后选择对应的 TCR 实例；准备阶段即确认实例和镜像访问权限。
删除保护	保持开启，避免误删。需要清理集群时再关闭。

配置项	本例的选择方法
节点池名称	使用 `agc-test-pool`，与生产节点池分开。
可用区和子网	选择有足够地址的子网，同时满足工作区存储的挂载范围。
机型、CPU 和内存	按测试任务的资源需求选择，并为系统组件及运行时留出空间；镜像架构应与节点架构一致。
操作系统与运行环境	选择与 Agent 工作负载运行环境匹配的配置。节点加入集群后，还需检查运行环境是否可用。
磁盘	为系统、镜像缓存和任务临时文件预留空间；需要跨节点保留的文件使用持久化工作区。
节点数量	单节点运行测试选择 1 个；跨节点工作区测试选择 2 个。
弹性伸缩	首次测试使用固定数量，完成验证后再按业务需求配置伸缩范围。
标签和污点	与工作负载的节点选择和容忍配置一致，避免节点正常但任务无法调度。

现象	检查方法
集群列表加载失败	检查当前地域是否已开通、账号权限和页面错误信息；加载失败不表示没有集群。
VPC 或 TCR 实例无法选择	核对资源地域、账号权限及资源是否已创建。
参数预检不通过	根据提示检查网络冲突、必填项、规格和资源可用性。
集群创建后没有计算节点	继续创建节点池；创建集群不会替代节点容量准备。
节点数量不足或节点不就绪	查看节点池事件和节点状态，检查配额、库存、网络及初始化结果。
节点正常但任务等待运行	检查任务资源、调度约束、镜像和工作区。

创建集群和节点池

本页目录：

开始前准备

第一步：创建 Agent 集群

第二步：创建节点池

第三步：确认可以运行任务

常见问题