对齐文件规范

docs/03-01-k3s-traefik-dashboard.md

@@ -2,6 +2,14 @@
 
 > 启用并访问 Traefik Dashboard，用于查看路由与服务状态。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 03-01`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ## 前置条件
 
 - Traefik 已正常运行
@@ -20,10 +28,10 @@
    - **默认路径**：`/var/lib/rancher/k3s/server/manifests/traefik-dashboard.yaml`
    - **自定义 data-dir**（如 `--data-dir=/storage`）：`<data-dir>/server/manifests/traefik-dashboard.yaml`
 
-   **唯一真源（勿与文档内联重复）**：[HelmChartConfig + IngressRoute 完整 YAML](../../ansible/files/03-01-traefik-dashboard/traefik-dashboard.yaml)。复制到上述 manifests 路径，或在仓库根执行：
+   **唯一真源（勿与文档内联重复）**：[HelmChartConfig + IngressRoute 完整 YAML](../../ansible/files/03-01/traefik-dashboard.yaml)。复制到上述 manifests 路径，或在仓库根执行：
 
    ```bash
-   kubectl apply -f ansible/files/03-01-traefik-dashboard/traefik-dashboard.yaml
+   kubectl apply -f ansible/files/03-01/traefik-dashboard.yaml
    ```
 
 2. 应用配置并等待 Traefik 重载（按实际路径选择其一复制执行）：
@@ -89,5 +97,11 @@ sudo rm -f /storage/server/manifests/traefik-dashboard.yaml
 
 ## 下一步
 
-- `04-03-k3s-nginx-demo.md`
+- `02-05-nginx-验证矩阵-一键部署.md`（若尚未做 HTTP 矩阵验证；可先读 `02-00-nginx-系列说明.md`）
 - `04-01-k3s-nodejs-高级部署.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`。