1. 课程导论：日志平台版本一致性的重要性、Deployment 在 K8s 中的角色、本课程目标与受众
1.1 为什么日志平台版本一致性如此关键？
在微服务和云原生架构中，日志平台（如 Elasticsearch、Fluentd、Logstash、Kibana 组成的 EFK/ELK 栈）是故障排查、监控告警和审计合规的核心基础设施。然而，生产环境中日志平台因版本不一致导致的故障屡见不鲜：
- 数据格式不兼容：Elasticsearch 7.x 与 8.x 的 mapping 结构差异，导致旧索引无法被新版本查询。
- 协议握手失败：Fluentd 1.14 与 1.15 的 forward 协议变更，造成日志采集端与聚合端断连。
- 配置语法失效：Logstash 6.x 的 pipeline 配置在 7.x 中部分参数被废弃，导致管道启动失败。
- 安全补丁遗漏：Kibana 旧版本存在已知 CVE，未随集群统一升级成为安全短板。
核心结论：日志平台版本一致性不是“可选优化”，而是保障可观测性链路可用性的 硬性前提。一次版本漂移就可能引发日志丢失、查询失败甚至集群不可用。
1.2 Deployment 在 Kubernetes 中的角色
Kubernetes Deployment 是管理无状态工作负载的核心资源，也是日志平台各组件的首选部署模型。它提供了版本一致性部署所需的关键能力：
| Deployment 特性 | 对版本一致性的作用 |
|---|---|
| Pod Template 版本化 | 每次更新镜像版本或配置，都会生成新的 ReplicaSet，保留历史版本记录 |
| 滚动更新策略 | 支持 maxSurge / maxUnavailable 控制，确保升级过程中版本逐步替换 |
| 回滚机制 | 通过 kubectl rollout undo 快速恢复到上一已知正确版本 |
| 声明式状态管理 | YAML 中定义的镜像标签、环境变量、ConfigMap 引用构成版本一致性基线 |
| 就绪探针与健康检查 | 确保新版本 Pod 真正就绪后才接管流量，避免版本混跑导致数据不一致 |
下图展示了 Deployment 如何通过 ReplicaSet 链管理日志平台各组件的版本演进：
1.3 本课程目标
本课程旨在帮助学员掌握一套 可落地、可自动化、可审计 的日志平台版本一致性部署校验方法。具体目标包括：
- 理解版本漂移的根因：从镜像标签、ConfigMap、Helm Chart 等维度分析不一致来源。
- 掌握 Deployment 版本校验技术：使用
kubectl、diff、kustomize及自定义脚本对比期望状态与实际状态。 - 构建自动化校验流水线：在 CI/CD 中集成版本一致性检查，阻止不一致的部署进入生产。
- 设计回滚与修复策略：当检测到版本不一致时，快速定位差异并执行标准化修复。
课程产出：一套完整的 Deployment 版本一致性校验工具集，包含 Shell 脚本、Python 检查器、Kubernetes Admission Webhook 示例及 Jenkins/GitLab CI 集成模板。
1.4 目标受众
| 角色 | 前置知识要求 | 本课程价值 |
|---|---|---|
| Kubernetes 运维工程师 | 熟悉 kubectl、YAML、Pod/Deployment 基本概念 | 掌握日志平台版本一致性部署的实操方法，减少线上故障 |
| DevOps 工程师 | 了解 CI/CD 流水线、容器镜像管理 | 学会将版本校验集成到自动化部署流程中 |
| 日志平台管理员 | 使用过 EFK/ELK 或 Loki 等日志系统 | 获得日志组件版本管理的标准化方案 |
| SRE / 平台工程师 | 具备脚本编写能力（Shell/Python） | 构建可扩展的版本一致性校验框架 |
1.5 课程内容概览
本课程共 30 章，分为四个阶段，逐步深入：
重要提示：本课程所有操作均在 非生产环境 中验证后再上线。版本一致性校验工具会直接读取 Kubernetes API，请确保 RBAC 权限最小化。