Agent Runtime 创建集群和节点池

一、开始前准备

·使用具有集群、节点池和网络资源管理权限的腾讯云账号。

·确定集群所在地域，准备同一地域的 VPC 和节点子网，并确认子网剩余地址能够满足扩容需要。

·规划容器网络，避免与 VPC、对等连接以及其他需要互通的网络地址重叠。

·确认节点能够访问镜像仓库，任务能够访问所需的模型、工具和存储服务。

·开启镜像加速时，准备创建页面需要选择的 TCR 实例。

首次运行可先准备一个节点；需要按照快速入门验证工作区跨节点迁移时，准备两个配置相同的节点。节点规格需要覆盖业务资源和系统组件开销，费用构成见资源与费用说明。

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 实例无法选择	核对资源地域、账号权限及资源是否已创建。
参数预检不通过	根据提示检查网络冲突、必填项、规格和资源可用性。
集群创建后没有计算节点	继续创建节点池；创建集群不会替代节点容量准备。
节点数量不足或节点不就绪	查看节点池事件和节点状态，检查配额、库存、网络及初始化结果。
节点正常但任务等待运行	检查任务资源、调度约束、镜像和工作区。