3. Deployment API版本变迁：从extensions/v1beta1到apps/v1的完整历史

Kubernetes Deployment API 经历了从 extensions/v1beta1 到 apps/v1 的漫长演进过程。理解这一变迁历史，对于集群升级时的兼容性适配至关重要。不同版本的 API 在字段结构、默认行为、校验规则上存在显著差异，直接影响到存量 Deployment 配置的迁移策略。

3.1 版本演进时间线与里程碑

下表梳理了 Deployment API 从引入到稳定的关键版本节点及其核心变化：

3.2 核心字段差异对比

不同 API 版本之间，Deployment 的字段结构存在以下关键差异：

3.3 版本变迁架构图

下图展示了 Deployment API 版本从引入到稳定的完整演进路径，以及各版本之间的关键变化节点：

3.4 废弃与移除时间线

Kubernetes 社区遵循严格的 API 废弃策略。Deployment 相关 API 的废弃与移除时间线如下：

• v1.8：apps/v1beta1 和 apps/v1beta2 被标记为废弃，但功能仍可用。
• v1.9：apps/v1 达到 GA 状态，成为推荐版本；extensions/v1beta1 中的 Deployment 开始进入废弃倒计时。
• v1.13：extensions/v1beta1 中的 Deployment 被正式标记为废弃，不再接收新功能。
• v1.16：extensions/v1beta1 中的 Deployment 被彻底移除，集群 API Server 不再提供该版本的端点。
• v1.20：apps/v1beta1 和 apps/v1beta2 被移除，仅保留 apps/v1。

3.5 迁移示例：从 extensions/v1beta1 到 apps/v1

以下是一个典型的 Deployment 配置迁移示例，展示字段结构的调整：

# 旧版本：extensions/v1beta1
apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 3
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: nginx
        image: nginx:1.14
        ports:
        - containerPort: 80

# 新版本：apps/v1
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 3
  selector:                    # 新增必填字段
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: nginx
        image: nginx:1.14
        ports:
        - containerPort: 80

3.6 版本兼容性矩阵

下表总结了不同 Kubernetes 集群版本对 Deployment API 版本的支持情况，帮助你在升级前评估兼容性：