对齐文件规范

docs/02-04-nginx-worker-ingressroute.md

@@ -2,6 +2,14 @@
 
 > 场景：nginx 指定落在 ylc64（`nodeSelector: kubernetes.io/hostname: ylc64`），跨节点 IngressRoute 暴露 `/demo-m4`。整合于 `02-05-nginx-验证矩阵-一键部署.md`。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 02-04`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ## 前置条件
 
 - 已完成 `01-02-k3s-工作节点.md`
@@ -15,12 +23,12 @@
 2. 创建 Middleware + IngressRoute（`PathPrefix(/demo-m4)`）
 3. 等待资源就绪
 
-示例 YAML 见 `ansible/files/02-05-nginx-matrix/04-worker-ingressroute.yaml`。
+示例 YAML 见 `ansible/files/02-05/04-worker-ingressroute.yaml`。
 
 ## 部署命令
 
 ```bash
-kubectl apply -f ansible/files/02-05-nginx-matrix/04-worker-ingressroute.yaml
+kubectl apply -f ansible/files/02-05/04-worker-ingressroute.yaml
 ```
 
 ## 验证命令
@@ -39,7 +47,7 @@ curl -i --max-time 3 http://<入口节点IP>/demo-m4/
 ## 删除
 
 ```bash
-kubectl delete -f ansible/files/02-05-nginx-matrix/04-worker-ingressroute.yaml
+kubectl delete -f ansible/files/02-05/04-worker-ingressroute.yaml
 ```
 
 ## 失败排查
@@ -51,3 +59,9 @@ kubectl delete -f ansible/files/02-05-nginx-matrix/04-worker-ingressroute.yaml
 ## 下一步
 
 - 返回 `02-05-nginx-验证矩阵-一键部署.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`。