6.2 reconcile 幂等与状态转换
第 5 章建立了「控制器是负反馈系统」的模型。本节落到实现层面:reconcile 函数——控制器的单轮调谐。它的两个核心问题:幂等怎么保证,状态转换怎么用幂等安全地构建。
reconcile 的结构:读-算-写
一次 reconcile 是三步:
读:从 informer 缓存读对象的现实状态(可能有界滞后)
算:对比期望(spec)与现实,计算差异
写:发出修正动作(创建/删除/更新对象)
用 lab 的 ReconcileFunc 看它的类型:
type ReconcileFunc func(current, desired int) (actions []Action, converged bool)
输入是「当前实际」与「期望」,输出是「需要执行的动作」与「是否已收敛」。Action 记录动作类型与数量:
type Action struct {
Kind string // "create" / "delete" / "update"
Count int
}
这是第 5.1 节负反馈五要素的代码形态:误差 = desired - current,动作 = 缩小误差,converged = 误差为零。
幂等的定义:同一输入,同一输出
幂等(idempotent)的严格定义:对同一输入执行任意多次,结果与执行一次相同。
reconcile 的幂等体现在:
- 现实已收敛(current == desired)→ 动作列表为空,什么都不做。
- 现实未收敛 → 发出「把现实拉向期望」的动作,动作基于现实计算。
lab 的 ReconcileIdempotent 测试验证的正是这个:RS 已收敛后再次 Reconcile(),返回的 (create, delete) 都是 0——重复调谐不产生多余动作。
func (rs *ReplicaSet) Reconcile() (create int, delete int) {
ready := rs.ReadyCount()
total := rs.TotalCount()
switch {
case total < rs.Desired:
return rs.Desired - total, 0 // 补建
case ready > rs.Desired:
return 0, ready - rs.Desired // 缩容
default:
return 0, 0 // 已收敛,幂等
}
}
幂等不是靠「记住上次做了什么」,而是靠「每次从现实出发重算」。控制器不维护「我上次创建了 3 个 Pod」的记忆,它只看「现实有 0 个、期望 3 个」→ 创建 3 个。重复执行、甚至重启后执行,结果都一样。
为什么幂等是正确性的地基
分布式系统里,reconcile 会被重复执行,原因不可避免:
- 事件重复:watch 可能重发事件(3.1 节),同 key 多次入队(6.1 节)。
- 失败重试:reconcile 中途失败,workqueue 把它重新入队(6.1 节)。
- 崩溃恢复:控制器进程重启,standby 接管(4.3 节),从零开始重新调谐。
如果 reconcile 不幂等,这三类重复会导致:重复创建 Pod、重复删除、状态抖动。幂等让重复执行变得无害——这是控制器能在「至少一次」的交付语义上安全运行的前提。
状态转换:用幂等构建多步流程
有状态应用的调谐不是一步到位,而是多个状态的转换。以 Job 为例(第 10 章):
Pending(等待 Pod 启动)→ Running(Pod 运行中)→ Succeeded/Failed(终态)
Job 控制器的 reconcile 每轮只看「当前处于哪个状态、下一步是什么」,而不是「整个流程的剧本」:
func (j *Job) NeedNew() bool {
if j.Succeeded >= j.Completions {
return false // 已完成,不再起 Pod
}
if j.Failed > j.BackoffLimit {
return false // 失败耗尽,不再起 Pod
}
if j.Active >= j.Parallelism {
return false // 并发满,等现有 Pod 结束
}
return j.Succeeded+j.Active < j.Completions
}
关键设计:每个状态转换都是幂等的判断。NeedNew 是「当前是否还需要新 Pod」的纯函数——重复调用结果不变。控制器每轮对每个 Pod 问「这个 Pod 结束了吗、成功还是失败」,然后推进计数。
状态转换的分布式优势:
- 中途失败可恢复:如果控制器在「标记 Pod 成功」后崩溃,重启后重新调谐,看到的是「Succeeded+1」的中间态,继续推进。
- 不需要持久化的流程状态:流程的「进度」都体现在对象字段(Succeeded/Failed/Active)里,而不是控制器的内存变量里。
- 每个动作独立幂等:StartPod 只是 Active++,Finish(succeeded) 只是更新计数——重复执行不改变语义。
幂等与最终一致的关系
第 3.3 节的缓存滞后、第 5.2 节的收敛,最终都靠幂等兜底:
- 控制器读到旧现实 → 算出「基于旧现实的差异」 → 写回时可能 409(2.2 节)→ 重新读、重新算。
- 收敛的中途状态(Pending → Ready)被控制器反复检查,直到追平。
幂等让「读了旧值」和「重复执行」都变成可恢复的。它不是消除滞后,而是让滞后与重复变得无害。这是声明式系统能接受「有界滞后 + 最终一致」的根本原因。
一句话概括幂等与最终一致的关系:「从现实出发」这一原则同时买来了「重复无害」与「滞后无害」——两个分布式系统的老大难问题,被同一个设计解决。
幂等的落地:谁的状态谁写
幂等不是抽象原则,它落地在一套具体的字段分工上。K8s 对象拆成两块,各有各的写者:
| 字段 | 谁写 | 幂等语义 |
|---|---|---|
spec.* | 用户/上层控制器 | 声明期望,重复写结果相同 |
status.* | 下层控制器 | 汇报现实,重复更新不改变含义 |
这个分工让「幂等」有了落点:
- spec 幂等:用户反复
kubectl apply同一个 YAML,结果不变——apply 的三方合并(2.3 节)保证「只改差异」。 - status 幂等:控制器反复写 status 里的计数(如
status.readyReplicas),是「从现实重算」的幂等写——每次都是把现实最新值写上去,不是累加。 - 跨字段边界:控制器只写 status,不碰 spec(7.3 节 RS 只建/删 Pod 不改 replicas)。这条边界让「用户改 spec」与「控制器写 status」互不干扰。
「谁的状态谁写」是幂等的最强实现:写者只写自己的字段,字段内容由现实决定,重复执行天然无害。如果控制器既改 spec 又写 status,两个写者竞争同一字段,幂等就无法保证了——这是设计上避免的。
幂等的边界:什么情况下会破坏
幂等是「从现实出发」的自然结果,但三个常见实现会破坏它:
- 依赖本地计数器:
reconcileCount++之类的内存变量参与决策——重启就丢,且重复执行产生不同结果。 - 「上次做过什么」的记忆:控制器记录「上次建了 3 个 Pod,这次补 2 个」——重启后记忆丢失,或记忆与现实不同步。
- 非幂等的副作用:reconcile 里发外呼(邮件、消息队列)——重复执行产生重复副作用。
破绽的根源都一样:引入了「历史」或「外部状态」。幂等要求「输出只取决于当前现实输入」——任何把过去的执行或内存状态掺进来的实现,都在破坏幂等。
三个常见误解
- 「幂等 = 只执行一次」——错误。幂等是「执行多次结果相同」,恰恰是为了允许重复执行。
- 「控制器要记住上次做了什么」——错误。控制器从现实出发重算,不依赖历史记忆。
- 「多步流程要用事务」——错误。K8s 没有跨对象事务;流程的中间态表达在对象字段里,靠幂等重试推进。
本节 lab
本节验证 reconcile 的幂等与负反馈收敛:
cd private/labs/k8s-ctrl-lab
go test ./controller -run 'TestReconcileIdempotent|TestFeedbackConvergence|TestFeedbackPartial' -v
TestReconcileIdempotent:RS 已收敛后再次 Reconcile 返回零动作——「同一现实输入,永远产生同一输出」。TestFeedbackConvergence:rate=1.0 时一轮收敛——误差一次清零。TestFeedbackPartial:rate=0.5 时多轮渐进收敛——负反馈按比例减小误差。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。