目录标题
- PolarDB-X 集群暂停 / 恢复完整运维文档
- 一、背景与基本认知（非常重要）
- 1️⃣ PolarDB-X 没有传统意义的 shutdown
- 二、组件角色与资源形态（基于你现场）
- 1️⃣ 组件与 K8S 资源映射
- 三、组件依赖关系（铁律）
- 四、标准启停顺序（必须遵守）
- ⏸ 暂停（Pause）顺序
- ▶ 恢复（Resume）顺序
- 五、为什么 `patch PolarDBXCluster replicas=0` 不生效
- 你现场的真实现象
- 根因总结
- 六、正确且可落地的暂停 / 恢复方案
- 控制策略总览
- 七、最终可用脚本（适配你当前环境）
- 📄 pxc-control.sh
- 八、使用方式
- 九、验证检查点（强烈建议执行）
- 暂停后
- 恢复后
- 十、常见误区总结
- 十一、运维级结论（建议写进团队规范）
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 资源映射
| 组件 | K8S 资源 | 说明 |
|---|---|---|
| CN | Deployment | SQL 入口，业务连接 |
| DN | XStore | 数据节点（cand / log 多 Pod） |
| GMS | XStore | 元数据服务（cand / log） |
| CDC | Deployment | Binlog / 同步组件 |
你现场 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根因总结
当前 Operator 版本中
.spec.topology.*.replicas不是控制入口
DN / GMS 实际由 XStore CR 控制
Pod label不符合官方示例
- 没有
polardbx/role=cn
- 没有
👉 结论：
你当前环境，不能用 patch pxc 来 pause
六、正确且可落地的暂停 / 恢复方案
控制策略总览
| 组件 | 正确控制方式 |
|---|---|
| CN | scale Deployment |
| CDC | scale Deployment |
| DN | scale XStore |
| GMS | scale XStore |
七、最终可用脚本（适配你当前环境）
📄 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
十、常见误区总结
| 误区 | 正确理解 |
|---|---|
| 删除 Pod | Operator 会自动拉起 |
| patch pxc replicas=0 | 当前环境不支持 |
| 用 Pod 名控制 | 必须用 label |
| 忽略顺序 | 极易引发异常 |
十一、运维级结论（建议写进团队规范）
**PolarDB-X 的暂停不是数据库命令，
而是 Operator 行为控制。不同 Operator 版本，控制入口可能不同，
但启停顺序永远不变。**
如果你愿意，下一步我还能继续帮你做三件事之一：
1️⃣ 把这份文档整理成Markdown / Wiki 版
2️⃣ 脚本升级成自动识别 Operator 能力版
3️⃣ 补充异常场景 & 回滚 SOP
