11.3 webhook 排序、作用域与准入链可扩展性
真实集群的准入链远不止一个 webhook:sidecar 注入、安全校验、资源限制来自不同团队,注册到同一条链上。本节解剖这条链的排序、作用域与可扩展性——三个让「一条准入链承载多团队策略」成为可能的设计。
mutating 的排序:顺序就是语义
多个 mutating webhook 都改对象时,执行顺序影响最终结果:
A:加 label team=frontend
B:要求必须有 team label 才注入 sidecar
顺序 A→B:B 看到 team,注入成功
顺序 B→A:B 没看到 team,不注入
mutating 的顺序不是无关紧要的——每个 mutating 的输出是下一个的输入。排序规则(K8s 用 name 排序,稳定可预期):
- 同一对象上,mutating 按固定顺序执行(对同一集群稳定)。
- 后执行的 mutating 能看到前一个的修改。
- validating 永远最后——它校验的是「所有 mutating 完成后的最终对象」(11.1 节)。
为什么排序必须稳定:准入链是写路径的一部分,行为必须可预测。如果 webhook 每次执行顺序都变,同一个对象可能「有时带 sidecar、有时不带」——这正是 5.2 节「确定性」原则在准入链的体现。
lab 的 Chain 按 Hooks 切片顺序执行,正是「注册顺序 = 执行顺序」的忠实模型——测试 TestMutatingThenValidating 验证了 mutating 在 validating 之前的固定顺序。
作用域:只影响「该管」的对象
不是所有 webhook 都该管所有对象。作用域选择让 webhook 聚焦:
| 作用域机制 | 控制什么 |
|---|---|
namespaceSelector | 只处理带匹配 label 的 namespace 中的对象 |
objectSelector | 只处理带匹配 label 的对象 |
matchPolicy | 匹配请求的类型(Exact:完全匹配 / Equivalent:等效资源也匹配) |
作用域的价值:
- 隔离多租户策略:sidecar 注入只对特定 namespace 生效,不影响其他业务。
- 减少调用量:无关对象不触发 webhook——少一次外部调用、少一分故障面(11.2 节)。
- 团队自治:不同团队在自己的 namespace 上配自己的 webhook,互不干扰。
作用域是「准入链的租户隔离」:没有它,所有 webhook 对所有对象生效——多团队共享一条链必然互相踩脚。有了它,链是共享的,策略是分区的。
多 webhook 的共存:一条链,多方注册
生产准入链通常是「多方注册、一条链执行」:
团队 A 的 sidecar 注入(mutating)
团队 B 的安全校验(validating, Fail)
团队 C 的资源限额(validating, Ignore)
共存的前提,在 11.1/11.2 节的语义上再加两条:
- 顺序可预期:按稳定排序执行,互不猜疑。
- 故障有策略:每个 webhook 自己的 failurePolicy 决定自己挂了对谁有影响。
- 作用域隔离:只管自己该管的,不误伤他人。
准入链的扩展模型是「叠加」而非「替换」:新策略注册上去即生效,不需要改链上其他 webhook。这比「写路径上写死一段校验逻辑」可扩展得多——准入链是一个插件式的策略层,webhook 就是插件。
为什么 webhook 比「内置校验」更适合多团队
对比两种「写路径把关」的实现:
| 方式 | 变更成本 | 隔离性 |
|---|---|---|
| 内置在 apiserver 代码里 | 改代码、升级、全量生效 | 无 |
| 外部 webhook | 单独部署、热注册 | 有(作用域) |
webhook 的选择是「把策略外置」:
- 策略变更不碰 apiserver:webhook 升级只动它自己的服务。
- 策略可独立于核心演进:新治理需求(如新的安全标准)不用等 apiserver 发版。
- 策略可动态启停:注册/反注册 webhook 配置即可,无需重启写路径。
代价是分布式的(11.2 节):webhook 是外部依赖,要处理超时、故障、幂等。准入链把「治理能力外置」的收益与「外部依赖」的成本打包出售——生产上接受这个交易,因为治理需求变化快于核心发版。
扩展准入链的工程实践
给运维一个可操作的检查清单:
| 步骤 | 检查 |
|---|---|
| 注册前 | 明确 mutating 还是 validating、failurePolicy 选对 |
| 注册时 | 配好作用域(namespaceSelector/objectSelector) |
| 上线后 | 监控 webhook 延迟与失败率(故障面) |
| 出问题时 | 确认是「拒错了」(策略问题)还是「挂了」(故障) |
准入链出问题的诊断主线(呼应 8.3 节方法论):先确认是哪个 webhook 在拒绝/故障,再看它的策略与作用域。webhook 数量多了以后,「谁拦的」是第一步,kubectl describe 的准入事件会直接告诉你是哪个 hook 写的拒绝原因。
内置准入控制器 vs webhook
准入链里除了外部 webhook,还有内置准入控制器(built-in admission controllers)——它们是 apiserver 代码里的策略:
| 类型 | 例子 | 部署 |
|---|---|---|
| 内置准入控制器 | NamespaceLifecycle、ResourceQuota、LimitRanger | 编译进 apiserver,开关启用 |
| 外部 webhook | 团队自定义的策略 | 独立服务,注册进链 |
两者的分工:
| 维度 | 内置 | webhook |
|---|---|---|
| 更新方式 | 升级 apiserver | 单独部署 |
| 灵活性 | 固定逻辑 | 完全自由 |
| 优先级 | 部分在 webhook 前 | 链上执行 |
| 典型用途 | 平台级(配额、命名空间生命周期) | 业务级(注入、校验) |
内置控制器管「平台级策略」,webhook 管「业务级策略」:配额、生命周期这类「所有集群都要有」的用内置;sidecar 注入、业务校验这类「团队自己定」的用 webhook。两类合起来构成完整的准入链——内置打底,webhook 扩展。
链的执行顺序:内置与 webhook 怎么排
准入链的完整顺序不是「webhook 一条链」那么简单,内置控制器也在链上:
内置(NamespaceLifecycle、配额...)
→ MutatingWebhook(业务注入)
→ 内置(配额校验等)
→ ValidatingWebhook(业务校验)
真实 K8s 的准入链有固定的阶段顺序:
- AdmissionChain 先跑内置 mutating 类(如默认值)。
- Webhook mutating 在中间(11.1 节说「mutating 先」指 webhook 内部顺序)。
- Webhook validating 后跑。
- 内置 validating 类(配额检查)兜底。
内置与 webhook 的穿插顺序也是「先改后验」的全局版本:所有改的(内置+webhook)在前,所有验的(webhook+内置)在后。理解这个全序,才能回答「某个内置控制器为什么先于我注册的 webhook 执行」——不是谁的优先级高,是阶段顺序定了。
作用域的第三维:作用于哪些资源
namespaceSelector/objectSelector 管「哪些对象」;webhook 配置里还有一维——作用于哪些资源:
| 配置 | 控制什么 |
|---|---|
resources | 只匹配列出的资源(pods、deployments、customres) |
operations | 只匹配列出的操作(CREATE/UPDATE/DELETE) |
scope | Namespaced / Cluster-scoped / All(对象的作用域) |
示例:一个「只拦 Pod 的 CREATE」的 webhook:
rules:
- operations: ["CREATE"]
apiGroups: [""]
apiResources: ["pods"]
scope: "Namespaced"
作用域是「准入链的聚焦三件套」:按命名空间聚焦(namespaceSelector)、按对象聚焦(objectSelector)、按资源聚焦(rules)——每一维都让 webhook 只管「该管的一小块」。多团队共享链时,这三件套是「互不踩脚」的全部工具。
三个常见误解
- 「webhook 顺序无所谓」——错误。mutating 的顺序就是语义,输出是下一个的输入,顺序必须稳定可预期。
- 「所有 webhook 对所有对象生效」——错误。namespaceSelector/objectSelector 让 webhook 只影响指定范围。
- 「准入链只能内置」——错误。webhook 把策略外置,让多团队可以独立注册、独立演进策略。
本节 lab
本节验证准入链的顺序语义(扩展性的基础):
cd private/labs/k8s-ctrl-lab
go test ./admission -run 'TestMutatingThenValidating|TestWebhookIdempotent' -v
TestMutatingThenValidating:mutating 的输出作为 validating 的输入——「顺序即语义」的链式执行。TestWebhookIdempotent:重复调用不重复注入——「可扩展性」要求每个 webhook 重复无害。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。