imicola 架构全貌
架构全貌

架构全貌

682 字 · 约 2 分钟

业务场景

maintenance-controller 项目叫这个名字,直译过来看就是 「维护控制器」,我们需要解决的一个在 k8s 维护中切实存在的问题,即在保障业务不中断(或严格遵守业务可用性契约)的前提下,将目标节点上的工作负载安全地排空

如果我们简单的使用 kubectl delete pod ,就违反了工程上重要的 优雅退出 流程,同时可能会导致服务中断与雪崩等事件,所以

所以我们的项目引入一种自定义资源 MaintenancePlan 用于将管理员一次性的维护意图翻译为一种 受控的,分阶段的 协调动作

k8s 式哲学: 循环协调

在 k8s 中,当我们观察到 「Pod从节点a移动到节点b」这个现象,不是 k8s 用了一个剪切粘贴键一键将 Pod 移动到了另外一个节点,而是一次有条理的协调过程 (要不然万一一个节点在西雅图一个在北京这怎么粘贴过去)

  • 首先是我们的控制器先 API Server 发起一次驱逐请求 (Eviction)
  • 节点的 kubelet 收到删除通知,推进旧 Pod 优雅退出并销毁
  • k8s 中的 ReplicaSet Controller 观察到实际的健康副本数少于期望的副本数,于是向 API Server 申请创建一个全新的 Pod
  • kube-scheduler 为这个新的 Pod 自动选择合适的节点,同时由于目标节点已经被 cordon ,所以新的 Pod 会被调度到其他健康容器中
  • 目标节点上的 kubelet 启动新容器,在探针检测就绪后开始对外提供服务

所以 表面上的移动实际上是一次重部署的过程

组件的职责边界

在我们项目的组件中,整个逻辑链条按下面的方式推进

[管理员]
   │ 提交声明式意图
   ▼
[MaintenancePlan CR] ──spec: 目标节点 / 目标负载 / 允许驱逐 / 超时预算
   │
   ▼
[maintenance-controller] ◄── 持续观察当前事实 (ReadFacts)
   │ 1. 发现事实未满足,执行业务规则决策 (Decide / DecideDrain)
   │ 2. 执行原子 cordon 并写入所有权标记 (cordon.go)
   │ 3. 向 API Server 提交受限驱逐请求 (evictor.go)
   │ 4. 报告当前进度与观测代次 (reconciler.go)
   │
   ▼ 驱动底层原生组件异步推进
┌─────────────────────────────────────────────────────────────┐
│ API Server:   持久化对象、准入控制、校验 PDB                │
│ kubelet:      接收终止信号、执行优雅退出宽限、杀容器        │
│ ReplicaSet:   感知副本缺失、向 API 补出全新 Pod             │
│ Scheduler:    感知目标节点不可调度,将新 Pod 调度到其他节点 │
└─────────────────────────────────────────────────────────────┘

源码分工映射

  • main.go 模块入口,用于解析启动参数和确定运行模式,同时构建依赖注入对象
  • fact.go 中的 ReadFacts 用于只读采集当前集群的真实状态
  • decide.go 负责决策,通过 输入Fact -> 输出decide 来判断当前应该是等待、阻塞、报错、封锁还是驱逐
  • 执行层面,由 cordon.go 与 evictor.go 构成,前者负责 cordon 节点,后者则负责 evictor,这两个函数直接和 API Server 交互
  • reconciler.go 模块的核心代码,负责串联“读事实→决策→前置持久化→执行→推进状态”的完整 Reconcile 循环
  • plan_type.go, k8s/maintenance-crd.yaml 负责定义 CRD 结构体,Json tag 和 常量,定义,Scheme 注册入口