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 分布式系统原理深入解析·控制面与调谐循环》目录与学习路径

《Kubernetes 分布式系统原理深入解析·控制面与调谐循环》的目录与学习路径:45 篇逐节索引、三条阅读路线、十五章依赖关系,以及本卷与站内《游戏服务端架构》《MMO 服务器开发》《后端架构设计》的分工边界;每节配一个可运行的 Go 最小验证,正文以 K8s 控制面为对象讲解「从声明到收敛」的分布式系统机制。

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

《Kubernetes 分布式系统原理深入解析》15.3 全书收束:控制面与调谐循环

卷二《控制面与调谐循环》到这里收束。把 45 节内容浓缩成三个认识:声明式对象是基石、控制器是引擎、分布式机制是护栏。控制面不是一堆组件的堆砌,而是一个『从声明到收敛』的自洽系统。本节回顾全书主线,并给出继续深入的方向。lab 用全包测试作为卷二验证的最终门禁。

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

《Kubernetes 分布式系统原理深入解析》15.2 整条链的最终一致:从写请求到全站收敛

卷二拆过的每个机制——乐观锁、watch、缓存、workqueue、调谐、准入、APF、选主——都不是孤立的,它们串成一条『写请求到全站收敛』的链路。本节把整条链拼起来看:一次写请求如何经准入、存储、watch、缓存、队列、调谐、再写,最终让全站到达期望状态。每个环节的一致性是链能收敛的前提。lab 用 api 包验证链首的一致性语义。

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

《Kubernetes 分布式系统原理深入解析》15.1 从数据面回看控制面

数据面(Pod、kubelet、网络)不关心控制面怎么调谐,它只消费一个产物:写入 apiserver 的对象。本节从数据面的视角回看控制面——数据面看到的是『对象』而非『控制器』:Pod 的 spec/status 是数据面与控制器之间唯一的接口。lab 用 api 包验证对象模型的版本语义作为接口的稳定性基础。

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

《Kubernetes 分布式系统原理深入解析》14.3 故障切换与恢复

控制面的故障不只在 leader 崩溃:apiserver 挂了怎么办、etcd 少数派怎么办、切换后控制器怎么继续调谐。本节解剖故障切换的完整路径——detect(发现租约过期)、takeover(接管)、recover(从缓存继续)、以及各组件故障的恢复语义。核心是幂等:接管者从现实出发重新调谐,不需要前任的记忆。lab 用 leaderelection 验证崩溃接管与恢复。

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

《Kubernetes 分布式系统原理深入解析》14.2 租约续约与防双主

选主的正确性细节在续约与接管之间:leader 周期续约(Renew)把租约保持不过期,非 leader 只在租约过期后尝试接管(TryAcquire),接管成功后还要『只有 holder 能续约』防双主。本节解剖 Lease 的续约语义、防双主的两个机制与故障场景。lab 用 leaderelection 包验证续约保活、接管条件与防双主。

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

《Kubernetes 分布式系统原理深入解析》14.1 多副本控制面架构

生产集群的控制面不是单副本,而是多副本高可用:多个 apiserver 无状态地共享 etcd,多个 controller-manager 靠选主(leader election)保证同一时刻只有一个活跃领导。本节解剖控制面的高可用架构——什么组件能多副本、什么不能、为什么 controller-manager 要选主而 apiserver 不用。lab 用 leaderelection 包验证多副本收敛与防双主。

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

《Kubernetes 分布式系统原理深入解析》13.3 API 发现与扩展路径选型

客户端怎么知道集群有哪些 API?靠发现机制(discovery):/apis 目录列出版本与资源,kubectl 与客户端据此构建请求。发现机制把核心资源、聚合层服务、CRD 全部汇入同一目录。扩展 API 有两条路径——聚合层(挂服务)与 CRD(声明资源)——本节给选型判据与发现机制的原理。lab 用 api 包验证统一存储的版本语义作为选型基础。

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

《Kubernetes 分布式系统原理深入解析》13.2 CRD 与多版本转换

比聚合层更简单的扩展路径是 CRD(CustomResourceDefinition):只写 YAML 声明一个资源类型,apiserver 就提供完整的 REST 端点。CRD 的多版本是关键语义:一个 storage version 落盘 etcd,多个 served version 对外可见,版本间用转换函数互转。本节解剖 CRD 的存储/服务版本模型与版本转换。lab 用 api/crd.go 验证 v1alpha1 与 v1 的转换。

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

《Kubernetes 分布式系统原理深入解析》13.1 聚合层:apiserver 的扩展点

K8s 的核心 apiserver 不能什么都做,也不该什么都做。聚合层(kube-aggregator)把第三方 API 服务挂进统一的 API 入口:客户端从同一个 /apis 访问核心资源与扩展资源,聚合层做路由、鉴权委托与发现聚合。本节解剖聚合层的架构与『核心 + 扩展共享一条入口』的设计。lab 用 api 包的 store/crd 验证统一存储的版本语义。

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

《Kubernetes 分布式系统原理深入解析》12.3 令牌桶限流与配额预算

配额的落地机制是令牌桶:优先级每秒获得一定令牌,每个请求消费一个令牌;令牌随时间匀速补充、有上限。令牌桶既能限『平均速率』(每秒预算),又能容忍『突发』(桶内积攒的令牌一次用掉)。本节解剖令牌桶算法、突发容忍的意义与配额预算的配置。lab 用 admission/apf.go 验证预算内放行、超预算排队。

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

《Kubernetes 分布式系统原理深入解析》12.2 APF 队列与公平性

APF 的公平不止于优先级之间,还包括优先级内部的队列语义:请求超配额时进入 FIFO 队列等待,队列保证同一优先级内的先到先服务。配额耗尽时高优先级也排队,但不被低优先级饥饿。本节解剖 APF 的队列模型、出队顺序与公平性的两层含义——优先级间公平、优先级内公平。lab 用 admission/apf.go 验证高优先级优先与队内 FIFO。

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

《Kubernetes 分布式系统原理深入解析》12.1 APF:FlowSchema 与优先级

第 6 章讲控制器自我节流,第 12 章讲服务端限流:APF(API Priority and Fairness)保护 apiserver 不被超载。APF 先把请求按 FlowSchema 归入优先级(PriorityLevel),再按优先级分配配额——高优先级(如 kube-controller-manager 的系统请求)不被低优先级(如非列表请求)饥饿。本节解剖 FlowSchema 分流与优先级分配。lab 用 admission/apf.go 验证高优先级优先放行。

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

《Kubernetes 分布式系统原理深入解析》11.3 webhook 排序、作用域与准入链可扩展性

生产集群的准入链不止一两个 webhook:sidecar 注入、安全校验、资源限制可能来自不同团队。webhook 的排序(mutating 顺序影响结果)、作用域(namespaceSelector、matchPolicy)与多条 webhook 的共存,决定准入链能否扩展。本节解剖 webhook 排序的后果、作用域选择与链的可扩展性设计。lab 用 admission/admission.go 验证链式顺序与幂等。

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

《Kubernetes 分布式系统原理深入解析》11.2 failurePolicy 与 webhook 幂等

webhook 是外部服务,会超时、会挂。准入链对 webhook 故障的策略由 failurePolicy 决定:Ignore 是故障不阻塞(请求继续),Fail 是故障拒绝请求。两者各有一份代价。webhook 还必须幂等——被反复调用不能产生重复效果(如 sidecar 注入只注入一次)。本节解剖 failurePolicy 的权衡与 webhook 幂等的必要性。lab 用 admission/admission.go 验证两种策略与幂等注解。

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

《Kubernetes 分布式系统原理深入解析》11.1 准入链:写请求的必经关卡

写请求进入 apiserver 后、落盘 etcd 前,要经过准入链(Admission Chain):Mutating webhook 先改对象(加默认值、注入 sidecar),Validating webhook 后校验(拒绝非法请求)。任一 validating 拒绝则整体拒绝,apiserver 不会执行后续步骤。本节解剖准入链的位置、顺序与拒绝语义。lab 用 admission/admission.go 验证 mutating 先于 validating、拒绝即整体拒绝。

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

《Kubernetes 分布式系统原理深入解析》10.3 CronJob 漏执行与重叠

CronJob 在 Job 之上加了一层『按 cron 表达式定时创建 Job』。定时系统最麻烦的两个问题是漏执行与重叠:控制面停机时错过的调度点怎么补、上一个还没跑完时下一个该不该开。本节解剖 CronJob 的调度语义、Forbid/Allow/Replace 三种并发策略、以及错过执行的补偿。lab 用 controller/job.go 的 CronJob 验证 Forbid 重叠策略。

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

《Kubernetes 分布式系统原理深入解析》10.2 失败与 backoffLimit

Job 的任务不总是一次成功:容器崩溃、退出码非 0、被驱逐——都会计入失败。Job 用 backoffLimit 控制『最多容忍多少次失败』:未超限则重试,超限则整个 Job 判 Failed。本节解剖失败计数、backoffLimit 的语义、以及失败与完成的竞态。lab 用 controller/job.go 验证 backoffLimit 的判定路径。

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

《Kubernetes 分布式系统原理深入解析》10.1 完成语义:completions/parallelism

Job 与前面的控制器都不一样:它不为『保持副本数』,而为『把一批任务做完』。spec.completions 定义总目标、spec.parallelism 定义并发上限,控制器在『还差多少』与『并发多少』之间做决策。本节解剖 Job 的完成语义:NeedNew 的判定、并发窗口、成功计数与完成条件的判定。lab 用 controller/job.go 验证完成语义。

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

《Kubernetes 分布式系统原理深入解析》9.3 Quorum 类应用的有状态表达

有状态应用里有一类最麻烦:需要法定人数(Quorum)才能工作的系统,如 etcd、ZooKeeper、Raft 集群。它们对『几号节点、谁在主谁在从、节点数是否为奇数』有硬性要求。本节分类有状态应用,聚焦 Quorum 类应用在 StatefulSet 上的表达:稳定标识满足寻址、有序创建满足启动依赖、独立卷满足数据独立。lab 用 statefulset 验证这套表达。

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