罗罗编程学习记录
本页内容 展开查看

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。

原理流程

  1. 请求到达 apiserver。
  2. Authentication 验证 token。
  3. Authorization(RBAC)判断权限。
  4. Mutating webhook 修改对象。
  5. Validating webhook 校验对象。
  6. 通过则写入 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。

原理流程

  1. Mutating webhook 收到对象,返回 JSON patch。
  2. apiserver 应用 patch。
  3. Validating webhook 收到修改后的对象,返回 allow/deny。
  4. 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 同时满足才调用。

原理流程

  1. apiserver 收到请求。
  2. 遍历所有 webhook。
  3. 检查 rules 是否匹配资源类型与操作。
  4. 检查 namespaceSelector 与 objectSelector。
  5. 都匹配则调用 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 标签。

原理流程

  1. 用户创建 Pod。
  2. apiserver 调用 sidecar-injector webhook。
  3. webhook 检查 namespace 是否带注入标签。
  4. 返回 JSON patch,在 Pod spec 里加 sidecar 容器与 init 容器。
  5. 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 的操作都受影响。

原理流程

  1. apiserver 调用 webhook,超时或连接失败。
  2. 按 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。

原理流程

  1. apiserver 发请求给 webhook。
  2. 等待响应,超过 timeoutSeconds 则失败。
  3. 按 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 签发。

原理流程

  1. webhook 服务启动,监听 HTTPS。
  2. apiserver 读 webhook 配置里的 caBundle。
  3. 调用时 TLS 握手,apiserver 校验证书。
  4. 通过后发送 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 标签。

原理流程

  1. 用户提交 Pod/Deployment。
  2. webhook 校验或修改。
  3. 不合规则拒绝,或自动补全标签。

代码 / 示例

# 镜像校验:只允许 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 写。
  • 共同点:都在准入控制阶段拦截不合规资源。

原理流程

  1. Gatekeeper:用户写 Rego,翻译成 constraint。
  2. Kyverno:用户写 ClusterPolicy YAML。
  3. 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。

原理流程

  1. Pod CREATE,webhook 注入 sidecar。
  2. 注入后 Pod spec 变化,apiserver 内部更新。
  3. 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