日常更新

docs/01-02-k3s-工作节点.md

@@ -3,11 +3,16 @@
 > 本文已合并原 `01-02-k3s-工作节点.md`。
 > 目标：完成工作节点加入 + Traefik 入口部署基线，并验证「**入口节点集合**的 `:80` 可达」。
 >
-> 若需一键自动化安装多节点集群，可直接用 `01-06-节点初始化-ansible-实践.md`。
+> 若需一键自动化安装多节点集群，可直接用 `01-05-节点初始化-ansible-实践.md`。
+
+## 契约与真源
+
+- **加入命令备忘**：`ansible/files/01-02/k3s-agent-join.example.sh`（与下文 curl/agent 片段一致）。
+- **自动**：`./ansible/bin/verify.sh run 01-02`（与手工步骤共用 `ansible/files/01-02/README.md` 索引）。
 
 ## TL;DR
 
-- **自动化验收**：在控制端执行 `./scripts/verify.sh run 01-02`
+- **自动化验收**：在控制端执行 `./ansible/bin/verify.sh run 01-02`
 - **手工加入 worker**：在 worker 上按本文执行 `k3s agent ...`（注意 token 路径与 `/storage` 方案）
 - **成功判据**：`kubectl get nodes` 中 worker 为 `Ready`；`kube-system` 中 Traefik 正常；入口 `:80` 可达（按本文验收命令）
 - **失败排障**：见本文「排障」小节（token/防火墙/flannel/cni0/调度入口节点）
@@ -96,13 +101,13 @@ kubectl label node ylc62 svccontroller.k3s.cattle.io/lbpool=edge --overwrite
 
 ### 3.2 Ansible 方式（推荐，集中管理入口节点）
 
-也可以在 [`ansible/group_vars/all.yml`](../ansible/group_vars/all.yml) 中配置入口节点列表 `k3s_ingress_nodenames`（示例：`ylc61`、`ylc62`），由 `01-06.yml`（`-e k3s_do_install=true`）自动打标签。
+也可以在 [`ansible/group_vars/all.yml`](../ansible/group_vars/all.yml) 中配置入口节点列表 `k3s_ingress_nodenames`（示例：`ylc61`、`ylc62`），由 `01-05.yml`（`-e k3s_do_install=true`）自动打标签。
 
 运行：
 
 ```bash
 cd ansible
-ansible-playbook -i inventory.ini playbooks/verify/01-06.yml
+ansible-playbook -i inventory.ini playbooks/verify/01-05.yml
 ```
 
 若 `k3s_ingress_nodenames` 为空（默认），Ansible 会对**所有节点**打入口标签，与早期行为一致；