08.6.4 准入控制(Validating/Mutating Webhook)
所属:全栈开发面试题库 / 08 云原生与 DevOps / 08.6 Helm 与 Operator
覆盖范围
- 准入控制在 API 请求生命周期中的位置
- MutatingWebhook 与 ValidatingWebhook 的区别
- webhook 配置、规则匹配、超时
- 常见 webhook 场景(证书注入、镜像校验、标签注入)
- 故障处理与 webhook 高可用
高频题速览
| 编号 | 题目 | 难度 | 频率 |
|---|---|---|---|
| 08.6.4-001 | 准入控制在 K8s API 请求链路中处于什么位置? | 进阶 | ★★★★★ |
| 08.6.4-002 | Mutating 与 Validating Webhook 有什么区别? | 基础 | ★★★★★ |
| 08.6.4-003 | Webhook 如何匹配要拦截的资源? | 进阶 | ★★★★ |
| 08.6.4-004 | Webhook 如何注入 sidecar(如 Istio/Linkerd)? | 进阶 | ★★★★ |
| 08.6.4-005 | Webhook 服务故障会怎样? | 进阶 | ★★★★ |
| 08.6.4-006 | Webhook 的 timeout 与 failurePolicy 怎么配? | 进阶 | ★★★★ |
| 08.6.4-007 | 为什么 webhook 必须用 HTTPS? | 基础 | ★★★ |
| 08.6.4-008 | 常见准入控制场景有哪些? | 基础 | ★★★★ |
| 08.6.4-009 | Kyverno 与 OPA Gatekeeper 有什么区别? | 进阶 | ★★★ |
| 08.6.4-010 | Webhook 如何避免循环调用? | 高级 | ★★★ |
08.6.4-001 准入控制在 K8s API 请求链路中处于什么位置?
一句话结论
API 请求链路:认证(Authentication)-> 授权(Authorization)-> 准入控制(Admission)-> 写入 etcd;准入控制在写入 etcd 之前,能修改或拒绝请求。
概念解释
- Authentication:验证用户身份。
- Authorization:验证用户权限(RBAC)。
- Mutating Admission:修改请求。
- Validating Admission:验证请求是否合法。
- 最后写入 etcd。
原理流程
- 请求到达 apiserver。
- Authentication 验证 token。
- Authorization(RBAC)判断权限。
- Mutating webhook 修改对象。
- Validating webhook 校验对象。
- 通过则写入 etcd。
代码 / 示例
请求 -> Authn -> Authz -> Mutating -> Validating -> etcd
常见误区
- 误区:准入控制在 RBAC 之前;正解:先认证授权,再准入控制,准入控制是最后一道防线。
- 误区:Validating 能修改对象;正解:Validating 只读不写,修改用 Mutating。
追问
- Q:Mutating 与 Validating 谁先执行? A:Mutating 先执行,再 Validating;Mutating 修改后的对象再被校验。
- Q:准入控制能拒绝哪些操作? A:create/update/delete/connect(port-forward/exec),通过 rules 配置。
08.6.4-002 Mutating 与 Validating Webhook 有什么区别?
一句话结论
Mutating Webhook 可以修改请求对象(如注入 sidecar、加标签),Validating Webhook 只能校验并拒绝非法请求,不能修改。
概念解释
- Mutating:返回 patched 对象,apiserver 应用 patch 后再继续。
- Validating:返回 allow/deny,不修改对象。
- 顺序:所有 Mutating 先跑,再跑 Validating。
原理流程
- Mutating webhook 收到对象,返回 JSON patch。
- apiserver 应用 patch。
- Validating webhook 收到修改后的对象,返回 allow/deny。
- deny 则整个请求被拒绝。
代码 / 示例
# MutatingWebhookConfiguration 示例
apiVersion: admissionregistration.k8s.io/v1
kind: MutatingWebhookConfiguration
metadata:
name: sidecar-injector
webhooks:
- name: sidecar.example.com
clientConfig:
service:
name: sidecar-webhook
namespace: kube-system
path: "/mutate"
rules:
- operations: ["CREATE"]
apiGroups: [""]
apiVersions: ["v1"]
resources: ["pods"]
admissionReviewVersions: ["v1"]
sideEffects: None
常见误区
- 误区:Mutating 与 Validating 可以合并;正解:职责分离,Mutating 做修改,Validating 做校验,分开配置。
- 误区:Validating 也能 patch;正解:Validating 返回 admissionReviewResponse,只允许 allow/deny + message。
追问
- Q:sideEffects 为什么必须设? A:标记 webhook 是否有副作用(如写 K8s),
None表示无副作用,apiserver 在 dry-run 时安全调用。 - Q:webhook 的 AdmissionReview 是什么? A:apiserver POST 给 webhook 的请求体,包含完整对象与操作类型。
08.6.4-003 Webhook 如何匹配要拦截的资源?
一句话结论
webhook 配置 rules 按 apiGroups、apiVersions、resources、operations 匹配;还可用 namespaceSelector、objectSelector 过滤命名空间与对象。
概念解释
- rules:匹配哪些资源类型。
- operations:CREATE/UPDATE/DELETE/CONNECT。
- namespaceSelector:按命名空间标签过滤。
- objectSelector:按对象标签过滤。
- 匹配优先级:rules + selectors 同时满足才调用。
原理流程
- apiserver 收到请求。
- 遍历所有 webhook。
- 检查 rules 是否匹配资源类型与操作。
- 检查 namespaceSelector 与 objectSelector。
- 都匹配则调用 webhook。
代码 / 示例
rules:
- apiGroups: ["apps"]
apiVersions: ["v1"]
resources: ["deployments"]
operations: ["CREATE", "UPDATE"]
namespaceSelector:
matchExpressions:
- key: environment
operator: NotIn
values: ["kube-system"]
常见误区
- 误区:webhook 拦截所有资源;正解:必须显式配 rules,未匹配的资源不调用。
- 误区:namespaceSelector 与 objectSelector 作用一样;正解:namespaceSelector 按命名空间标签过滤,objectSelector 按对象本身标签过滤。
追问
- Q:如何排除 kube-system? A:namespaceSelector 配
environment NotIn [kube-system],避免影响系统组件。 - Q:resources 用
*会怎样? A:匹配所有资源,但生产应精确指定,避免误拦。
08.6.4-004 Webhook 如何注入 sidecar(如 Istio/Linkerd)?
一句话结论
Istio 的 sidecar-injector 是一个 Mutating Webhook:Pod 创建时,webhook 检查 namespace 标签,符合条件则返回 JSON patch 注入 Envoy sidecar 容器与 init 容器。
概念解释
- 注入时机:Pod CREATE。
- 注入内容:istio-proxy 容器、init 容器(设置 iptables)、volume(证书、配置)。
- 触发条件:namespace 带
istio-injection=enabled标签。
原理流程
- 用户创建 Pod。
- apiserver 调用 sidecar-injector webhook。
- webhook 检查 namespace 是否带注入标签。
- 返回 JSON patch,在 Pod spec 里加 sidecar 容器与 init 容器。
- apiserver 应用 patch,写入 etcd。
代码 / 示例
// webhook 返回的 patch
[
{"op": "add", "path": "/spec/containers/-", "value": {"name": "istio-proxy", "image": "istio/proxyv2"}},
{"op": "add", "path": "/spec/initContainers/-", "value": {"name": "istio-init", "image": "istio/proxyv2"}}
]
常见误区
- 误区:sidecar 是 Operator 主动加的;正解:是 Mutating Webhook 在 Pod 创建时注入的,不依赖 controller。
- 误区:所有 Pod 都自动注入;正解:只有 namespace 带
istio-injection=enabled且 Pod 没带sidecar.istio.io/inject=false注解才注入。
追问
- Q:如何跳过注入? A:Pod 加注解
sidecar.istio.io/inject: "false"。 - Q:sidecar 注入后能改吗? A:注入是在 Pod 创建时,已运行的 Pod 不会重新注入,要重启 Pod。
08.6.4-005 Webhook 服务故障会怎样?
一句话结论
webhook 服务不可用时,apiserver 按 failurePolicy 决定是拒绝请求(Fail)还是放行(Ignore);Fail 会导致所有匹配资源的 create/update 失败,影响集群可用性。
概念解释
- failurePolicy: Fail:webhook 调用失败时拒绝请求。
- failurePolicy: Ignore:webhook 失败时放行请求。
- webhook 挂了:所有依赖 webhook 的操作都受影响。
原理流程
- apiserver 调用 webhook,超时或连接失败。
- 按 failurePolicy 处理:Fail 则返回 500,Ignore 则跳过 webhook 继续。
代码 / 示例
failurePolicy: Fail # 或 Ignore
timeoutSeconds: 5
常见误区
- 误区:webhook 挂了集群就崩;正解:failurePolicy=Ignore 时 webhook 挂了不影响业务,但会失去校验;Fail 时业务受影响。
- 误区:webhook 应该用 Ignore;正解:关键校验(如镜像安全)必须 Fail,避免绕过;非关键(如标签注入)用 Ignore。
追问
- Q:webhook 怎么高可用? A:多副本部署 + Service 负载均衡,避免单副本挂了影响所有请求。
- Q:webhook 挂了 kubectl create 也失败吗? A:如果请求匹配 webhook rules,failurePolicy=Fail 时 create 失败,必须先恢复 webhook。
08.6.4-006 Webhook 的 timeout 与 failurePolicy 怎么配?
一句话结论
timeoutSeconds 默认 10 秒,建议 2-5 秒;failurePolicy 关键校验用 Fail,非关键用 Ignore;webhook 必须快速响应,避免阻塞 apiserver。
概念解释
- timeoutSeconds:apiserver 等 webhook 响应的最长时间。
- failurePolicy:超时/失败后 Fail 还是 Ignore。
- webhook 慢:所有匹配请求都被阻塞,影响集群 API。
原理流程
- apiserver 发请求给 webhook。
- 等待响应,超过 timeoutSeconds 则失败。
- 按 failurePolicy 处理。
代码 / 示例
timeoutSeconds: 3
failurePolicy: Fail
常见误区
- 误区:timeout 越长越好;正解:webhook 必须快速响应,长 timeout 会让 apiserver 卡住,建议 2-5 秒。
- 误区:所有 webhook 都用 Fail;正解:非关键 webhook(如标签注入)用 Ignore,避免 webhook 故障影响业务。
追问
- Q:webhook 内部能调外部 API 吗? A:可以,但要在 timeout 内返回,否则 apiserver 超时;外部依赖要缓存或异步。
- Q:如何避免 webhook 慢? A:webhook 只做轻量校验,复杂逻辑异步化,不依赖外部服务。
08.6.4-007 为什么 webhook 必须用 HTTPS?
一句话结论
apiserver 与 webhook 之间是敏感通信(包含完整对象与凭证),必须 TLS 加密;webhook 服务端要提供证书,apiserver 通过 caBundle 校验证书。
概念解释
- HTTPS:apiserver POST 到 webhook 的 HTTPS 端点。
- caBundle:webhook 配置里写 CA 证书,apiserver 用它校验 webhook 证书。
- 证书:webhook 服务端证书,通常由 cert-manager 签发。
原理流程
- webhook 服务启动,监听 HTTPS。
- apiserver 读 webhook 配置里的 caBundle。
- 调用时 TLS 握手,apiserver 校验证书。
- 通过后发送 AdmissionReview。
代码 / 示例
clientConfig:
service:
name: sidecar-webhook
namespace: kube-system
path: "/mutate"
caBundle: LS0tLS1CRUdJTi...
常见误区
- 误区:webhook 可以用 HTTP;正解:apiserver 只支持 HTTPS,必须配 TLS。
- 误区:自签证书不行;正解:可以,但要把 CA 写进 caBundle;生产用 cert-manager 自动签发。
追问
- Q:cert-manager 怎么自动签? A:cert-manager 检测 webhook 配置的 caBundle 注解,自动签发证书并更新。
- Q:webhook 证书过期怎么办? A:cert-manager 自动续期,否则 apiserver 校验失败,webhook 调用失败。
08.6.4-008 常见准入控制场景有哪些?
一句话结论
常见场景:sidecar 注入(Istio)、镜像校验(只允许内部仓库)、标签注入(加 cost-center、env)、资源限额(必须设 requests/limits)、Pod 安全标准(禁止 privileged)。
概念解释
- 镜像仓库白名单:只允许从内部 registry 拉取。
- 资源限额:强制 Pod 设 requests/limits。
- 安全基线:禁止 privileged、禁止 root、只读根文件系统。
- 标签注入:自动加 team、cost-center 标签。
原理流程
- 用户提交 Pod/Deployment。
- webhook 校验或修改。
- 不合规则拒绝,或自动补全标签。
代码 / 示例
# 镜像校验:只允许 internal-registry.example.com
validatingWebhook:
- name: image-validator.example.com
rules:
- operations: ["CREATE", "UPDATE"]
apiGroups: [""]
resources: ["pods"]
常见误区
- 误区:准入控制只能做安全;正解:也能做规范(标签、资源限额)与自动化(sidecar 注入)。
- 误区:准入控制替代 OPA;正解:OPA Gatekeeper/Kyverno 是策略引擎,底层用 webhook 实现。
追问
- Q:Pod Security Standards 是什么? A:K8s 内建的 Pod 安全策略(privileged/baseline/restricted),用准入标签在命名空间级别启用,不需要自定义 webhook。
- Q:如何强制所有 Pod 设 requests/limits? A:用 LimitRange 命名空间级默认值,或 webhook 校验。
08.6.4-009 Kyverno 与 OPA Gatekeeper 有什么区别?
一句话结论
OPA Gatekeeper 用 Rego 策略语言写规则,Kyverno 用 YAML 写规则;Gatekeeper 灵活但学习曲线陡,Kyverno 原生 K8s YAML 易上手但表达能力弱。
概念解释
- OPA Gatekeeper:基于 Open Policy Agent,策略用 Rego 语言。
- Kyverno:策略是 K8s CRD(ClusterPolicy),用 YAML 写。
- 共同点:都在准入控制阶段拦截不合规资源。
原理流程
- Gatekeeper:用户写 Rego,翻译成 constraint。
- Kyverno:用户写 ClusterPolicy YAML。
- webhook 在请求时校验。
代码 / 示例
# Kyverno 策略:禁止 privileged
apiVersion: kyverno.io/v1
kind: ClusterPolicy
metadata:
name: no-privileged
spec:
validationFailureAction: Enforce
rules:
- name: privileged-containers
match:
any:
- resources:
kinds: ["Pod"]
validate:
message: "Privileged container is not allowed"
pattern:
spec:
containers:
- securityContext:
privileged: "false"
常见误区
- 误区:Kyverno 比 Gatekeeper 弱;正解:Kyverno 覆盖大多数常见策略,YAML 易上手;复杂策略用 Rego 更灵活。
- 误区:策略引擎替代 webhook;正解:策略引擎底层还是 webhook,只是把规则抽象成 YAML/Rego。
追问
- Q:validationFailureAction Enforce 与 Audit 区别? A:Enforce 拒绝不合规,Audit 只记录不拒绝。
- Q:Kyverno 也能做 mutate? A:能,ClusterPolicy 支持 mutate(注入标签、改字段)。
08.6.4-010 Webhook 如何避免循环调用?
一句话结论
webhook 修改对象后会再次触发 apiserver 更新,可能循环调用其他 webhook;用 sideEffects=None、objectSelector 排除自身资源、在 webhook 里检查是否已处理过避免循环。
概念解释
- 循环:webhook A 修改对象 -> apiserver 再走准入 -> webhook B 又改 -> 无限循环。
- 避免:给注入的资源加标签,webhook 检查标签跳过。
- 时机:只在 CREATE 时注入,不响应 UPDATE。
原理流程
- Pod CREATE,webhook 注入 sidecar。
- 注入后 Pod spec 变化,apiserver 内部更新。
- webhook 看到 Pod 已有 sidecar 标签,跳过。
代码 / 示例
objectSelector:
matchExpressions:
- key: sidecar-injected
operator: NotIn
values: ["true"]
常见误区
- 误区:webhook 永远不会循环;正解:多个 webhook 互相修改可能导致无限循环,apiserver 有最大准入次数限制(默认 10 次)。
- 误区:sideEffects 不重要;正解:sideEffects=None 让 apiserver 知道 webhook 不写 K8s,可以安全在 dry-run 调用。
追问
- Q:apiserver 怎么防止无限循环? A:限制最大准入循环次数,超过则拒绝请求。
- Q:如何调试 webhook 循环? A:开 audit log,看 AdmissionReview 调用链,找哪个 webhook 在反复修改。
待整理清单
- [ ] Kyverno ClusterPolicy 完整语法
- [ ] OPA Rego 基础
- [ ] webhook 与 cert-manager 自动证书
- [ ] 准入控制与 Pod Security Standards