日常更新

docs/05-05-prometheus与grafana.md

@@ -2,10 +2,15 @@
 
 > 使用 `kube-prometheus-stack` 建立基础可观测能力。
 
+## 契约与真源
+
+- **Helm values 示例**：`ansible/files/05-05/kube-prometheus-stack-values.example.yaml`（见同目录 `README.md`）。
+- **手动**：下文 `helm` 命令；可将 `-f ansible/files/05-05/kube-prometheus-stack-values.example.yaml` 传给 `helm upgrade --install`。
+- **自动**：`./ansible/bin/verify.sh run 05-05`（与上述路径同一真源，便于对照；当前为 noop + 集群基线）。
 
 ## TL;DR
 
-- **自动化验收**：`./scripts/verify.sh run 05-05`
+- **自动化验收**：`./ansible/bin/verify.sh run 05-05`
 - **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
 - **成功判据**：达到本文「预期」且 playbook 断言通过
 - **排障**：见本文「排障」
@@ -25,7 +30,8 @@
 helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
 helm repo update
 kubectl create namespace monitoring
-helm upgrade --install monitoring prometheus-community/kube-prometheus-stack -n monitoring
+helm upgrade --install monitoring prometheus-community/kube-prometheus-stack -n monitoring \
+  -f ansible/files/05-05/kube-prometheus-stack-values.example.yaml
 ```
 
 ## 验证命令