PolarDB-X 集群暂停 / 恢复完整运维文档

PolarDB-X 集群暂停 / 恢复完整运维文档

（Kubernetes Operator 场景 · 适配当前环境）

一、背景与基本认知（非常重要）

1️⃣ PolarDB-X 没有传统意义的 shutdown

PolarDB-X没有数据库级别的 shutdown / stop 命令。
集群的运行状态完全由 Kubernetes Operator 控制。

因此：

• ❌ 不能shutdown database
• ❌ 不能只删 Pod
• ✅ 只能通过K8S 资源（Deployment / XStore / CR）来“暂停”

所谓“暂停”，本质是：
让 Operator 不再运行 CN / DN / GMS / CDC 的 Pod

二、组件角色与资源形态（基于你现场）

1️⃣ 组件与 K8S 资源映射

你现场 Pod 示例（已验证）：

polardbx-demo-t8ms-cn-default-xxxx polardbx-demo-t8ms-dn-0-cand-0 polardbx-demo-t8ms-gms-log-0 polardbx-demo-t8ms-cdc-default-xxxx

三、组件依赖关系（铁律）

GMS ← DN ← CN

含义：

• CN 启动前，DN + GMS 必须可用
• DN 启动前，GMS 必须可用
• GMS 不依赖任何组件

四、标准启停顺序（必须遵守）

⏸ 暂停（Pause）顺序

CN → CDC → DN → GMS

原因：

• 先断业务入口
• 再停数据访问
• 最后冻结元数据

▶ 恢复（Resume）顺序

GMS → DN → CN → CDC

原因：

• 元数据先可用
• DN 注册完成
• 最后开放业务入口

五、为什么patch PolarDBXCluster replicas=0不生效

你现场的真实现象

kubectl patch pxc replicas=0 → patched (no change) → Pod 一个没少 → PolarDBXCluster 仍显示 Running

根因总结

1. 当前 Operator 版本中

   • .spec.topology.*.replicas不是控制入口

2. DN / GMS 实际由 XStore CR 控制

3. Pod label不符合官方示例

   • 没有polardbx/role=cn

👉 结论：

你当前环境，不能用 patch pxc 来 pause

六、正确且可落地的暂停 / 恢复方案

控制策略总览

七、最终可用脚本（适配你当前环境）

📄 pxc-control.sh

#!/bin/bashset-eCLUSTER=$1ACTION=$2NS=${3:-default}if[[-z"$CLUSTER"||-z"$ACTION"]];thenecho"Usage:$0<cluster-name> pause|resume [namespace]"exit1fiK="kubectl -n$NS"pause(){echo"=== Pause PolarDB-X Cluster:$CLUSTER==="echo"[1/4] Stop CN"$Kscale deploy\-l polardbx/cluster=$CLUSTER,polardbx/component=cn\--replicas=0echo"[2/4] Stop CDC"$Kscale deploy\-l polardbx/cluster=$CLUSTER,polardbx/component=cdc\--replicas=0||trueecho"[3/4] Stop DN (XStore)"$Kscale xstore\-l polardbx/cluster=$CLUSTER\--replicas=0echo"[4/4] Stop GMS (XStore)"$Kscale xstore\-l polardbx/cluster=$CLUSTER,xstore-type=gms\--replicas=0||trueecho"=== Cluster paused ==="}resume(){echo"=== Resume PolarDB-X Cluster:$CLUSTER==="echo"[1/4] Start GMS"$Kscale xstore\-l polardbx/cluster=$CLUSTER,xstore-type=gms\--replicas=3echo"[2/4] Start DN"$Kscale xstore\-l polardbx/cluster=$CLUSTER\--replicas=3echo"[3/4] Start CN"$Kscale deploy\-l polardbx/cluster=$CLUSTER,polardbx/component=cn\--replicas=2echo"[4/4] Start CDC"$Kscale deploy\-l polardbx/cluster=$CLUSTER,polardbx/component=cdc\--replicas=1||trueecho"=== Cluster resumed ==="}case"$ACTION"inpause)pause;;resume)resume;;*)echo"Unknown action";exit1;;esac

八、使用方式

chmod+x pxc-control.sh# 暂停./pxc-control.sh polardbx-demo pause qfusion-admin# 恢复./pxc-control.sh polardbx-demo resume qfusion-admin

九、验证检查点（强烈建议执行）

暂停后

kubectl get pod -n qfusion-admin|greppolardbx-demo

预期：

• 无 CN / DN / GMS / CDC Pod

恢复后

kubectl get pod -n qfusion-admin|greppolardbx-demo

预期：

• GMS → DN → CN → CDC 依次 Running

十、常见误区总结

十一、运维级结论（建议写进团队规范）

**PolarDB-X 的暂停不是数据库命令，
而是 Operator 行为控制。

不同 Operator 版本，控制入口可能不同，
但启停顺序永远不变。**

如果你愿意，下一步我还能继续帮你做三件事之一：

1️⃣ 把这份文档整理成Markdown / Wiki 版
2️⃣ 脚本升级成自动识别 Operator 能力版
3️⃣ 补充异常场景 & 回滚 SOP