对齐文件规范

docs/03-08-k3s-ha-集群配置与切换.md

@@ -1,10 +1,18 @@
-# 03-09-k3s HA 集群配置与切换
+# 03-08-k3s HA 集群配置与切换
 
 > 本文只讲双控制节点 HA 的集群配置与切换步骤。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 03-08`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ## 前置条件
 
-- 已完成 `01-04-双控制节点ha.md` 安装准备
+- 已完成 `01-08-双控制节点ha.md` 安装准备
 - 外部 datastore 与 `6443` LB 已可用
 - 已确认可执行变更窗口
 
@@ -72,10 +80,16 @@ kubectl get pods -A
 
 ## 参考
 
-- `01-04-双控制节点ha.md`
+- `01-08-双控制节点ha.md`
 - `01-01-k3s-控制节点含traefik.md`
 - `01-02-k3s-工作节点.md`
 
 ## 下一步
 
 - 返回 00-00-构建总览.md，按导航继续。
+
+## 排障
+
+- **先看 playbook 输出**：失败时先定位是 deploy/wait/http_check 哪一步。
+- **集群侧总览**：`kubectl get nodes -o wide`、`kubectl -n kube-system get pods -o wide`。
+- **事件与日志**：`kubectl -n <ns> describe ...`、`kubectl -n <ns> logs ... --tail=200`。