对齐文件规范

docs/04-14-nodejs-GitOps与CI流水线.md

@@ -2,6 +2,14 @@
 
 > 从 **Node.js 应用仓库** 视角串联：**持续集成（CI）** 构建镜像并推送仓库，**持续交付** 通过 **GitOps** 或流水线步骤把声明式清单下发到 K3s。细节以仓库内 GitLab/GitOps 文档为准，本篇给 **最小闭环与引用**。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 04-14`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ## 前置条件
 
 - 集群可拉取镜像（私有仓库需 `imagePullSecrets`，见 `04-02` 相关说明）。
@@ -10,7 +18,7 @@
 ## 清单与仓库（唯一真源）
 
 - **本文无独立流水线 YAML**（GitLab CI、Argo CD、Flux 随版本变化大）；流程见 **`05-04`**、**`03-09`**。
-- **应用清单真源**：[`ansible/files/04-01-nodejs-demo/`](../ansible/files/04-01-nodejs-demo/)（例如 `04-01-nodejs-demo.yaml`）。将 **该目录或单文件** 纳入 Git，由 CI 改 `image:` tag 或由 GitOps 同步到集群。
+- **应用清单真源**：[`ansible/files/04-01/`](../ansible/files/04-01/)（例如 `04-14-nodejs-demo.yaml`）。将 **该目录或单文件** 纳入 Git，由 CI 改 `image:` tag 或由 GitOps 同步到集群。
 
 ## 场景说明（白话）
 
@@ -70,4 +78,10 @@ GitLab CI 示例结构与 Runner 注册见 **`05-04`**。
 - [`05-03-k3s-安装gitlab-含runner.md`](05-03-k3s-安装gitlab-含runner.md)
 - [`05-04-k3s-配置gitlab-cicd.md`](05-04-k3s-配置gitlab-cicd.md)
 - [`03-09-k3s-gitops-集群配置管理.md`](03-09-k3s-gitops-集群配置管理.md)
-- [`04-02-nodejs-镜像与运行命令.md`](04-02-nodejs-镜像与运行命令.md)
+- [`04-03-nodejs-镜像与运行命令.md`](04-03-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`。