Deploy-Laboratory/docs/00-00-构建总览.md

00-00-构建总览

本仓库主文档入口。建议从这里开始阅读。

目录约定

• 文档：docs/（Kubernetes 等可复用清单见 ansible/files/，与 Ansible playbook 共用）
• 脚本：scripts/
• 脚本入口：scripts/README.md

编号含义速查

• 00-**：总览与基础概念（入口、索引、验证矩阵、部署环境说明、未来规划）
• 01-**：安装与基础环境（控制节点/工作节点/OpenWrt HAProxy/Cloudflare/NFS 等）
• 02-**：Nginx 矩阵分篇场景说明（M1～M4 各场景独立页；综合一键部署见 02-05）
• 03-**：集群侧配置扩展；03-04～03-10 按推荐阅读顺序编号（Traefik 自定义端口 → Tunnel → local-path → NFS → Longhorn → HA → GitOps）
• 04-**：Node.js 高级部署（04-01 主入口 + 04-02～04-14 部署分项；与 nginx 矩阵编号无强制对应）
• 05-**：常用应用部署（Homer、OneNav、GitLab、监控、openlist 等）
• 06-**：排障与运维总结（NetworkPolicy 排查、运维小结）

---

推荐安装顺序

1. 00-01-k3s-基础概念.md
2. 01-01-k3s-控制节点含traefik.md（或直接用 01-07-节点初始化-ansible-实践.md 一键自动化）
3. 01-02-k3s-工作节点.md
4. 01-03-armv7-standalone-docker.md
5. 01-04-cloudflare-tunnel.md
6. 01-08-openwrt-haproxy.md（按需：网关负载均衡）
7. 04-03-k3s-nginx-demo.md
8. 04-01-k3s-nodejs-高级部署.md
9. 04-02-nodejs-镜像与运行命令.md
10. 04-03-nodejs-环境变量与配置注入.md
11. 04-04-nodejs-端口与Service.md
12. 04-05-nodejs-资源请求与限制.md
13. 04-06-nodejs-探针与健康检查.md
14. 04-07-nodejs-调度与亲和.md
15. 04-08-nodejs-安全上下文.md
16. 04-09-nodejs-存储与卷.md
17. 04-10-nodejs-Ingress与Traefik.md
18. 04-11-nodejs-副本与滚动发布.md
19. 04-12-nodejs-TLS与证书.md
20. 04-13-nodejs-HPA.md
21. 04-14-nodejs-GitOps与CI流水线.md
22. 02-05-nginx-验证矩阵-一键部署.md（建议先读 02-00-nginx-系列说明.md）
23. 03-01-k3s-traefik-dashboard.md
24. 03-02-k3s-traefik-acme.md
25. 03-03-k3s-traefik-dashboard-acme.md（推荐顺序：先 03-01、03-02）
26. 03-04-k3s-cloudflare-tunnel-配置接入.md（按需：Cloudflare Tunnel 接入集群）
27. 03-05-k3s-local-path-pvc.md（K3s 自带 local-path，单副本本地持久化）
28. 03-06-k3s-使用nfs存储.md（按需：已有 NFS 时 PV/PVC）
29. 03-07-k3s-longhorn-持久化存储.md（重状态、快照/备份，建议部署 GitLab 等前统一规划）
30. 03-08-k3s-ha-集群配置与切换.md（按需：双控制节点 HA，配合 01-05）
31. 03-09-k3s-gitops-集群配置管理.md（框架草案：Argo CD / Flux）

想确认这些步骤是否已经在真实环境验证，请查看 00-02-验证矩阵.md。 本仓库验证环境说明见 00-04-部署环境说明.md。

---

主线导航

• 01-02-k3s-工作节点.md
• 03-01-k3s-traefik-dashboard.md
• 04-03-k3s-nginx-demo.md
• 04-01-k3s-nodejs-高级部署.md（文末：04-02～04-14 Node.js 部署分项）
• 03-02-k3s-traefik-acme.md
• 03-04-k3s-cloudflare-tunnel-配置接入.md
• 03-05-k3s-local-path-pvc.md
• 03-06-k3s-使用nfs存储.md
• 03-07-k3s-longhorn-持久化存储.md
• 06-01-k3s-networkpolicy-故障排查.md

---

矩阵导航

矩阵文档（M1~M8）：02-01～02-04 为 M1～M4 分篇说明，02-05 为综合一键部署。实际部署用 02-05 或 Ansible。

• 02-00-nginx-系列说明.md
• 02-01-nginx-control-ingress.md（M1）
• 02-02-nginx-control-ingressroute.md（M2）
• 02-03-nginx-worker-ingress.md（M3）
• 02-04-nginx-worker-ingressroute.md（M4）
• 02-05-nginx-验证矩阵-一键部署.md（HTTP-only 综合部署）

说明：若曾规划「Node.js 与 nginx 对照」的 M1～M4 矩阵独立文档，尚未在本仓库落盘；当前 04-05～04-08 已用于 Node.js 部署分项（资源/探针/调度/安全）。后续若补充 Node.js 矩阵，请另起编号（例如 04-20 起或归入专题），避免与现有 04-** 冲突。

---

专题导航

• 00-04-部署环境说明.md（节点布局、IP、OS、K3s 版本等，便于对照与复现）

• 01-07-节点初始化-ansible-实践.md（Ansible 一键安装 k3s 集群，已验证）

• 01-08-openwrt-haproxy.md（按需：网关负载均衡）

• nginx 矩阵：ansible/playbooks/nginx-matrix-deploy.yml（02-05）、ansible/playbooks/nginx-matrix-tls-deploy.yml（03-02）

• 01-04-cloudflare-tunnel.md（安装准备）

• 03-04-k3s-cloudflare-tunnel-配置接入.md（集群接入）

• 05-03-k3s-安装gitlab-含runner.md

• 05-04-k3s-配置gitlab-cicd.md

• 05-01-k3s-部署homer首页面板.md

• 05-02-onenav首页面板.md

• 05-05-prometheus与grafana.md

• 05-07-openclaw应用部署.md

• 05-08-openclaw-k3s-实验部署.md

• 01-06-armv7-nfs服务安装.md

• 05-06-openlist挂载网盘与自动备份.md

• 06-02-运维小结.md

• 01-05-双控制节点ha.md

• 03-08-k3s-ha-集群配置与切换.md

• 03-09-k3s-gitops-集群配置管理.md（框架草案）

---

排障入口

• 文档：06-01-k3s-networkpolicy-故障排查.md
• 脚本：scripts/README.md

---

未来规划

• 00-03-未来规划与待补功能.md：记录还没做、但已经想到的能力清单与路线图，方便以后按需补齐。