对齐文件规范

docs/05-09-openclaw-web-小游戏网页平台.md

@@ -2,6 +2,14 @@
 
 > 在 K3s 中部署一个简单的 OpenClaw Web 前端（示例 Deployment/Service/Ingress），用于演示“静态站点/前端应用通过 Traefik 暴露”这一类场景。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 05-09`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ## 前置条件
 
 - 已完成基础集群安装：`01-01`、`01-02`
@@ -12,14 +20,14 @@
 
 | 项 | 路径 |
 |----|------|
-| 本篇清单 | [`ansible/files/05-09-openclaw-web-小游戏网页平台/openclaw-web.yml`](../ansible/files/05-09-openclaw-web-小游戏网页平台/openclaw-web.yml) |
-| 应用 | `kubectl apply -f ansible/files/05-09-openclaw-web-小游戏网页平台/openclaw-web.yml` |
-| 删除 | `kubectl delete -f ansible/files/05-09-openclaw-web-小游戏网页平台/openclaw-web.yml` |
+| 本篇清单 | [`ansible/files/05-09/openclaw-web.yml`](../ansible/files/05-09/openclaw-web.yml) |
+| 应用 | `kubectl apply -f ansible/files/05-09/openclaw-web.yml` |
+| 删除 | `kubectl delete -f ansible/files/05-09/openclaw-web.yml` |
 
 ## 部署与验证
 
 ```bash
-kubectl apply -f ansible/files/05-09-openclaw-web-小游戏网页平台/openclaw-web.yml
+kubectl apply -f ansible/files/05-09/openclaw-web.yml
 kubectl get deploy,svc,ing -n default | grep -i openclaw-web
 curl -I --max-time 5 http://openclaw.example.com/
 ```
@@ -35,3 +43,8 @@ curl -I --max-time 5 http://openclaw.example.com/
 - **502**：Service 无 Endpoints（Pod 未 Ready 或 selector 不匹配）。
 - **ImagePullBackOff**：镜像仓库不可达或未配置鉴权。
 
+## 排障
+
+- **先看 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`。