4. 集群升级前Operator状态评估：检查当前Operator使用的API版本、依赖的CRD版本、兼容性矩阵

集群升级是Kubernetes生命周期中的高风险操作，Operator作为集群内自动化运维的核心组件，其API版本兼容性直接影响升级成败。在触发集群升级前，必须对目标Operator进行系统性状态评估，重点检查三个维度：API版本使用情况、CRD版本依赖以及兼容性矩阵。本章提供标准化的评估流程与工具链。

4.1 评估流程概览

集群升级前Operator状态评估遵循“采集→分析→比对→决策”四步法，确保每个环节可追溯、可复现。

1. 采集：使用 kubectl 和 helm 命令获取Operator当前使用的API资源、CRD定义及版本信息。
2. 分析：解析采集数据，识别已弃用（Deprecated）或即将移除（Removed）的API版本。
3. 比对：将分析结果与目标集群版本的API弃用策略进行交叉比对。
4. 决策：根据比对结果生成升级风险等级，决定是否需要先升级Operator或调整CRD。

4.2 检查当前Operator使用的API版本

Operator通过调用Kubernetes API与集群交互，其使用的API版本必须与目标集群版本兼容。检查方法分为两个层面：Operator自身代码中引用的API版本和运行时实际调用的API版本。

4.2.1 通过kubectl检查运行时API资源

使用以下命令获取Operator管理的所有自定义资源实例，并提取其 apiVersion 字段：

# 获取所有CRD列表
kubectl get crd -o json | jq -r '.items[] | .spec.names.kind + " (" + .spec.group + ")"'

# 获取特定CRD的所有实例及其apiVersion
kubectl get <crd-kind> -A -o json | jq -r '.items[] | .apiVersion' | sort -u

4.2.2 检查Operator代码中的API引用

对于基于Go语言的Operator，检查 go.mod 和 api/ 目录下的类型定义文件：

# 检查依赖的k8s.io/api版本
grep "k8s.io/api" go.mod

# 检查自定义资源类型定义中的apiVersion
grep -r "apiVersion" api/ --include="*.go" | grep -v "_test.go"

4.3 检查依赖的CRD版本

CRD（CustomResourceDefinition）版本管理是Operator兼容性的核心。每个CRD可以包含多个版本（如 v1alpha1、v1beta1、v1），Operator必须明确其依赖的存储版本和服务版本。

4.3.1 获取CRD版本信息

# 查看CRD的版本定义
kubectl get crd <crd-name> -o yaml | yq '.spec.versions'

# 查看CRD的存储版本（storedVersions）
kubectl get crd <crd-name> -o json | jq '.status.storedVersions'

4.3.2 版本依赖分析表

以下表格展示了不同CRD版本与Kubernetes集群版本的兼容性关系：

4.4 兼容性矩阵构建

兼容性矩阵是Operator升级决策的核心依据。它需要整合Operator版本、CRD版本、Kubernetes版本三个维度的交叉验证结果。

4.4.1 矩阵构建步骤

1. 收集Operator官方兼容性声明：查阅Operator的 README.md、CHANGELOG.md 或官方文档中的兼容性表格。
2. 提取Operator代码中的版本常量：检查 version.go 或 main.go 中的 MinimumKubeVersion 字段。
3. 比对实际运行环境：将上述信息与当前集群版本、目标集群版本进行交叉比对。

4.4.2 兼容性矩阵示例

以下是一个典型的Operator兼容性矩阵（以某Prometheus Operator为例）：

4.5 自动化检查工具

为提高评估效率，推荐使用以下自动化工具进行批量检查：

• pluto：检测Kubernetes集群中已弃用的API版本，支持Helm Chart和YAML文件扫描。
• kube-no-trouble (kubent)：实时检查集群中正在使用的已弃用API资源。
• kubectl-validate：验证YAML清单与目标集群版本的兼容性。

# 使用pluto检测Helm Chart中的弃用API
pluto detect-helm -c <chart-path>

# 使用kubent检测集群中正在使用的弃用API
kubent --target-version 1.28.0

# 使用kubectl-validate验证YAML文件
kubectl-validate --version 1.28.0 <manifest.yaml>

4.6 评估报告输出

完成上述检查后，应输出一份结构化的评估报告，包含以下关键字段：