版本升级:兼容性、变更与恢复¶
升级不仅是修改镜像版本。先分别确认数据库、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 变更与数据库版本变更分步验收。
分阶段执行¶
固定源/目标清单与镜像,在独立测试拓扑验证升级、恢复和应用兼容。
演练备份恢复,保存数据校验基线;必要时停写或进入维护窗口。
按被支持的版本路径实施变更,遵循对应 Operator/数据库的步骤与组件顺序;此处不编造通用 CN/TN/Logservice 滚动顺序。
观察资源条件、事件、重启、SQL 错误、关键查询、存储和后台任务,达到停止条件就暂停变更。
从真实客户端验证读写、事务、权限、索引/查询、外部依赖与 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 滚动升级未在本次环境执行,不能据此宣称零中断或任意版本可直接降级。