- 文档首页
容器服务
容器服务 VKE
用户指南
网络
集群网络
API Server 子网管理
API Server 子网管理
容器集群中的 Master 节点负责整个集群的管理和控制,可通过配置不同可用区下的多个子网,满足 API Server 在多可用区的容灾能力的同时将 Master 节点打散,进一步提高集群的高可用性。本文为您介绍如何管理 API Server 的子网配置。
Kubernetes 控制面作为集群的核心管理单元,承载 API Server、etcd、Controller Manager 等关键组件,是集群调度、服务发现与资源编排的核心中枢,其网络连通性与高可用能力直接影响集群整体稳定性。当 API Server 为单子网模式时,在业务规模扩张、多可用区容灾建设、网络规划调整等场景下将逐渐暴露局限:单子网故障可能直接影响 API Server 整体可用性,IP 地址资源易出现不足,也难以满足精细化网络隔离与安全策略落地需求。
容器服务支持在控制台对 API Server 子网进行动态添加与删除。当集群从单子网架构向多子网、多可用区架构演进时,可通过新增子网实现 API Server 跨可用区部署,提升容灾能力与网络弹性;当子网规划变更、资源冗余或策略调整时,可删除不再使用的 API Server 子网,优化网络拓扑、回收 IP 资源并简化运维管理,从而在不重建集群的前提下,实现 API Server 网络架构的平滑升级与生命周期管理。
使用限制
- 每个集群最多添加 3 个可用区下的子网;每个集群最多添加 6 个子网,且单个可用区下的子网不允许超过 2 个。
- 添加子网时,将触发 API Server 滚动更新。集群状态将变更为 更新中。业务不会中断,但建议在业务流量低峰期进行操作。
- 在 IPv4/IPv6 双栈场景中,必须添加可用的双栈子网。
操作步骤
- 在 概览 页签的 集群 API Server 配置 中,单击子网后面的 编辑。
-
- 勾选需要添加的子网,单击 确定,即可为 API Server 添加子网,集群状态由 更新中 变更为 运行中 时表示添加成功。
说明
建议配置不同可用区下的多个子网,提高集群的高可用性。
-
- 必须至少保留 1 个 API Server 子网。
- 剩余子网的可分配 IP 数量必须大于 6,以确保 API Server 可以扩容到最大支持的副本数。
- 删除子网将触发 API Server 滚动更新。集群状态将变更为 更新中。业务不会中断,但建议在业务流量低峰期进行操作。
- 在 概览 页签的 集群 API Server 配置 中,单击子网后面的 编辑。
-
- 取消勾选子网,单击 确定,即可删除 API Server 子网,集群状态由 更新中 变更为 运行中 时表示删除成功。
-
最近更新时间:2026.05.26 10:49:16