对齐文件规范

docs/04-13-nodejs-HPA.md

@@ -2,16 +2,24 @@
 
 > 为 `nodejs-demo` 配置 **HorizontalPodAutoscaler**，按 CPU/内存等指标在 `minReplicas`～`maxReplicas` 间自动伸缩。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 04-13`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ## 前置条件
 
 - 集群已安装 **metrics-server**（K3s 常默认启用；`kubectl top nodes` 可用即基本就绪）。
-- Deployment 已配置 **`resources.requests`**（CPU 指标 HPA 依赖 requests），见 [`04-05-nodejs-资源请求与限制.md`](04-05-nodejs-资源请求与限制.md)。
-- 建议已配置 **readinessProbe**（[`04-06-nodejs-探针与健康检查.md`](04-06-nodejs-探针与健康检查.md)），避免扩容出未就绪 Pod。
+- Deployment 已配置 **`resources.requests`**（CPU 指标 HPA 依赖 requests），见 [`04-08-nodejs-资源请求与限制.md`](04-08-nodejs-资源请求与限制.md)。
+- 建议已配置 **readinessProbe**（[`04-05-nodejs-探针与健康检查.md`](04-05-nodejs-探针与健康检查.md)），避免扩容出未就绪 Pod。
 
 ## 清单路径（唯一真源）
 
-| 本篇完整清单（含 Deployment/Service/Ingress/PVC/CM + **HPA**） | [`ansible/files/04-01-nodejs-demo/04-13-nodejs-demo.yaml`](../ansible/files/04-01-nodejs-demo/04-13-nodejs-demo.yaml) |
-| 应用 | `kubectl apply -f ansible/files/04-01-nodejs-demo/04-13-nodejs-demo.yaml`（若用 `04-12`，需先有 TLS Secret） |
+| 本篇完整清单（含 Deployment/Service/Ingress/PVC/CM + **HPA**） | [`ansible/files/04-01/04-13-nodejs-demo.yaml`](../ansible/files/04-01/04-13-nodejs-demo.yaml) |
+| 应用 | `kubectl apply -f ansible/files/04-01/04-13-nodejs-demo.yaml`（若用 `04-12`，需先有 TLS Secret） |
 
 ## 场景说明（白话）
 
@@ -27,7 +35,7 @@
 ## 部署与验证
 
 ```bash
-kubectl apply -f ansible/files/04-01-nodejs-demo/04-13-nodejs-demo.yaml
+kubectl apply -f ansible/files/04-01/04-13-nodejs-demo.yaml
 kubectl get hpa -n default
 kubectl describe hpa nodejs-demo -n default
 ```
@@ -49,5 +57,11 @@ kubectl delete hpa nodejs-demo -n default
 
 ## 相关文档
 
-- [`04-11-nodejs-副本与滚动发布.md`](04-11-nodejs-副本与滚动发布.md)
+- [`04-06-nodejs-副本与滚动发布.md`](04-06-nodejs-副本与滚动发布.md)
 - [`05-05-prometheus与grafana.md`](05-05-prometheus与grafana.md)（自定义 metrics 进阶，本文不展开）
+
+## 排障
+
+- **先看 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`。