对齐文件规范

This commit is contained in:
2026-03-27 16:58:41 +08:00
parent 231b6713c4
commit 31709425e2
235 changed files with 5433 additions and 2850 deletions

View File

@@ -5,6 +5,13 @@
>
> 若需一键自动化安装多节点集群,可直接用 `01-06-节点初始化-ansible-实践.md`。
## TL;DR
- **自动化验收**:在控制端执行 `./scripts/verify.sh run 01-02`
- **手工加入 worker**:在 worker 上按本文执行 `k3s agent ...`(注意 token 路径与 `/storage` 方案)
- **成功判据**`kubectl get nodes` 中 worker 为 `Ready``kube-system` 中 Traefik 正常;入口 `:80` 可达(按本文验收命令)
- **失败排障**见本文「排障」小节token/防火墙/flannel/cni0/调度入口节点)
## 前置条件
- 已完成 `01-01-k3s-控制节点含traefik.md`
@@ -89,13 +96,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`),由 `k3s-init-and-install.yml` 自动打标签。
也可以在 [`ansible/group_vars/all.yml`](../ansible/group_vars/all.yml) 中配置入口节点列表 `k3s_ingress_nodenames`(示例:`ylc61``ylc62`),由 `01-06.yml``-e k3s_do_install=true`自动打标签。
运行:
```bash
cd ansible
ansible-playbook -i inventory.ini playbooks/k3s-init-and-install.yml
ansible-playbook -i inventory.ini playbooks/verify/01-06.yml
```
`k3s_ingress_nodenames` 为空默认Ansible 会对**所有节点**打入口标签,与早期行为一致;
@@ -133,11 +140,11 @@ curl -I --max-time 3 http://192.168.2.62:80
- `trusted` 中可看到 `flannel.1 cni0`
- 被标记为入口节点的 IP:80示例中为 `192.168.2.61``192.168.2.62`)可返回 Traefik 响应(常见 `404`
## 失败排查
## 排障
- 若出现 `502/跨节点不通/admin-prohibited`,看:`06-01-k3s-networkpolicy-故障排查.md`
## 下一步
- `02-00-nginx-系列说明.md``02-05-nginx-验证矩阵-一键部署.md`HTTP 入口与 Traefik 路由最小验证)
- `03-01-k3s-traefik-dashboard.md`
- `04-03-k3s-nginx-demo.md`