kube-apiserver / Kubernetes 控制面内核：storage、cacher、Admission 与 APF
内容提要
本文介绍kube-apiserver生产内核系列，聚焦控制面故障排障，以Storage/Watch/Admission/Auth/APF五轴为坐标系，规划16篇阅读路线。内容涵盖请求路径、watch cache、resourceVersion、Webhook、APF等机制，版本锚定Kubernetes v1.30.3，旨在帮助SRE归因504、410等错误，区分直连etcd与apiserver排障边界。
延伸解读
五轴坐标系的价值
本文提出的 Storage/Watch/Admission/Auth/APF 五轴坐标系，为控制面故障排障提供了结构化框架。相比直接查看 etcd 或 apiserver 日志，五轴帮助 SRE 快速定位问题层级，例如 504 可能源于 APF 排队或 etcd 延迟，410 可能源于 cacher 或 etcd compaction。这种分层思维能减少排查盲区，提升效率。
版本锚定的重要性
系列明确锚定 Kubernetes v1.30.3 和 etcd v3.5.33，强调机制结论基于特定源码版本，而非最新文档。这提醒读者在排障或学习时，需注意版本差异，避免因 API 或行为变化导致误判。对于生产环境，版本匹配是准确归因的前提。
排障边界：何时查 etcd，何时查 apiserver
文章强调并非所有问题都应直连 etcd 排查，而是根据症状判断层级。例如，仅 apiserver 连接 etcd 时，etcd/13 足够；若需区分 storage、cacher、admission 等，则需深入本系列。这种边界划分有助于避免无效排查，合理分配资源。
Q&A
kube-apiserver 生产内核系列主要解决什么问题？
该系列旨在帮助 SRE 将 apiserver 504、controller 不同步等问题归因到 Storage、Watch、Admission、Auth、APF 五个轴，并区分直连 etcd 与 apiserver 排障的边界。
kube-apiserver 生产内核系列覆盖哪些核心机制？
覆盖请求路径、storage.Interface 与 etcd3、resourceVersion 与 bookmark、watch cache/cacher、List/Pagination、Watch 服务端路径、Admission/Webhook、AuthN/AuthZ/Audit、APF、CRD/aggregation 边界、运维升级、排障五轴以及相对直连 etcd/Kine 的选型。
kube-apiserver 生产内核系列版本锚定是什么？
版本锚定 Kubernetes v1.30.3（源码 tag v1.30.3），etcd 后端对照锚定 etcd v3.5.33。
kube-apiserver 生产内核系列适合哪些读者？
适合平台/SRE 人员，希望将 apiserver 504、controller 不同步等问题归因到五轴；也适合读过 etcd 系列、需要 apiserver 侧机制全书的读者，以及需要在原生 etcd、Kine、events 分集群之间做控制面架构选型的架构师。
kube-apiserver 生产内核系列与 etcd 系列的分工是什么？
etcd 系列聚焦持久化层五轴（Raft、MVCC、Watch 等），而本系列聚焦 apiserver 生产内核，覆盖 storage→cacher→admission→APF 链路，并处理 504、410、webhook 慢、APF 排队等问题的归因。
kube-apiserver 生产内核系列推荐的核心阅读路径是什么？
快速建立五轴和 504 归因的必读路径是 1 → 3 → 5 → 12 → 15；apiserver 超时分列路径是 1 → 5 → 9 → 12 → 15；读写与 Watch 路径是 4 → 6 → 7 → 15；安全与准入路径是 8 → 10 → 11；完整通读则按 1 到 16 顺序。
kube-apiserver 生产内核系列中排障五轴指的是什么？
排障五轴指 Storage、Watch、Admission、Auth、APF，用于对 apiserver 相关症状（如 504、410、401、403、webhook 超时、List 风暴、OOM）进行归因。
kube-apiserver 生产内核系列中如何区分 504 是 APF 排队还是 etcd 问题？
通过五轴排障，结合 apiserver_request_duration_seconds 等 metrics 和决策树，判断 504 是 APF 排队还是 etcd 的 ReadIndex 等问题，必要时穿透到 etcd 系列排查。
