参考来源与致谢
- 引用来源:[k8s]k8s架构图解 – 毛台 – CSDN博客
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
本文面向企业 IT 运维人员,用于理解 Kubernetes 集群的整体架构,支撑以下工作:集群规划与容量评估、故障定位时判断问题落在控制面还是工作节点、升级或变更前的风险评估、以及向团队解释组件职责边界。文中不涉及具体发行版差异,实际组件名称、默认端口与行为请以所用版本的官方文档为准。
架构总览 #
Kubernetes 集群在逻辑上分为控制面(Control Plane)与工作节点(Worker Node)两部分。控制面负责集群状态的存储、决策与调度;工作节点负责实际运行容器化工作负载。二者通过 API Server 进行通信,节点与组件不直接互相调用。
控制面组件 #
- API Server:集群唯一入口,提供 REST 接口,负责认证、授权、准入控制与对象读写。其他组件均通过它读写状态。
- etcd:一致性键值存储,保存集群全部持久化状态。它是集群中数据最关键的组件,需重点保障备份与磁盘性能。
- 调度器(Scheduler):监听尚未绑定节点的工作负载对象,依据资源请求、亲和性、污点与容忍等规则选择目标节点。
- 控制器管理器(Controller Manager):运行各类控制器循环,持续将实际状态向期望状态收敛,例如副本数维持、节点生命周期管理。
工作节点组件 #
- kubelet:节点代理,接收分配给本节点的 Pod 规格,调用容器运行时创建、启动、停止容器,并上报节点与 Pod 状态。
- 容器运行时:实际执行容器的组件,通过标准接口与 kubelet 交互。
- 网络插件:为 Pod 分配地址并实现跨节点通信,具体实现取决于所选方案。
- kube-proxy 或等效组件:实现 Service 的流量转发规则,将访问服务地址的请求导向后端 Pod。
典型交互路径 #
- 运维人员或流水线向 API Server 提交对象定义。
- API Server 完成校验后写入 etcd。
- 控制器管理器发现期望状态与现状不一致,创建相应对象。
- 调度器为未绑定节点的工作负载选择节点,并写回绑定结果。
- 目标节点的 kubelet 感知到分配结果,调用容器运行时启动容器。
- kubelet 持续上报状态,控制器据此判断是否需要进一步收敛。
准备与风险 #
- 确认目标版本的组件清单与端口要求,查阅对应版本官方文档,不要套用其他版本结论。
- etcd 数据必须定期备份,并验证可恢复性。备份文件应存放在集群之外的位置。
- 控制面组件升级或配置变更属于高风险操作,先在测试环境完整演练。
- 节点维护前先驱逐其上工作负载,确认业务副本在其他节点可正常承接。
- 网络插件变更可能影响跨节点通信,变更前记录当前配置与地址规划。
任何删除、重置、清理类命令都可能造成不可逆的数据丢失。执行前必须完成备份、在测试环境验证,并明确回退路径。
处理步骤 #
- 查看集群整体状态,确认控制面与节点是否就绪:
kubectl get nodes -o wide kubectl get componentstatuses部分版本已不推荐使用 componentstatuses,请以对应版本文档为准。
- 查看控制面组件所在命名空间下的工作负载状态:
kubectl get pods -n kube-system -o wide - 定位异常组件日志,先看事件再看日志:
kubectl describe pod [组件Pod名称] -n kube-system kubectl logs [组件Pod名称] -n kube-system - 检查节点侧代理状态与资源占用,确认节点是否处于可调度状态。
- 如需变更配置,先在测试环境修改并验证,再按批次滚动应用到生产环境。
验证方法 #
- 节点列表全部显示就绪,且无长期处于不可调度状态的节点。
- 控制面组件工作负载副本数与期望一致,无反复重启。
- 新建一个测试工作负载,确认可被调度、可正常启动、可被服务访问。
- 删除测试工作负载,确认控制器能正确回收资源。
- 检查事件流中无持续报错,关键组件日志无异常堆栈。
回退建议 #
- 变更前记录当前配置、镜像版本与对象定义,保留可复现的原始清单。
- 控制面配置变更失败时,恢复变更前的配置文件并重启对应组件。
- etcd 数据异常时,使用最近一次验证过的备份进行恢复,恢复后核对关键对象是否完整。
- 节点变更失败时,先将其标记为不可调度,排查后再决定是否重新加入集群。
- 回退操作同样需要在测试环境验证流程,避免回退过程引入新问题。
常见问题 #
- 工作负载长期处于等待调度状态:检查节点资源是否充足、是否存在污点与容忍不匹配、亲和性规则是否过严。
- Pod 无法启动:查看事件与 kubelet 日志,确认镜像拉取、存储挂载、运行时状态是否正常。
- 服务无法访问:确认后端 Pod 就绪、转发规则已生成、网络插件工作正常。
- 控制面响应缓慢:优先排查 etcd 所在磁盘的延迟与容量,以及 API Server 的请求压力。
- 节点状态异常:确认节点与 API Server 之间的网络连通性,以及节点侧代理是否在运行。
以上为通用架构与排查思路,具体组件行为、命令输出与支持范围随版本变化,请查阅对应版本的官方文档确认。
