2. K8s API版本化机制：alpha、beta、stable版本的生命周期与废弃策略

Kubernetes API 版本化是集群升级过程中最核心的兼容性保障机制。每个 API 资源（如 Deployment、Pod、Ingress）都通过 apiVersion 字段声明其版本标识，而版本后缀（alpha、beta、stable）直接决定了该版本的稳定性、默认启用状态以及废弃时间线。理解这套生命周期模型，是制定安全升级策略的前提。

2.1 版本阶段与标识规则

Kubernetes 使用三段式版本标识：v<major><stage><minor>。其中 stage 为空时表示 stable 版本。具体阶段定义如下：

2.2 版本生命周期与废弃时间线

每个 API 版本从引入到最终移除，遵循明确的废弃流程。Kubernetes 官方通过 Deprecation Policy 规定了最小存活周期，确保用户有充足时间完成迁移。

2.3 废弃策略与迁移窗口

Kubernetes 废弃策略（Deprecation Policy）的核心原则是：先公告、后废弃、再移除。每个阶段都提供明确的迁移窗口：

• 公告期：版本进入废弃状态时，Kubernetes 会在 Release Notes 和 kubectl 输出中明确提示，同时更新 deprecated 字段。
• 共存期：废弃版本与替代版本至少共存 3 个次要版本（Stable）或 1 个次要版本（Beta），用户可并行使用新旧版本完成迁移。
• 移除期：版本被移除后，集群将拒绝使用该版本的 API 请求，已存储的对象会自动转换为新版本。

2.4 版本废弃的检测与应对

在集群升级前，系统管理员应主动检测当前集群中使用的废弃 API 版本。以下是推荐的检测流程：

1. 审计日志检查：启用 Kubernetes 审计日志，过滤 responseStatus.code=404 且包含 apiVersion 的请求。
2. kubectl 警告捕获：使用 kubectl get --v=6 或 kubectl api-resources --cached 查看版本状态。
3. 第三方工具扫描：使用 pluto、kube-no-trouble 等工具自动扫描集群中的废弃资源。
4. CI/CD 集成：在部署流水线中加入废弃版本检测步骤，阻止使用已废弃 apiVersion 的 YAML 文件。

# 使用 pluto 检测集群中废弃的 API 版本
pluto detect-all-in-cluster --target-version v1.28

# 输出示例
# NAME                    KIND         DEPRECATED   REPLACEMENT
# v1beta1.Ingress         Ingress      true          networking.k8s.io/v1
# v1beta1.CronJob         CronJob      true          batch/v1
# v1beta1.PodSecurityPolicy PodSecurityPolicy true   policy/v1beta1 (removed in v1.25)

2.5 版本迁移最佳实践

基于版本生命周期模型，推荐以下迁移策略：