日常更新

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

@@ -1,12 +1,17 @@
 # 03-09-k3s-gitops-集群配置管理（框架草案）
 
 > 本文先给出 GitOps 管理 k3s 集群的大致框架，后续可以按需要再细化成完整实践。
-> 目标：在 `01-06` 自动装好 k3s 之后，由 GitOps 工具（Argo CD / Flux）自动把 Traefik、监控、应用等 YAML 下发到集群。
+> 目标：在 `01-05` 自动装好 k3s 之后，由 GitOps 工具（Argo CD / Flux）自动把 Traefik、监控、应用等 YAML 下发到集群。
 
+## 契约与真源
+
+- **本仓库示意**：`ansible/files/03-09/argocd-namespace.example.yaml`（极简 Namespace；正式安装请用 Argo CD 官方 `install.yaml` 或 Helm），索引见 `ansible/files/03-09/README.md`。
+- **主真源**：独立 GitOps 仓库（见下文「仓库结构建议」）；本目录仅与文档对齐的辅助文件。
+- **手动 / 自动**：`kubectl apply -f ansible/files/03-09/argocd-namespace.example.yaml` 可与 `./ansible/bin/verify.sh run 03-09` 共用同一路径，避免文档与仓库脱节。
 
 ## TL;DR
 
-- **自动化验收**：`./scripts/verify.sh run 03-09`
+- **自动化验收**：`./ansible/bin/verify.sh run 03-09`
 - **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
 - **成功判据**：达到本文「预期」且 playbook 断言通过
 - **排障**：见本文「排障」
@@ -51,8 +56,8 @@ homelab-k3s-gitops/
 
 ## 4. 与现有文档的衔接
 
-- `01-06-节点初始化-ansible-实践.md`：负责从「可 SSH 裸机」到「k3s 就绪」；
-- 本篇 `03-11`：负责从「k3s 就绪」到「配置由 Git 驱动下发」；
+- `01-05-节点初始化-ansible-实践.md`：负责从「可 SSH 裸机」到「k3s 就绪」；
+- 本篇 `03-09`：负责从「k3s 就绪」到「配置由 Git 驱动下发」；
 - 其他 `02-**`、`04-**`、`05-**` 文档中的部署命令，可以逐步迁移为 GitOps 仓库中的 YAML/Kustomize/Helm 定义。
 
 ## 5. 后续可以补充的内容（TODO）