版本升级:兼容性、变更与恢复

升级不仅是修改镜像版本。先分别确认数据库、Operator、CRD、备份工具和存储格式的兼容性。示例基线为 v4.2.5;本页没有认证所有历史版本到 v4.2.5 的直接/滚动升级路径。

变更前记录

项目

必须准备

来源与目标

MO tag/digest、配置、Operator chart/镜像/CRD、工具版本

兼容性

官方发布说明、支持的升级路径、schema/catalog 与 FileService backend 格式变化

数据与依赖

PVC、bucket/prefix、节点身份、权限、外部文件、CDC/Task/应用连接

保护与验证

可恢复的独立备份、测试目标恢复、关键业务行数/汇总/读写基线

变更控制

维护窗口、流量安排、执行负责人、停止条件、恢复目标和预期中断

修改 .spec.version 可能触发 Operator 重建服务,但不证明升级路径兼容或全程无中断。不要只凭“新版进程起来”判断升级成功。Operator/CRD 变更与数据库版本变更分步验收。

分阶段执行

  1. 固定源/目标清单与镜像,在独立测试拓扑验证升级、恢复和应用兼容。

  2. 演练备份恢复,保存数据校验基线;必要时停写或进入维护窗口。

  3. 按被支持的版本路径实施变更,遵循对应 Operator/数据库的步骤与组件顺序;此处不编造通用 CN/TN/Logservice 滚动顺序。

  4. 观察资源条件、事件、重启、SQL 错误、关键查询、存储和后台任务,达到停止条件就暂停变更。

  5. 从真实客户端验证读写、事务、权限、索引/查询、外部依赖与 CDC/Task 状态,再恢复流量。

可先执行以下只读检查,资源名替换为真实值:

MO_NAMESPACE=mo
MO_CLUSTER=mo
kubectl get matrixonecluster "$MO_CLUSTER" -n "$MO_NAMESPACE" -o yaml
kubectl get pods,pvc,svc -n "$MO_NAMESPACE" -o wide
kubectl get events -n "$MO_NAMESPACE" --sort-by=.lastTimestamp

完整 YAML 可能含敏感引用,不应未经检查公开。部署清单修改使用已批准的文件和流程,避免直接复制旧 nightly、旧 chart 或不同存储后端的示例。

回滚配置与恢复数据不同

情况

处理

新镜像无法拉取,尚未运行新版本

修复镜像/调度配置,核对旧实例和数据状态

新版本已经执行 catalog/schema/格式迁移

不能假定把 image tag 改回去即可降级;按支持路径或备份恢复

业务数据错误或对象损坏

选择明确恢复点,在独立目标恢复并校验后切换

Operator/CRD 变更

单独核对资源 schema 和控制器兼容,Helm 回退不能替代数据恢复

快照回滚业务数据不等于回退数据库二进制、catalog 或文件格式。恢复方案必须记录允许的数据损失、实际恢复时间以及目标版本。

重建目标的边界

日常升级步骤不包含删除 PVC、删除原数据目录或清空共享 bucket。需要重新部署时,优先使用独立 namespace/卷/bucket prefix,保留原环境用于诊断与恢复。只有已经完成独立恢复和业务验收、明确放弃旧数据的退役流程才能处理旧存储;不能把它作为常规升级的前置步骤。

详细方法见备份参考和恢复演练。跨版本升级与 Kubernetes 滚动升级未在本次环境执行,不能据此宣称零中断或任意版本可直接降级。