生产部署:版本、存储、网络与验收¶
本页补充部署前决策与上线验收。基线为 v4.2.5;不是对任意 Kubernetes/Operator/存储组合的生产认证。先完成以下记录,再使用集群部署步骤。
一份可复现的版本记录¶
层次 |
必须记录 |
校验依据 |
|---|---|---|
MatrixOne |
tag、digest、架构、配置来源及校验值 |
正式 release、实际镜像、运行中 SELECT VERSION |
Operator chart |
chart 版本、包校验值、完整 values |
选定 chart 的 Chart.yaml、values.yaml、渲染结果 |
控制器与依赖 |
Operator/OpenKruise/备份镜像的实际 tag/digest |
渲染清单和运行中 Pod 的 imageID |
Kubernetes |
服务端/客户端版本、CNI、CSI、StorageClass |
集群记录与对应组件支持矩阵 |
存储与恢复工具 |
S3/MinIO、备份工具版本、格式和加密条件 |
提供方文档及同版本恢复实验 |
chart 版本、控制器镜像和 MO 版本是三个不同值。 2026-10-14 下载的官方 chart 1.3.0-alpha.4 默认渲染控制器镜像为 matrixorigin/matrixone-operator:1.2.0-alpha.5,并包含 matrixorigin/mobr:1.0.0-rc1 与 OpenKruise 依赖。不能只看 chart 标签就判断部署了哪个控制器,更不能推断该组合已认证支持 MO v4.2.5。
这次在 Helm 3.19.0 下完成该 chart 的 lint 和离线渲染,没有在 Kubernetes 集群安装。以下步骤用于验证自己选定的版本,不把“最新”当作兼容矩阵:
MO_OPERATOR_CHART=/path/to/pinned/matrixone-operator
helm show chart "$MO_OPERATOR_CHART"
helm show values "$MO_OPERATOR_CHART"
helm lint "$MO_OPERATOR_CHART"
helm template mo-op "$MO_OPERATOR_CHART" -f approved-values.yaml > rendered.yaml
kubectl get crd matrixoneclusters.core.matrixorigin.io
kubectl explain matrixonecluster.spec --api-version=core.matrixorigin.io/v1alpha1
kubectl apply --dry-run=server -f mo.yaml
approved-values.yaml 与 mo.yaml 由部署方按固定版本准备,不是本页提供的可直接应用清单。渲染文件可能包含 Secret,只在受控位置查看,不将其全文贴到 issue。安装/升级 chart 时,CRD 更新与存量对象兼容要单独核对;不能仅凭 Helm revision 回退保证 CRD 回退。
故障域与容量规划¶
单机、多 CN、三台机器都不自动等于高可用。分别检查 Kubernetes 控制面、Logservice quorum、TN 状态恢复、CN/Proxy 入口和对象存储故障域。
将副本放到独立节点/可用区并配置调度约束;同一物理机上的多个 Pod 不提供机器故障隔离。CN 可扩展不意味着任意 TN 或存储故障都无中断。
CPU/内存请求与限制、磁盘容量/IOPS、缓存与 spill 空间、网络带宽分别规划。公开硬件表是起点,不是某数据量或并发量的性能承诺;按真实 SQL、事务大小、索引、向量/全文工作负载压测。
新建实例与接管已有数据不同。保留 UUID、Logservice hostname/身份、存储后端与路径;不能把新版示例配置直接覆盖到旧数据目录。
存储与网络检查¶
对象 |
部署前确认 |
|---|---|
S3/MinIO |
所有需要访问的 Pod 可解析 endpoint,TLS/CA、区域、凭证、bucket/prefix 与权限正确;故障恢复满足目标 |
本地/PVC |
哪些是持久状态、哪些是可重建缓存;挂载路径、容量、StorageClass、拓扑约束、保留策略和权限 |
数据格式 |
配置的 FileService backend 与已有数据一致;v4.2.5 示例使用 DISK-V2,不应盲目替换已有 DISK 数据目录配置 |
SQL 入口 |
客户端到 Proxy/CN 的路由、6001 或自定义端口、账号与 TLS;不要把 6001 当作所有内部通信端口 |
内部通信 |
按同版本配置开放 Logservice/Raft、HAKeeper、CN/TN RPC 与发现地址;测试跨节点 DNS/路由 |
运维入口 |
限制 metrics/debug/pprof 与 Kubernetes 管理接口访问;SQL 可连接不代表这些接口可公开 |
同一个 bucket 中的共享存储、备份、导出与 CDC 状态应明确区分 prefix 和权限。删除 PVC 与删除对象存储数据不是同一件事;Retain 也不构成独立备份。不要将整个共享数据 prefix 用作日常清理目标。
上线验收¶
MO_NAMESPACE=mo
MO_CLUSTER=mo
kubectl get matrixonecluster "$MO_CLUSTER" -n "$MO_NAMESPACE" -o wide
kubectl get pods,pvc,svc -n "$MO_NAMESPACE" -o wide
kubectl get events -n "$MO_NAMESPACE" --sort-by=.lastTimestamp
kubectl describe matrixonecluster "$MO_CLUSTER" -n "$MO_NAMESPACE"
对象名和 namespace 替换为自己的值。Pod Running、Ready 与真实业务正确性分别检查:
资源条件稳定,镜像与配置是批准版本,无持续重启、Pending 或存储错误。
从真实客户端入口认证,完成临时表读写事务;多 CN 时检查跨连接/跨 CN 可见性及失败处理。
用代表性查询建立延迟、错误率、吞吐、资源和存储空间基线;缓存未预热与稳定态分别记录。
在测试拓扑演练入口切换、CN/TN/Logservice/存储故障与恢复,测量中断窗口;不从副本数推导零中断。
独立目标完成恢复演练,核对行数、关键汇总、权限和外部依赖,再签署 RPO/RTO。
没有完整兼容矩阵、故障演练和恢复证据的组合标记为“待验证”。Helm lint、YAML 渲染和单 CN 测试不能替代生产上线验收。