这篇不是逐行源码分析，而是一份阅读导览：按 Kubernetes v1.37 的架构，说明核心组件从入口到落地的大致路径，方便结合官方文档和源码定位问题。

代码仓库与目录

Kubernetes 主仓库：https://github.com/kubernetes/kubernetes

常用目录：

目录	内容
`cmd/`	各组件入口：kube-apiserver、kube-scheduler、kubelet、kube-proxy 等
`pkg/`	核心实现：api、controller、scheduler、kubelet、proxy
`staging/src/k8s.io/`	对外发布的库：client-go、apimachinery、api、cri-api、csi-translation-lib
`plugin/`	准入插件、认证插件（`plugin/pkg/admission`、`plugin/pkg/auth`）
`pkg/scheduler/framework/plugins/`	调度插件
`test/`	集成测试、e2e 测试

阅读源码前先看官方 Components 和 API 概念，否则容易陷进细节。

apiserver 请求链路

大致路径：

HTTP/gRPC 请求
  → 认证（x509 / token / OIDC / webhook）
  → 鉴权（RBAC / Node / Webhook）
  → 解码与默认值
  → Mutating 准入
  → Validating 准入（含 PSA / VAP）
  → 对象校验
  → 写入 etcd
  → watch 事件通知

对应入口在 cmd/kube-apiserver，请求处理在 staging/src/k8s.io/apiserver。重点看：

认证链和鉴权链如何组合
admission chain 的顺序
registry 如何把 API 对象映射到 etcd 存储
watch cache 如何加速 list/watch

排障价值：401 看认证；403 看鉴权或 Admission Forbidden；400 常见于 webhook 拒绝或请求格式错误；422 常见于 schema validation；409 看冲突。

控制器与 informer

控制器模式：

watch → 事件入队 → 取出对象 → 比较期望/实际 → 执行动作 → 更新 status

client-go 提供 Informer/Workqueue；controller-runtime 在其上提供 Reconcile、Manager、Builder：

Informer：本地缓存 + watch，减少对 apiserver 的请求
Workqueue：去重、限速、重试
Reconcile：controller-runtime 的概念，把实际状态推向期望状态

阅读 client-go/tools/cache 和 client-go/util/workqueue，再看一个具体控制器，例如 Deployment 控制器，理解 level-triggered 而不是 edge-triggered 的设计。

调度器

调度器入口在 cmd/kube-scheduler，核心在 pkg/scheduler：

队列侧：QueueSort / PreEnqueue
调度周期：PreFilter → Filter → PostFilter → PreScore → Score → Reserve → Permit → PreBind
绑定周期：Bind → PostBind

PostFilter 只在没有可行节点时调用（例如抢占）。

重点：

Scheduler Framework 的扩展点
插件如何注册和排序
缓存（snapshot）如何避免每次全量查询
抢占和 Pending Pod 的处理

对应官方文档：Scheduling Framework。

kubelet 与 CRI

kubelet 入口在 cmd/kubelet：

watch Pod → 同步 Pod → 创建 sandbox → 拉镜像 → 启动容器 → 探针 → 状态上报

重点：

PodConfig 如何合并静态 Pod、API Pod、file source
CRI 接口如何调用 containerd/CRI-O
探针和重启策略
卷挂载与 CSI
节点状态和驱逐

对应官方文档：kubelet、CRI。

网络与存储扩展点

CNI：容器运行时在创建/删除 Pod sandbox 时调用 CNI 插件，kubelet 通过 CRI 间接触发
CSI：kubelet 调用 CSI 驱动挂载卷；controller 侧由 external-provisioner/attacher/resizer 等负责
CRI：容器运行时接口
Device Plugin：GPU/FPGA 等设备扩展

这些扩展点让 Kubernetes 核心保持稳定，把厂商实现放到外部进程。

Kubernetes源码简析

代码仓库与目录

apiserver 请求链路

控制器与 informer

调度器

kubelet 与 CRI

网络与存储扩展点

推荐阅读顺序

官方参考