posts

《Kubernetes 分布式系统原理深入解析·控制面与调谐循环》 · 全书目录与章节索引(45 篇)

全 45 篇的章节索引:从一次 kubectl apply 的旅程出发,拆解对象模型与 REST 语义、乐观并发、list-watch 与 informer 缓存、Lease 与选主、控制回路与收敛、workqueue 与幂等调谐,逐层进入 ReplicaSet/Deployment/StatefulSet/Job 控制器,再解剖准入链、APF 限流、聚合层与 CRD 扩展、多副本高可用与故障切换,最后以数据面视角与整条链的最终一致收束;每节配一个可运行的 Go 最小验证,共 49 用例。

《Kubernetes 分布式系统原理深入解析·控制面与调谐循环》全 45 篇,是《Kubernetes 分布式系统原理深入解析》四卷本的卷二。本卷以 K8s 的控制面为对象,回答卷一留下的问题——「状态是怎么变成事件流、事件流怎么驱动系统收敛到期望状态」:对象模型与 REST 语义、list-watch 与 informer、控制器与调谐循环、准入链、APF 限流、API 扩展、多副本高可用与选主,直到数据面视角与最终一致;每节配一个可运行的 Go 最小验证,复现该机制的语义。

本页是《Kubernetes 分布式系统原理深入解析·控制面与调谐循环》的全书目录:按章节顺序列出全部 45 篇,点击标题直达正文。也可以从目录与学习路径 进入按顺序通读。

四卷规划 · 卷一 共识与存储 · 卷二 控制面与调谐循环 · 卷三 调度与资源 · 卷四 网络、存储、多集群与一致性边界

全书概览

项目内容
书稿《Kubernetes 分布式系统原理深入解析·控制面与调谐循环》
篇数45 篇(15 章 × 3 节)
领域分布式系统原理 × 真实组件(K8s 控制面 / 控制器 / apiserver)
实验工程k8s-ctrl-lab,纯 Go,go build ./... && go test ./...,49 用例全过
上级专题书稿专题

全书目录

前置

节文章
—目录与学习路径

第 1 章 kubectl apply 之旅:对象、REST 与多副本

节文章
1.11.1 一次 kubectl apply 的完整旅程
1.21.2 REST 语义:verbs、子资源、集合与分页
1.31.3 多副本拓扑与 etcd 单点依赖

第 2 章 对象标识与乐观并发

节文章
2.12.1 UID、resourceVersion 与 generation 语义
2.22.2 乐观锁冲突与 409
2.32.3 Update 与三种 Patch:merge、JSONPatch、Apply

第 3 章 list-watch 与 informer 缓存

节文章
3.13.1 list-watch 原语与增量同步
3.23.2 Reflector、DeltaFIFO 与 Indexer
3.33.3 缓存滞后、relist 退避与一致性边界

第 4 章 Lease 与选主

节文章
4.14.1 Lease 资源与续约
4.24.2 Leader Election 客户端库原理
4.34.3 多副本 controller-manager 如何防双主与收敛

第 5 章 控制回路与收敛

节文章
5.15.1 desired/current 与负反馈
5.25.2 控制器即负反馈系统:收敛与震荡
5.35.3 声明式 vs 命令式的设计取舍

第 6 章 workqueue 与幂等调谐

节文章
6.16.1 workqueue:去重、重试与退避
6.26.2 reconcile 幂等与状态转换
6.36.3 控制器如何防止打爆 API Server

第 7 章 ReplicaSet 与滚动更新

节文章
7.17.1 ReplicaSet 调谐算法:期望 vs 实际副本
7.27.2 滚动更新引擎:surge 与 maxUnavailable
7.37.3 扩缩容的分布式语义

第 8 章 Deployment 分层与策略

节文章
8.18.1 Deployment→RS→Pod 链式调谐
8.28.2 滚动/重建策略矩阵
8.38.3 回滚、暂停与进度卡住诊断

第 9 章 StatefulSet 有状态编排

节文章
9.19.1 有序创建/删除与稳定标识
9.29.2 volumeClaimTemplates 与有序扩缩
9.39.3 Quorum 类应用的有状态表达

第 10 章 Job 与 CronJob

节文章
10.110.1 完成语义:completions/parallelism
10.210.2 失败与 backoffLimit
10.310.3 CronJob 漏执行与重叠

第 11 章 准入链:写请求把关

节文章
11.111.1 准入链:写请求的必经关卡
11.211.2 failurePolicy 与 webhook 幂等
11.311.3 webhook 排序、作用域与准入链可扩展性

第 12 章 APF:限流与公平

节文章
12.112.1 APF:FlowSchema 与优先级
12.212.2 APF 队列与公平性
12.312.3 令牌桶限流与配额预算

第 13 章 API 扩展:聚合层与 CRD

节文章
13.113.1 聚合层:apiserver 的扩展点
13.213.2 CRD 与多版本转换
13.313.3 API 发现与扩展路径选型

第 14 章 控制面高可用与故障切换

节文章
14.114.1 多副本控制面架构
14.214.2 租约续约与防双主
14.314.3 故障切换与恢复

第 15 章 数据面视角与最终一致

节文章
15.115.1 从数据面回看控制面
15.215.2 整条链的最终一致:从写请求到全站收敛
15.315.3 全书收束:控制面与调谐循环

相关阅读

全部文章 Books game Java Indie golang 客户端开发 Minigame Saas rust Python
books

《Kubernetes 分布式系统原理深入解析》9.2 volumeClaimTemplates 与有序扩缩

有状态应用的存储是『一 Pod 一卷』:StatefulSet 的 volumeClaimTemplates 为每个 Pod 生成独立的 PVC,Pod 序号与卷一一对应。扩缩容因此有了存储语义——扩容要为新 Pod 申请卷,缩容后卷默认保留(可回收)。本节解剖 volumeClaimTemplates 与有序扩缩容的联动。lab 用 statefulset 验证序控制下的扩缩容路径。

5 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》9.1 有序创建/删除与稳定标识

StatefulSet 与 Deployment 的本质区别是序:Pod 名字带稳定序号、创建严格升序(前驱就绪才创建下一个)、删除严格降序(先删最大序号)。这套序控制是为了满足有状态应用的依赖:从库要等主库就绪、先启动的 Pod 承担更前的位置。本节解剖序控制算法与稳定标识的语义。lab 用 controller/statefulset.go 验证有序创建与删除。

6 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》8.3 回滚、暂停与进度卡住诊断

滚动更新的另一半故事是失败处理:版本起不来怎么办、怎么回滚、怎么暂停、怎么判断『卡住了』。本节拆解 Deployment 的 revision 历史与回滚机制、rollout pause/resume 的语义、progressDeadlineSeconds 的卡住判定,以及一套诊断步骤。lab 用 deploy.go 验证滚动对可用性下限的保持。

6 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》8.2 滚动/重建策略矩阵

Deployment 更新版本时怎么切,由 strategy 决定:Recreate 是一次性删光再建,RollingUpdate 是逐批替换。RollingUpdate 内部的 maxSurge 与 maxUnavailable 组合出一张策略矩阵——『宁可超配』与『宁可欠配』的连续权衡。本节给出这张矩阵与选型判据。lab 用 deploy.go 验证不同参数组合下的滚动行为。

6 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》8.1 Deployment→RS→Pod 链式调谐

Deployment 不是直接管 Pod,而是管 ReplicaSet,RS 再管 Pod——三层对象构成链式调谐。每一层都用自己的控制器、自己的期望与实际,上一层的期望是下一层的现实输入。本节解剖这条链:层次职责、事件如何逐层传播、中间态如何逐层收敛。lab 用 replicaset 与 deploy 验证链上每层的调谐。

7 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》7.3 扩缩容的分布式语义

扩缩容在单机上是一条命令,在分布式系统里是一串异步事件:创建 Pod 要经过调度与启动,删除 Pod 要经过优雅终止,多控制器并发扩缩容要靠乐观锁保证一致。本节拆解扩缩容的分布式语义——动作异步、中间态可见、并发靠版本协调——并说明为什么『缩容后副本数立刻变少』是错误预期。lab 用 replicaset 验证扩缩容收敛路径。

7 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》7.2 滚动更新引擎:surge 与 maxUnavailable

Deployment 的滚动更新不是『删光旧的再建新的』,而是用 surge 与 maxUnavailable 两个参数把每轮动作限定在安全范围内:总副本不超 desired+surge,可用副本不低于 desired-maxUnavailable。本节解剖滚动更新引擎的每轮决策算法,并解释『有超调的收敛』为什么是受控的。lab 用 controller/deploy.go 验证 surge 与可用性约束。

5 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》7.1 ReplicaSet 调谐算法:期望 vs 实际副本

ReplicaSet 控制器是最简洁的负反馈系统:spec.replicas 是期望,实际 Pod 数是现实,差异驱动创建与删除。本节解剖它的调谐算法——补建、缩容、优先删未就绪、就绪判定——并说明为什么『数量对上』不等于『收敛完成』。lab 用 controller/replicaset.go 验证扩缩容算法的每一分支。

5 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》6.3 控制器如何防止打爆 API Server

一个集群里有几十个控制器,每个每秒调谐数千个对象;若没有节流,它们会合起来打爆 apiserver。本节分析控制器的读放大、写放大与失败风暴三种放大路径,以及对应的节流机制:informer 缓存、workqueue 退避、relist 退避、并发上限。这是『系统内的重试必须自我节流』原则的控制器侧实现。lab 用 workqueue 验证退避与重试上限。

7 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》6.2 reconcile 幂等与状态转换

reconcile 是控制器的单轮调谐:读取现实、计算差异、发出修正动作。它的正确性核心是幂等——同一现实输入反复执行,输出不变。本节拆解 reconcile 的结构、幂等为什么是『从现实出发』的自然结果、以及状态转换如何用幂等构建(中途失败可恢复)。lab 用 controller/reconcile.go 验证幂等与负反馈收敛。

6 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》6.1 workqueue:去重、重试与退避

控制器收到的事件不能直接当命令执行:它们只是『这个 key 需要看一眼』的信号,且同一个 key 可能瞬间来多次事件。workqueue 负责把事件信号转化成可重试、可去重、有限速的工作队列。本节拆解 workqueue 的四个核心语义:去重、延迟入队、指数退避重试与放弃阈值,并对照 client-go 的真实实现。lab 用 workqueue/workqueue.go 验证去重、退避序列与重试上限。

5 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》5.3 声明式 vs 命令式的设计取舍

声明式与命令式是两种系统设计哲学:命令式描述『怎么做』,声明式描述『要什么』。本节对比两者的心智模型、故障行为与适用场景,分析 K8s 为什么选择声明式(自动恢复、幂等重试、可审计),以及声明式的代价(调试困难、行为不透明、需要控制器)。lab 用 controller/reconcile.go 演示声明式的幂等恢复能力。

6 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》5.2 控制器即负反馈系统:收敛与震荡

负反馈系统会收敛,也可能震荡。本节从控制理论借来『增益、延迟、超调、振荡』的概念,分析 K8s 控制器何时收敛干净、何时抖动:缓存滞后造成测量延迟、执行器过激造成超调、多个控制器互相干扰造成振荡。结合 HPA 的稳定窗口与 Deploy 的滚动节奏,给出抑制振荡的设计原则。lab 用 controller/reconcile.go 验证比例控制律的收敛行为。

6 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》5.1 desired/current 与负反馈

声明式 API 的核心是『期望状态 vs 实际状态』:用户在 spec 里声明期望,控制器持续对比期望与现实,把差异化为修正动作。这与控制理论里的负反馈(参考值-测量值-误差-矫正)是同构的。本节建立『控制器即负反馈系统』的模型,给出控制器循环的五个要素。lab 用 controller/reconcile.go 验证负反馈收敛。

6 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》4.3 多副本 controller-manager 如何防双主与收敛

controller-manager 部署 2 个副本,但只有 leader 运行全部控制器。本节把选主从『库』拉到『组件』层面:两个 controller-manager 进程如何争同一个 Lease、leader 挂后 standby 如何接管、多副本下控制器的收敛路径是什么。lab 用 leaderelection/le.go 验证 3 副本竞争下的单活与故障转移。

8 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》4.2 Leader Election 客户端库原理

K8s 把选主逻辑封装成客户端库 leaderelection,组件只需提供 Lease 名称、候选者身份与『成为/失去领导权』回调。本节拆解库的状态机:TryAcquire 尝试夺取、Renew 续约、ObservedRecord 记录最新 holder、LeaderCallbacks 回调触发,以及防双主的乐观锁保障。lab 用 leaderelection/le.go 验证库的三态流程。

6 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》4.1 Lease 资源与续约

K8s 用 coordination.k8s.io 的 Lease 资源实现选主与心跳:Lease 记录 holder、acquireTime、renewTime 与 leaseDurationSeconds。候选人续约是在租期内刷新 renewTime,过期意味着 holder 失联,可被接管。本节拆解 Lease 对象的字段、续约协议与过期判定。lab 用 leaderelection/le.go 验证续约保活与过期接管。

6 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》3.3 缓存滞后、relist 退避与一致性边界

informer 缓存是异步维护的,必然滞后于 etcd;watch 连接断开时 informer 会重新 list 全量,并用指数退避防止打爆 apiserver。本节精确刻画『缓存有多滞后、滞后怎么产生、怎么消除』以及 relist 退避的边界条件。lab 用 informer/reflector.go 验证缓存滞后到追赶的过程与退避序列。

7 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》3.2 Reflector、DeltaFIFO 与 Indexer

client-go 的 informer 内部由三个协作组件构成:Reflector 负责 list-watch 网络交互,DeltaFIFO 负责把增量去重、合并、排队,Indexer 负责把对象建成可检索的本地缓存。本节逐层拆解三者的职责边界、协作时序,以及 DeltaFIFO 的去重合并规则为什么能防重复处理。lab 用 informer/fifo.go 与 indexer.go 验证去重合并与索引。

8 分钟阅读
书稿 Kubernetes 分布式系统
books

《Kubernetes 分布式系统原理深入解析》3.1 list-watch 原语与增量同步

控制器订阅 apiserver 用的是一个原语:list-watch。先 List 拿全量快照与 resourceVersion,再 Watch 从该版本续增量事件;两者合起来保证『不漏、不重、不错』地维护本地缓存。本节拆解这个原语的协议、它为何用版本续接而非时间续接,以及它对缓存一致性的意义。lab 用 informer/source.go 与 reflector.go 验证 List 全量 + Watch 增量的同步。

7 分钟阅读
书稿 Kubernetes 分布式系统