四卷规划 · 卷一 共识与存储 · 卷二 控制面与调谐循环 · 卷三 调度与资源 · 卷四 网络、存储、多集群与一致性边界
本卷阅读路径
flowchart LR
Object["第 1–3 章 · 对象 / 乐观并发 / list-watch"] --> Loop["第 5–6 章 · 控制回路 / 幂等调谐"]
Loop --> Orc["第 7–10 章 · ReplicaSet / Deployment / StatefulSet / Job"]
Gate["第 11–12 章 · 准入链 / APF 限流"] --> Loop
LE["第 4 章 · Lease 与选主"] --> HA["第 14 章 · 高可用与故障切换"]
Object --> Ext["第 13 章 · 聚合层与 CRD"]
Loop --> Final["第 15 章 · 数据面视角与最终一致"]
Orc --> Final
卷二从「一次 kubectl apply 之后发生了什么」入手:先拆对象模型与 REST 语义、乐观并发、list-watch 与 informer 缓存——「控制面怎么看世界」;再进入控制回路与幂等调谐、workqueue——「控制器怎么干活」;随后逐层解剖 ReplicaSet/Deployment/StatefulSet/Job 控制器——「具体控制器怎么收敛」;再转到写路径的准入链与 APF 限流、API 扩展、多副本高可用与选主;最后从数据面回看控制面,把整条链串成「从声明到收敛」的最终一致。卷二回答「状态怎么驱动系统收敛到期望状态」;卷一(共识与存储)提供一致性底座,卷三(调度与资源)、卷四(网络、存储、多集群与一致性边界)分别在各自卷展开。
怎么读这一卷
三条阅读路径
| 路径 | 章节顺序 | 建议周期 | 适合谁 |
|---|---|---|---|
| 控制器主线 | 第 1–3 章 → 第 5–6 章 → 第 7–10 章 | 约 4 周 | 先建立对象与可见性基础,再完整走一遍从控制回路到各类控制器的收敛。 |
| 写路径与治理线 | 第 1–2 章 → 第 11–12 章 → 第 13 章 | 约 3 周 | 从写请求的旅程入手,看准入链、APF 限流与 API 扩展怎么给控制面把关。 |
| 高可用与工程线 | 第 2 章 → 第 4 章 → 第 14 章 | 约 2 周 | 从对象与乐观锁出发,看 Lease 选主、多副本高可用与故障切换。 |
与站内既有内容的分工
| 书稿 | 负责范围 | 本卷如何处理 |
|---|---|---|
| 《游戏服务端架构》 四卷 | 服务端核心系统与契约 | 不写业务系统,讲「循环 + 状态机」的分布式机制层 |
| 《MMO 服务器开发》 四卷 | 游戏分布式系统的实战形态 | 不写玩法实现,专注控制面/事件流/一致性机制 |
| 《后端架构设计》 四卷 | 分布式与数据一致性的架构落位 | 不重推架构决策,讲控制器/选主/限流的机制实现 |
| 《Java 并发编程》 | 语言运行时并发源码解析 | 同为「源码摘录 + 实测」写法,对象换成分布式控制面 |
十五章依赖关系
| 章 | 标题 | 依赖 |
|---|---|---|
| 1 | kubectl apply 之旅:对象、REST 与多副本 | 无 |
| 2 | 对象标识与乐观并发 | 依赖第 1 章 |
| 3 | list-watch 与 informer 缓存 | 依赖第 1、2 章 |
| 4 | Lease 与选主 | 依赖第 2 章(对象/乐观锁) |
| 5 | 控制回路与收敛 | 依赖第 3 章 |
| 6 | workqueue 与幂等调谐 | 依赖第 3、5 章 |
| 7 | ReplicaSet 与滚动更新 | 依赖第 5、6 章 |
| 8 | Deployment 分层与策略 | 依赖第 7 章 |
| 9 | StatefulSet 有状态编排 | 依赖第 5、6 章 |
| 10 | Job 与 CronJob | 依赖第 5、6 章 |
| 11 | 准入链:写请求把关 | 依赖第 2 章(写路径) |
| 12 | APF:限流与公平 | 依赖第 11 章(写路径语境) |
| 13 | API 扩展:聚合层与 CRD | 依赖第 1、2 章 |
| 14 | 控制面高可用与故障切换 | 依赖第 4 章(选主) |
| 15 | 数据面视角与最终一致 | 汇总第 1–14 章 |
按问题追踪实现
- 从「一次 apply 之后发生了什么」:沿完整旅程 和整条链的最终一致 阅读。
- 从「写请求会不会被拒」:沿准入链 、failurePolicy 和乐观锁 阅读。
- 从「控制器怎么干活」:沿控制回路 、workqueue 和幂等调谐 阅读。
- 从「多副本会不会双主」:沿Lease 与选主 、租约续约与防双主 和故障切换 阅读。
- 从「apiserver 会不会被打爆」:沿APF 和控制器节流 阅读。
每条路径的机制都由 k8s-ctrl-lab(private/labs/k8s-ctrl-lab)验证:cd private/labs/k8s-ctrl-lab && go build ./... && go test ./...,49 用例全过。
逐节索引
第 1 章 kubectl apply 之旅:对象、REST 与多副本
| 节 | 文章 | 核心内容 |
|---|---|---|
| 1.1 | 1.1 一次 kubectl apply 的完整旅程 | 从客户端到 etcd 到控制器的整条链路。 |
| 1.2 | 1.2 REST 语义:verbs、子资源、集合与分页 | 资源、动作与分页的 REST 模型。 |
| 1.3 | 1.3 多副本拓扑与 etcd 单点依赖 | 控制面拓扑与单点依赖的边界。 |
第 2 章 对象标识与乐观并发
| 节 | 文章 | 核心内容 |
|---|---|---|
| 2.1 | 2.1 UID、resourceVersion 与 generation 语义 | 三个标识字段的分工与语义。 |
| 2.2 | 2.2 乐观锁冲突与 409 | 用版本而非锁实现并发写安全。 |
| 2.3 | 2.3 Update 与三种 Patch:merge、JSONPatch、Apply | 全量 vs 增量写的语义差异。 |
第 3 章 list-watch 与 informer 缓存
| 节 | 文章 | 核心内容 |
|---|---|---|
| 3.1 | 3.1 list-watch 原语与增量同步 | 一次全量 + 持续增量的同步模式。 |
| 3.2 | 3.2 Reflector、DeltaFIFO 与 Indexer | informer 三层结构与去重索引。 |
| 3.3 | 3.3 缓存滞后、relist 退避与一致性边界 | 缓存的滞后代价与重连语义。 |
第 4 章 Lease 与选主
| 节 | 文章 | 核心内容 |
|---|---|---|
| 4.1 | 4.1 Lease 资源与续约 | 租约对象的持有/续约/过期。 |
| 4.2 | 4.2 Leader Election 客户端库原理 | client-go 选主库的封装语义。 |
| 4.3 | 4.3 多副本 controller-manager 如何防双主与收敛 | 单写者与多副本的协调。 |
第 5 章 控制回路与收敛
| 节 | 文章 | 核心内容 |
|---|---|---|
| 5.1 | 5.1 desired/current 与负反馈 | 期望与现实之间的测量-动作。 |
| 5.2 | 5.2 控制器即负反馈系统:收敛与震荡 | 收敛性与参数选择。 |
| 5.3 | 5.3 声明式 vs 命令式的设计取舍 | 两种接口哲学的代价。 |
第 6 章 workqueue 与幂等调谐
| 节 | 文章 | 核心内容 |
|---|---|---|
| 6.1 | 6.1 workqueue:去重、重试与退避 | 队列如何缓冲事件与限速。 |
| 6.2 | 6.2 reconcile 幂等与状态转换 | 重复执行无害的收敛前提。 |
| 6.3 | 6.3 控制器如何防止打爆 API Server | 客户端侧节流与限流分层。 |
第 7 章 ReplicaSet 与滚动更新
| 节 | 文章 | 核心内容 |
|---|---|---|
| 7.1 | 7.1 ReplicaSet 调谐算法:期望 vs 实际副本 | 副本收敛的最小控制器。 |
| 7.2 | 7.2 滚动更新引擎:surge 与 maxUnavailable | 滚动节奏与可用性约束。 |
| 7.3 | 7.3 扩缩容的分布式语义 | 并发写、抖动与收敛。 |
第 8 章 Deployment 分层与策略
| 节 | 文章 | 核心内容 |
|---|---|---|
| 8.1 | 8.1 Deployment→RS→Pod 链式调谐 | 多层控制器如何接力收敛。 |
| 8.2 | 8.2 滚动/重建策略矩阵 | 更新策略的选择逻辑。 |
| 8.3 | 8.3 回滚、暂停与进度卡住诊断 | 诊断方法论与控制面操作。 |
第 9 章 StatefulSet 有状态编排
| 节 | 文章 | 核心内容 |
|---|---|---|
| 9.1 | 9.1 有序创建/删除与稳定标识 | 顺序语义与身份稳定。 |
| 9.2 | 9.2 volumeClaimTemplates 与有序扩缩 | 声明式卷与扩容顺序。 |
| 9.3 | 9.3 Quorum 类应用的有状态表达 | 有状态应用的拓扑与一致性。 |
第 10 章 Job 与 CronJob
| 节 | 文章 | 核心内容 |
|---|---|---|
| 10.1 | 10.1 完成语义:completions/parallelism | 完成型工作负载的收敛目标。 |
| 10.2 | 10.2 失败与 backoffLimit | 失败重试与放弃边界。 |
| 10.3 | 10.3 CronJob 漏执行与重叠 | 时间语义与并发约束。 |
第 11 章 准入链:写请求把关
| 节 | 文章 | 核心内容 |
|---|---|---|
| 11.1 | 11.1 准入链:写请求的必经关卡 | 先改后验与任一拒绝整体拒绝。 |
| 11.2 | 11.2 failurePolicy 与 webhook 幂等 | 故障策略与重复无害。 |
| 11.3 | 11.3 webhook 排序、作用域与准入链可扩展性 | 多团队共享链的排序与隔离。 |
第 12 章 APF:限流与公平
| 节 | 文章 | 核心内容 |
|---|---|---|
| 12.1 | 12.1 APF:FlowSchema 与优先级 | 请求分类与分级配额。 |
| 12.2 | 12.2 APF 队列与公平性 | 队列 FIFO 与优先级间公平。 |
| 12.3 | 12.3 令牌桶限流与配额预算 | 平均限速与突发容忍。 |
第 13 章 API 扩展:聚合层与 CRD
| 节 | 文章 | 核心内容 |
|---|---|---|
| 13.1 | 13.1 聚合层:apiserver 的扩展点 | 统一入口与后端委托。 |
| 13.2 | 13.2 CRD 与多版本转换 | 存储版本与服务版本的区分。 |
| 13.3 | 13.3 API 发现与扩展路径选型 | 发现目录与两条扩展路径。 |
第 14 章 控制面高可用与故障切换
| 节 | 文章 | 核心内容 |
|---|---|---|
| 14.1 | 14.1 多副本控制面架构 | 无状态扩展 vs 选主单写者。 |
| 14.2 | 14.2 租约续约与防双主 | 续约保活与过期接管。 |
| 14.3 | 14.3 故障切换与恢复 | detect/takeover/recover 与幂等接管。 |
第 15 章 数据面视角与最终一致
| 节 | 文章 | 核心内容 |
|---|---|---|
| 15.1 | 15.1 从数据面回看控制面 | 对象协议是两面的唯一接口。 |
| 15.2 | 15.2 整条链的最终一致:从写请求到全站收敛 | 一次写请求到全站收敛的链路。 |
| 15.3 | 15.3 全书收束:控制面与调谐循环 | 对象、循环、护栏三个认识的总结。 |
相关阅读
- 书稿专题 :站内全部书稿的入口。
- 《Kubernetes 分布式系统原理深入解析》卷一 · 共识与存储 :本卷的一致性底座——乐观锁的 RV、Lease 的对象、watch 的变更流都由 etcd/Raft 提供。
- 《游戏服务端架构》·核心系统与契约 :服务端「循环 + 状态机」设计,与控制器的读-算-写呼应。
- 《MMO 服务器开发》·分布式与跨服 :分布式状态同步与一致性,与控制面的 watch/选主呼应。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。