对齐文件规范

docs/05-03-k3s-安装gitlab-含runner.md

@@ -2,6 +2,14 @@
 
 > 通过 Helm 在 K3s 部署 GitLab，并接入 Runner 执行 CI 任务。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 05-03`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ---
 
 ## 前置条件
@@ -131,7 +139,7 @@ sudo gitlab-runner register \
   --non-interactive
 ```
 
-在 `.gitlab-ci.yml` 中即可按需指定不同架构运行 Job，示例见 [`ansible/files/05-03-gitlab-runner/gitlab-ci-runner-tags.example.yml`](../ansible/files/05-03-gitlab-runner/gitlab-ci-runner-tags.example.yml)。
+在 `.gitlab-ci.yml` 中即可按需指定不同架构运行 Job，示例见 [`ansible/files/05-03/gitlab-ci-runner-tags.example.yml`](../ansible/files/05-03/gitlab-ci-runner-tags.example.yml)。
 
 ---
 
@@ -154,3 +162,8 @@ kubectl -n gitlab get svc
 - `05-04-k3s-配置gitlab-cicd.md`
 - `03-04-k3s-cloudflare-tunnel-配置接入.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`。