3. 常用资源API版本演进史：Deployment、StatefulSet、Ingress、CRD等核心资源的版本变化

Kubernetes API 版本遵循严格的废弃（Deprecation）与移除（Removal）策略。每个版本号（如 v1beta1 → v1）都代表不同的稳定性与功能承诺。理解核心资源的版本演进路径，是制定升级计划的前提。

3.1 版本命名规则与生命周期

Kubernetes API 版本分为三个层级：

3.2 Deployment 版本演进

Deployment 是 Kubernetes 中最常用的工作负载资源，其 API 版本演进路径清晰，是理解版本迁移的典型范例。

• Kubernetes 1.1 – 1.8： extensions/v1beta1（初始引入）
• Kubernetes 1.2 – 1.8： apps/v1beta1（引入 apps 组）
• Kubernetes 1.4 – 1.8： apps/v1beta2（改进字段结构）
• Kubernetes 1.9： apps/v1（GA 稳定版本）
• Kubernetes 1.16： extensions/v1beta1、apps/v1beta1、apps/v1beta2 被正式移除

# 检查集群中所有 Deployment 的 API 版本
kubectl get deployment --all-namespaces -o jsonpath='{range .items[*]}{.apiVersion}{"\n"}{end}' | sort -u

# 如果输出包含 extensions/v1beta1 或 apps/v1beta1，则需要迁移
# 迁移命令示例（使用 kubectl convert 插件）：
kubectl convert -f old-deployment.yaml --output-version apps/v1 > new-deployment.yaml
kubectl apply -f new-deployment.yaml

3.3 StatefulSet 版本演进

StatefulSet 的演进路径与 Deployment 高度相似，但时间线略有不同。

3.4 Ingress 版本演进

Ingress 的版本演进较为复杂，因为它经历了从 extensions 组到 networking 组的迁移，并且引入了新的 IngressClass 资源。

• Kubernetes 1.1 – 1.13： extensions/v1beta1（唯一版本）
• Kubernetes 1.14： 引入 networking.k8s.io/v1beta1（功能与 extensions/v1beta1 相同）
• Kubernetes 1.19： 引入 networking.k8s.io/v1（GA 版本，字段结构有重大变化）
• Kubernetes 1.22： extensions/v1beta1 和 networking.k8s.io/v1beta1 被移除

# 旧版本 Ingress（extensions/v1beta1）
apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: old-ingress
spec:
  rules:
  - host: example.com
    http:
      paths:
      - path: /api
        backend:
          serviceName: api-service
          servicePort: 8080

# 新版本 Ingress（networking.k8s.io/v1）
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: new-ingress
spec:
  rules:
  - host: example.com
    http:
      paths:
      - path: /api
        pathType: Prefix
        backend:
          service:
            name: api-service
            port:
              number: 8080

3.5 CRD（CustomResourceDefinition）版本演进

CRD 本身作为 API 资源，其版本演进直接影响自定义资源的定义方式。

• Kubernetes 1.7： apiextensions.k8s.io/v1beta1（初始引入，功能有限）
• Kubernetes 1.16： apiextensions.k8s.io/v1（GA 版本，引入结构模式、版本转换等关键特性）
• Kubernetes 1.22： apiextensions.k8s.io/v1beta1 被移除

# 检查 CRD 的 API 版本
kubectl get crd -o jsonpath='{range .items[*]}{.apiVersion}{"\n"}{end}' | sort -u

# 如果输出包含 v1beta1，则需要迁移
# 迁移时，需要将 CRD 定义中的 apiVersion 改为 apiextensions.k8s.io/v1
# 并确保包含完整的 openAPIV3Schema 定义

3.6 核心资源版本演进总览图

下图展示了 Deployment、StatefulSet、Ingress 和 CRD 四个核心资源从引入到 GA 再到旧版本移除的完整时间线。

3.7 版本迁移优先级与检查清单

根据上述演进史，制定以下迁移优先级：

1. 最高优先级： 检查所有使用 extensions/v1beta1 的资源（Deployment、Ingress、DaemonSet、ReplicaSet、NetworkPolicy）。该版本在 1.16 已被移除。
2. 高优先级： 检查所有使用 apps/v1beta1 和 apps/v1beta2 的资源（Deployment、StatefulSet、DaemonSet、ReplicaSet）。该版本在 1.16 已被移除。
3. 中优先级： 检查所有使用 networking.k8s.io/v1beta1 的 Ingress 资源。该版本在 1.22 已被移除。
4. 低优先级： 检查所有使用 apiextensions.k8s.io/v1beta1 的 CRD 定义。该版本在 1.22 已被移除。

# 一键扫描集群中所有废弃 API 版本的使用情况
kubectl get --raw /openapi/v2 | jq -r '.paths | keys[]' | grep -E '(extensions/v1beta1|apps/v1beta1|apps/v1beta2|networking.k8s.io/v1beta1|apiextensions.k8s.io/v1beta1)' | sort -u

3.8 版本迁移工具与最佳实践