1. 课程导论：什么是准入控制 Webhook、存储版本漂移的概念、校准的必要性、课程目标与前置知识

1.1 什么是准入控制 Webhook

在 Kubernetes 集群中，准入控制（Admission Control） 是 API Server 处理请求流程中的一个关键环节。当用户通过 kubectl、客户端库或 Dashboard 向 API Server 发送资源创建、更新、删除请求时，请求会依次经过 认证 → 授权 → 准入控制 三个阶段。准入控制位于认证和授权之后，资源持久化到 etcd 之前。

准入控制 Webhook 是一种动态、可扩展的准入控制插件。它允许集群管理员注册外部 HTTP 回调（Webhook），在资源被持久化之前拦截请求，并对请求对象进行校验或修改。Kubernetes 提供了两种类型的准入 Webhook：

1.2 存储版本漂移的概念

存储版本漂移（Storage Version Drift） 是指在 Kubernetes 集群中，由于资源对象的 存储版本（storage version） 与 解码版本（decoding version） 不一致，导致 etcd 中实际存储的资源版本与 API Server 期望的版本产生偏差的现象。

Kubernetes 资源对象在 etcd 中是以特定版本（如 v1、v1beta1、v1alpha1）进行序列化存储的。当集群升级或 API 版本废弃时，如果存储版本没有及时迁移，就会出现以下问题：

• 旧版本残留： 已废弃的 API 版本（如 v1beta1）仍然作为存储版本存在于 etcd 中。
• 解码失败： 新版本的 API Server 可能无法正确解码旧版本存储的资源，导致读取或写入异常。
• 数据不一致： 同一资源的不同实例可能存储在不同的版本中，造成集群状态混乱。

1.3 校准的必要性

对存储版本漂移进行校准（即执行 存储版本迁移）是保障集群长期健康运行的必要操作。其必要性体现在以下四个维度：

1.4 课程目标

本课程旨在通过 接口测试 的视角，系统性地解决准入控制 Webhook 在拦截存储版本漂移时的校准问题。完成本课程后，学员将能够：

1. 理解原理： 掌握准入控制 Webhook 的工作机制与存储版本漂移的根因。
2. 设计测试： 针对 Webhook 的拦截逻辑设计接口测试用例，覆盖正常与异常场景。
3. 实现校准： 编写自动化测试脚本，验证 Webhook 是否正确拦截并校准存储版本漂移。
4. 集成 CI/CD： 将校准测试集成到持续集成流水线中，实现集群状态的持续验证。

1.5 前置知识

为了确保学习效果，学员应具备以下基础知识：

• Kubernetes 基础： 熟悉 Pod、Deployment、Service 等核心资源，了解 kubectl 常用命令。
• API 版本概念： 了解 v1、v1beta1、v1alpha1 等版本标识的含义及生命周期。
• HTTP 与 RESTful API： 理解 HTTP 方法（GET、POST、PUT、DELETE）、状态码及 JSON 格式。
• 接口测试基础： 了解接口测试的基本流程，熟悉至少一种接口测试工具（如 Postman、curl 或编程语言中的 HTTP 客户端库）。
• YAML 语法： 能够阅读和编写 Kubernetes 资源清单文件。