4. kubectl get 与版本显示：如何查看当前集群中存储对象的存储版本、使用 kubectl get crd 查看 CRD 版本

在 Kubernetes 集群运维中，确认存储对象的存储版本（storage version）是校准版本漂移的第一步。存储版本决定了对象在 etcd 中持久化的序列化格式，而 CRD（Custom Resource Definition）的版本则决定了自定义资源的 API 可用性。本节将系统讲解如何通过 kubectl get 命令族获取这两类关键版本信息。

4.1 查看内置资源的存储版本

对于 Deployment、ConfigMap、Secret 等内置资源，Kubernetes 在 API 发现信息中标注了每个资源的首选版本（preferred version）和存储版本。使用以下命令可以快速查看集群中所有 API 资源的版本信息：

# 查看所有 API 资源及其版本（含存储版本标记）
kubectl api-resources --verbs=list -o wide | grep -E 'STORAGEVERSION|true'

# 查看特定资源（如 Deployment）的存储版本
kubectl api-resources --api-group=apps -o wide | grep deployment

输出示例：

4.2 查看 CRD 的版本定义

CRD 的版本信息存储在 CRD 对象本身的 spec.versions 字段中。每个版本可以标记为 served: true/false（是否在 API 中提供）和 storage: true/false（是否为存储版本）。

# 列出所有 CRD 及其版本概况
kubectl get crd -o wide

# 查看特定 CRD 的详细版本定义
kubectl get crd <crd-name> -o yaml | grep -A 10 'versions:'

CRD 版本定义示例（YAML 片段）：

spec:
  versions:
  - name: v1alpha1
    served: true
    storage: false
    schema:
      openAPIV3Schema:
        type: object
  - name: v1
    served: true
    storage: true
    schema:
      openAPIV3Schema:
        type: object

4.3 查看 CRD 自定义资源的实际存储版本

对于 CRD 创建的自定义资源实例，其存储版本可以通过资源对象的 apiVersion 字段确认。但更可靠的方式是直接查看 etcd 中的原始数据：

# 查看自定义资源实例的 apiVersion（反映其存储版本）
kubectl get <custom-resource> <instance-name> -o json | jq '.apiVersion'

# 批量检查所有实例的存储版本分布
kubectl get <custom-resource> -A -o json | jq '.items[].apiVersion' | sort | uniq -c | sort -rn

输出示例：

   47 "example.com/v1"
    3 "example.com/v1alpha1"

4.4 存储版本查看流程总览

以下 SVG 图展示了从集群层面到资源实例层面的版本查看路径：

4.5 版本查看命令速查表