zh: how to suspend a tidb cluster

Author: fgksgf

zh/TOC.md

@@ -22,6 +22,7 @@
     - 运维
         - [查看 TiDB 日志](view-logs.md)
         - [销毁 TiDB 集群](destroy-a-tidb-cluster.md)
+        - [挂起 TiDB 集群](suspend-tidb-cluster.md)
         - 为 TiDB 集群更换节点
     - 灾难恢复
 - 故障诊断

zh/suspend-tidb-cluster.md

@@ -0,0 +1,69 @@
+---
+title: 挂起 TiDB 集群
+summary: 了解如何通过配置挂起 Kubernetes 上的 TiDB 集群。
+---
+
+# 挂起 TiDB 集群
+
+本文介绍如何通过配置 `Cluster` 对象来挂起 Kubernetes 上的 TiDB 集群。挂起集群会停止所有组件的 Pod，保留 `Cluster` 对象以及其他资源（例如 Service、PVC 等）。
+
+## 使用场景
+
+挂起 TiDB 集群适用于以下场景:
+- 测试环境中需要临时释放计算资源
+- 长期不使用的开发集群
+- 需要临时停止集群但保留数据和配置
+
+## 注意事项
+- 挂起操作会导致集群服务中断
+- 已有的连接会被强制断开
+- PVC 和数据仍然会占用存储空间
+- 集群相关的 Service 和配置保持不变
+
+## 配置挂起 TiDB 集群
+
+如果你需要挂起 TiDB 集群，执行以下步骤：
+
+1. 在 `Cluster` 对象中，配置 `spec.suspendAction` 字段，挂起整个 TiDB 集群：
+
+    ```yaml
+    apiVersion: core.pingcap.com/v1alpha1
+    kind: Cluster
+    metadata:
+      name: ${cluster_name}
+      namespace: ${namespace}
+    spec:
+      suspendAction:
+        suspendCompute: true
+      # ...
+    ```
+
+2. 挂起 TiDB 集群后，通过以下命令观察到 TiDB 集群的 Pod 逐步被删除：
+
+    ```shell
+    kubectl -n ${namespace} get pods -w
+    ```
+
+## 恢复 TiDB 集群
+
+在 TiDB 集群被挂起后，如果需要恢复 TiDB 集群，执行以下步骤：
+
+1. 在 `Cluster` 对象中，配置 `spec.suspendAction` 字段，恢复被挂起的整个 TiDB 集群：
+
+    ```yaml
+    apiVersion: core.pingcap.com/v1alpha1
+    kind: Cluster
+    metadata:
+      name: ${cluster_name}
+      namespace: ${namespace}
+    spec:
+      suspendAction:
+        suspendCompute: false
+      # ...
+    ```
+
+2. 恢复 TiDB 集群后，通过以下命令观察到 TiDB 集群的 Pod 逐步被创建：
+
+    ```shell
+    kubectl -n ${namespace} get pods -w
+    ```