15.3 全书收束:控制面与调谐循环
卷二 15 章、45 节到此收束。与其再重复一遍各章内容,不如把整本书浓缩成三个认识——声明式对象是基石、控制器是引擎、分布式机制是护栏。理解这三个词,就理解了控制面。
认识一:声明式对象是基石
整卷都站在同一个地基上:对象是 spec/status 的两面体(第 1、2 章)。
spec(声明期望)→ 谁都能写、写的是「要什么」
status(汇报现实)→ 控制器写、写的是「是什么」
从这张地基长出来的一切:
- 乐观锁(2 章):让「写 spec」不错——RV 保证并发写不覆盖。
- list-watch(3 章):让「读 status」不漏——增量语义让世界可见。
- 分层传播(7-10 章):Deployment 写 RS 的 spec、RS 写 Pod 的 spec——每一层都是「上面的声明 → 下面的现实」。
对象不是「数据结构」,而是「期望与现实的容器」。控制面的一切机制,都在回答同一个问题:让对象里的现实追上 spec。
认识二:控制器是引擎
推动「现实追 spec」的是控制器(第 5-10 章)。一个控制器 = 一个循环:
watch 对象变化 → 算差异(spec - status)→ 写修正(拉齐现实)
引擎的四个细节:
| 细节 | 章节 | 为什么关键 |
|---|---|---|
| 队列 | 6.1 | 事件太多,去重、退避、缓冲 |
| 幂等 | 6.2 | 重复执行无害,才能安全重试 |
| 节流 | 6.3 | 不自我节流就会打爆 apiserver |
| 分层 | 7-10 | 每个资源一个控制器,各管一层 |
控制器的形态是多样的:RS 管数量(7 章)、Deployment 管版本(8 章)、StatefulSet 管序(9 章)、Job 管完成(10 章)——但骨架都是「读-算-写」。理解一个控制器就理解全部,区别只在「算差异」的规则。
认识三:分布式机制是护栏
引擎要可靠运行,需要护栏——控制面的分布式机制:
| 护栏 | 防什么 | 章节 |
|---|---|---|
| 准入 | 非法/未加工的对象进存储 | 11 |
| APF | apiserver 被超载打爆 | 12 |
| 扩展 | 能力外置、入口统一 | 13 |
| 选主 | 多副本双主竞争 | 14 |
护栏与引擎的关系:引擎负责「让现实追 spec」,护栏负责「这个过程不会把系统搞坏」——非法写被准入拦、超载被 APF 限、双主被选主防、能力被扩展隔离。引擎是推力,护栏是安全。
一条主线贯穿 45 节
把三个认识串成一条主线:
你声明(spec)
→ 引擎把它变成现实(控制器逐层调谐)
→ 护栏保证过程安全(准入/限流/选主)
→ 全站收敛(status 追上 spec)
卷二讲的不是「Kubernetes 有哪些组件」,而是「一个声明如何可靠地变成现实」。组件只是这条主线的载体——45 节里讲的所有机制,都是「从声明到收敛」这条路上一段段的护栏与引擎。
回顾:卷二的方法论工具箱
收束之前,把 45 节按「遇到什么问题 → 查哪个机制」整理成一张决策表:
| 现象 | 先看哪个机制 | 章节 |
|---|---|---|
| 写请求被拒 | 准入链、schema 校验 | 11、13.2 |
| 控制器不干活 | workqueue、调谐日志 | 6、5 |
| 对象被反复改 | 幂等、乐观锁 | 6.2、2 |
| apiserver 被挤 | APF、客户端节流 | 12、6.3 |
| 新 API 看不到 | 发现缓存、APIService | 13 |
| 多副本打架 | 选主、租约参数 | 14 |
| 状态不收敛 | 控制器读-算-写 | 5-10 |
| 不知道集群发生了什么 | 对象 status、事件 | 15.1 |
这张表本身就是卷二的方法论:它不是「记住 45 节」,而是「现象 → 机制」的映射。真实排障永远从现象出发,沿着「哪个环节可能断」找机制。书读到最后,留下的不是章节列表,而是这张「症状对机制」的索引——它能回答「我的集群出了 X,我该去哪一章找答案」。
本节 lab
卷二 45 节的 lab 全部落在 k8s-ctrl-lab。最终验证跑全部:
cd private/labs/k8s-ctrl-lab
go build ./... && go test ./... -count=1
覆盖回顾:
- workqueue:去重、延迟、退避、重试上限(6 章)。
- informer:list-watch、DeltaFIFO、Indexer(3 章)。
- api:乐观锁、三种写、CRD 版本转换(1/2/13 章)。
- leaderelection:租约、续约、接管、防双主(4/14 章)。
- admission:准入链、failurePolicy、APF 限流(11/12 章)。
- controller:reconcile、RS、滚动、STS、Job、CronJob(5/7-10 章)。
每个 lab 都是「一个章节语义的可运行证明」——45 节的内容,49+ 个用例验证。跑绿不代表理解,但不跑绿一定是没写对——lab 是这本书「从读到信」的桥梁。
继续深入的方向
卷二收束,控制面的路还可以继续:
| 方向 | 内容 |
|---|---|
| operator 工程 | 用第 6-13 章的方法写自定义控制器(卷二已备足基础) |
| 性能调优 | 缓存、队列、并发、限流参数的实测调优 |
| 源码精读 | controller-runtime、client-go 的真实实现 |
| 卷三/四 | 若此系列有后续卷,可延伸数据面与网络 |
控制面是一座可被彻底理解的山——它没有魔法,只有「对象、循环、护栏」三个概念的组合。看懂卷二,你已经能解释:一个 kubectl apply 之后,集群里到底发生了什么。
写给读者:这本书怎么用
收束的最后,给读者三条使用建议:
| 建议 | 内容 |
|---|---|
| 先跑 lab | 每节末尾的 lab 是「语义的可运行证明」,先跑通再往下读 |
| 按表查章 | 用「方法论工具箱」的决策表,按现象查机制 |
| 组合使用 | 卷二机制要合起来看——准入+APF+选主是一套护栏 |
这本书的目标不是「讲完 Kubernetes 组件」,而是「让你能自己解释任何一次 apply 之后发生什么」。读完卷二,你手里应该有三样东西:一张「现象→机制」的索引、一个能跑的全套 lab、一套「读-算-写」的方法论。控制面的知识不是背下来的,是「跑过 lab、查过表、修过 bug」积累的——这三条建议就是积累的方式。
最后,回到第 1 章的问题:「kubectl apply 之后到底发生了什么?」——你现在有了完整答案:一次写请求,穿过准入与 APF,经存储与 watch,被控制器逐层调谐,在全站收敛。这就是控制面与调谐循环的全部。
三个常见误解(最后一遍)
- 「控制面是黑盒」——错误。它是一套自洽的机制:对象是地基、控制器是引擎、分布式机制是护栏——每一环都可读、可测、可解释。
- 「声明式 = 什么都不用管」——错误。声明式是「把期望说清楚」,收敛仍要靠控制器逐层推进——它把「怎么做」变成机制,不是把「做什么」变成魔法。
- 「最终一致 = 可以接受错误」——错误。最终一致是「有界滞后」,底层仍是强一致(etcd);「可以接受」的是时延,不是错误。
一句话总结卷二
如果只允许用一句话带走卷二,那就是:控制面把一个声明(spec)变成现实(status),靠的是一条「准入把关 → 一致存储 → 增量可见 → 控制器收敛 → 限流护栏 → 选主防双」的链。
这句话里每一个词都是卷二的一章:准入是 11 章,存储是 1-2 章,可见是 3 章,收敛是 5-10 章,限流是 12 章,扩展是 13 章,选主是 14 章。记住这句话,就记住了全书的骨架——细节可以回查,骨架要先在脑子里。
本书系列的位置:卷一、卷二与后续
卷二站在这套系列的第几格?回看卷一与卷二的分工:
| 卷 | 主题 | 与卷二的关系 |
|---|---|---|
| 卷一 | 共识与存储:Raft 与 etcd | 卷二一致性的底座 |
| 卷二 | 控制面与调谐循环 | 在一致存储之上,构建声明式控制面 |
| 后续卷 | 数据面/网络/扩展 | 消费卷二的对象协议(15.1 节) |
卷二假设卷一打好了地基:没有 etcd 的强一致与 Raft 多数,apiserver 的乐观锁、Lease 的选主都是空谈。「存储一致性」是控制面的基础设施——卷二讲的每个机制,都构建在「写不错、读得到」的底座上:乐观锁靠 RV(etcd 的版本)、选主靠 Lease(etcd 里的对象)、watch 靠 etcd 的变更流。
系列的阅读建议:卷一让你懂「数据怎么不丢不错」,卷二让你懂「系统怎么收敛」。如果卷二读到「机制都串起来了」,该回头补卷一的一致性细节(Raft 的多数派、线性一致)——两卷合起来才是完整的分布式系统原理:卷一解决「存储可靠」,卷二解决「状态收敛」,两者缺一,控制面都无法成立。
本书收尾
卷二的最后一节,回望开头:第 1 章从 kubectl apply 出发,问「这个命令之后发生了什么」;45 节之后,答案已经完整——一次写请求,穿过准入与存储,经 watch 与队列,被控制器逐层调谐,在全站收敛。控制面不是一堆服务的集合,而是一个自洽的系统:每个机制都有理由,每段链路都自洽。理解了这一点,Kubernetes 就不再神秘——它只是「声明、调谐、护栏」三个词,和它们精密的组合。
卷二结束,控制面的故事讲完了。但每个读过本书的人,下一步都不同:有人去写自己的 operator,有人去读 controller-runtime 源码,有人去调生产集群的 APF 预算——无论哪条路,手里的工具是同一套:对象、循环、护栏。愿这本书让你在 kubectl apply 之后,不只看到命令,还看到它背后那段精密的自洽世界。控制面是一座可以被彻底理解的山,愿你已登顶——而登顶之后,还有更多山在等你:数据面的网络、存储、调度器,都是这套「对象、循环、护栏」方法论的下一站。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。