为什么需要apiVersion

Kubernetes API 版本的主要作用是允许 Kubernetes 集群中的不同组件和工具使用不同版本的 Kubernetes API 对象。这种解耦设计可以提高 Kubernetes 的灵活性、可扩展性和兼容性，使得用户可以根据自己的需要选择合适的 API 版本来管理 Kubernetes 资源。

具体来说，API 版本有以下几个重要的作用：

• 标识 Kubernetes API 对象的版本号，方便用户和开发者识别和区分不同版本的 Kubernetes API 对象。

• 允许 Kubernetes 组件和工具使用不同版本的 Kubernetes API 对象，从而实现更好的兼容性和互操作性。

• 通过定义不同版本的 Kubernetes API 对象，为 Kubernetes 提供了可扩展的资源管理框架，支持用户自定义资源和控制器等。

通过升级 Kubernetes API 版本，可以在不破坏现有应用程序的情况下，引入新的特性和功能，增强 Kubernetes 平台的能力和易用性。

举例说明

Kubernetes 1.20 版本引入了 apps/v1 API 的第三个版本 apps/v1，用于替换之前的 apps/v1beta1 和 apps/v1beta2 版本。新版本的 API 引入了许多新特性和功能，例如：

Deployment 可以管理 ReplicaSets、PodTemplates 和 ReplicationControllers 的所有内容，使得应用程序的部署更加简单和可控。

StatefulSet 支持有状态应用程序的部署和扩展，包括有序的 Pod 部署、有序的 Pod 删除、PV/PVC 的管理等。

DaemonSet 支持在集群中的每个节点上运行一组 Pod，使得某些服务或应用程序可以在集群中的所有节点上运行。

如果用户正在使用旧版本的 apps/v1beta1 或 apps/v1beta2 API 来管理应用程序，他们可以通过将 YAML 配置文件中的 apiVersion 字段修改为 apps/v1，来升级到新版本的 API，并获得更好的特性和功能。

此外，还可以通过 Kubernetes 命令行工具 kubectl 的 convert 命令将旧版本的 YAML 配置文件转换为新版本的 YAML 配置文件，从而实现自动化的 API 版本升级。例如：

$ kubectl convert -f old-deployment.yaml --output-version apps/v1 > new-deployment.yaml

该命令将读取名为 old-deployment.yaml 的 YAML 文件，将其从旧版本的 apps/v1beta1 转换为新版本的 apps/v1，并将结果输出到名为 new-deployment.yaml 的文件中。这样可以在不破坏现有应用程序的情况下，快速地升级到新版本的 Kubernetes API。

版本列表

Kubernetes API 版本是一个字符串，通常由两个或三个部分组成，用斜杠 / 分隔。第一个部分表示 API 对象所属的 Kubernetes 组件或插件，第二个部分表示 API 对象的版本号，第三个部分（可选）表示 API 版本的稳定性等级。下面是 Kubernetes 1.21 版本中的一些常见的 API 版本及其含义

Batch API

batch/v1 和 batch/v1beta1：Kubernetes Batch API 的 v1 和 v1beta1 版本，包含了 Job、CronJob 等对象，用于执行批处理作业或定时任务。

存储 API

storage.k8s.io/v1 和 storage.k8s.io/v1beta1：Kubernetes 存储 API 的 v1 和 v1beta1 版本，包含了 StorageClass、PersistentVolumeClaim 等对象，用于管理存储资源和卷。

网络 API

networking.k8s.io/v1 和 networking.k8s.io/v1beta1：Kubernetes 网络 API 的 v1 和 v1beta1 版本，包含了 Ingress、NetworkPolicy 等对象，用于管理网络规则和策略。

认证和授权 API

authentication.k8s.io/v1 和 authentication.k8s.io/v1beta1：Kubernetes 认证和授权 API 的 v1 和 v1beta1 版本，包含了 TokenRequest、TokenReview 等对象，用于实现身份验证和授权功能。

authorization.k8s.io/v1 和 authorization.k8s.io/v1beta1：Kubernetes 认证和授权 API 的 v1 和 v1beta1 版本，包含了 SubjectAccessReview、ClusterRoleBinding 等对象，用于实现基于角色的访问控制 (RBAC) 功能。