📚 课程目录第1章课程导论

1. 课程导论：为什么K8s集群升级会导致Deployment兼容性问题，课程目标与受众

1.1 核心矛盾：API版本演进与存量配置的冲突

Kubernetes 集群升级并非简单的版本号变更，而是一次涉及 API 资源版本废弃、字段行为变更、默认值调整以及控制器逻辑重构的复杂过程。Deployment 作为最核心的工作负载资源，其配置在升级前后极易出现兼容性断裂。根本原因在于 K8s 社区遵循的 API 弃用策略：每个 API 版本都有明确的生命周期，旧版本会在特定版本后被移除。

⚠️ 典型风险场景： 当集群从 v1.20 升级到 v1.26 时，extensions/v1beta1 和 apps/v1beta2 版本的 Deployment 将被彻底移除。未提前迁移的 YAML 清单将导致 kubectl apply 失败，甚至引发生产环境回滚事故。

除了 API 版本移除，字段级的不兼容同样致命。例如：spec.strategy.rollingUpdate.maxSurge 的默认值在早期版本中为 1，在后续版本中可能被调整；spec.progressDeadlineSeconds 的语义在 v1.21 之后被重新定义。这些隐式变更往往在升级后才会暴露，造成滚动更新卡死或 Pod 调度异常。

1.2 兼容性问题的三大来源

来源分类	具体表现	影响等级
API 版本废弃	旧版 API 被移除，YAML 无法被 API Server 识别	致命（拒绝创建/更新）
字段行为变更	字段默认值、校验规则或语义在升级后发生变化	严重（行为异常）
控制器逻辑重构	ReplicaSet 控制器、滚动更新策略的内部实现调整	中等（性能或状态偏差）

1.3 升级兼容性全景图

下图展示了从旧集群到新集群的升级过程中，Deployment 配置可能遭遇的兼容性检查点与适配路径：

1.4 课程目标

本课程旨在帮助学员建立一套系统化的 Deployment 配置兼容性适配方法论，具体目标如下：

识别风险：掌握 K8s API 版本弃用时间线，能够提前识别当前集群中即将废弃的 Deployment 配置。
迁移适配：学会使用 kubectl convert、kubectl diff 等工具完成 YAML 清单的版本迁移与字段修正。
验证保障：掌握升级前后的配置验证流程，包括 Dry Run、金丝雀发布、回滚预案等实战技巧。
自动化防御：构建基于 CI/CD 管道的兼容性检查门禁，防止不兼容配置流入生产集群。

1.5 目标受众

角色	核心痛点	课程价值
K8s 运维 / SRE	集群升级后出现大量 Deployment 异常，回滚成本高	掌握升级前检查清单与自动化适配工具
平台工程师	管理数百个微服务，YAML 版本混乱难以统一	学会批量迁移策略与 CI 门禁集成方案
DevOps 工程师	部署流水线在升级后频繁失败，排查困难	获得可落地的兼容性测试与验证框架
K8s 初学者	对 API 版本演进缺乏认知，容易踩坑	建立正确的版本管理与配置适配意识

1.6 一个真实的兼容性事故案例

案例背景： 某互联网公司将测试集群从 v1.19 升级至 v1.22 后，核心订单服务的 Deployment 滚动更新持续超时。

根因分析：

Deployment 使用了 apps/v1beta2 版本，升级后 API Server 自动转换时丢失了 spec.strategy.rollingUpdate.maxUnavailable 字段（旧版本默认值为 1，新版本要求显式声明）。
升级后该字段被置为 0，导致滚动更新无法驱逐旧 Pod，更新流程永久阻塞。

教训： 依赖 API Server 的自动转换机制是危险的。必须提前使用 kubectl convert 显式迁移，并对比新旧配置的差异。

1.7 课程路线图

本课程共分为 6 个模块，从基础概念到高级自动化，层层递进：

模块一（第1-5章）：API 版本弃用策略与 Deployment 配置结构深度解析。
模块二（第6-12章）：字段级兼容性差异清单与迁移工具实战。
模块三（第13-18章）：升级前检查清单、Dry Run 与金丝雀验证策略。
模块四（第19-23章）：CI/CD 管道中的兼容性门禁设计与实现。
模块五（第24-27章）：多集群环境下的统一配置管理方案。
模块六（第28-30章）：综合案例演练与常见故障排查手册。

💡 学习建议： 建议学员在本地搭建一个多版本 K8s 集群（如使用 kind 或 k3s），跟随课程同步进行实操验证。每个章节末尾的“动手练习”环节是巩固知识的关键。