对齐文件规范

docs/03-09-k3s-gitops-集群配置管理.md

@@ -3,6 +3,14 @@
 > 本文先给出 GitOps 管理 k3s 集群的大致框架，后续可以按需要再细化成完整实践。
 > 目标：在 `01-06` 自动装好 k3s 之后，由 GitOps 工具（Argo CD / Flux）自动把 Traefik、监控、应用等 YAML 下发到集群。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 03-09`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ## 1. 选型与边界
 
 - GitOps 工具二选一：
@@ -54,3 +62,8 @@ homelab-k3s-gitops/
   - GitOps 仓库的完整示例结构；
   - 与 Cloudflare Tunnel、监控、openlist 等现有专题的映射关系。
 
+## 排障
+
+- **先看 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`。