10 KiB
10 KiB
00-02-验证矩阵
这一页只做一件事：集中标记每篇关键文档是否已经在真实环境验证过。
清单位置：可部署的 Kubernetes YAML 以仓库
ansible/files/为唯一真源（与docs/交叉引用）；验证时请以该目录下文件为准。写文档的人、做实验的人，都以这里为准，不用在每篇文档里翻记录。
状态说明
- ❓ 未验证：内容结构与命令已经写好，但还没有在目标环境完整跑通一次。
- ⚠️ 部分验证：只验证了其中一部分场景（例如只在单节点环境跑过，或只验证了 HTTP 未验证 HTTPS），备注里会写明覆盖范围。
- ✅ 已验证：按该文档从头到尾在指定环境走完一遍，达到预期结果，备注里会带上环境与日期。
建议习惯：
- 真机按文档全部走完后，再把状态从“未验证/部分验证”改成“已验证”，并写清 OS / K3s 版本 / 时间。
- 以后如果对文档步骤做了较大调整，记得把这里对应条目先打回“未验证”或“部分验证”，等新流程再跑一遍。
1. 主线安装（01-*）
00-01-k3s-基础概念.md- 状态：✅ 已验证
- 备注：概念性文档，不涉及命令执行。
00-04-部署环境说明.md- 状态：✅ 已验证
- 备注：说明性文档，描述本仓库验证环境（ylc61~64、Fedora、K3s v1.34.5+k3s1、/storage 等），与当前实际部署一致。
01-01-k3s-控制节点含traefik.md- 状态：✅ 已验证
- 备注：Fedora 43 Server + K3s v1.34.5+k3s1，单控制节点 61，已按文档装机并确认 Traefik 入口 404 可达（2026-03-10 左右）。
01-07-节点初始化-ansible-实践.md- 状态：✅ 已验证
- 备注：Fedora + K3s，4 节点（ylc61~64），Ansible 一键完成初始化、server/agent 安装、firewalld 基线、Traefik 标签及验证输出（2026-03 左右）。
01-02-k3s-工作节点.md- 状态：✅ 已验证
- 备注：在同一环境下成功加入工作节点 62，并通过
kubectl get nodes看到双节点 Ready（2026-03-10 左右）。
01-03-armv7-standalone-docker.md- 状态：❓ 未验证
- 备注：待在实际 armv7 设备上按文档安装 Docker 并跑一两个容器后更新。
01-04-cloudflare-tunnel.md- 状态：⚠️ 部分验证
- 备注：Cloudflare 控制台端（Tunnel/域名）已实践使用，需在新环境对完整安装准备流程再跑一遍。
01-08-openwrt-haproxy.md- 状态：❓ 未验证
- 备注：OpenWrt 网关负载均衡，转发 80/443 到 K3s 节点；2026-03 文档调整（健康检查 TCP/HTTP/TLS/HTTPS 四类、send-proxy-v2 示例），待在实际 OpenWrt 设备上验证。
2. 简单部署nginx（02-*）
02-00-nginx-系列说明.md- 状态：❓ 未验证（说明性文档）
- 备注：整理节点调度与 Ingress/IngressRoute 差异，后续按需补齐验证信息。
02-01-nginx-control-ingress.md- 状态：❓ 未验证
- 备注：待在控制节点上按文档部署 nginx + Ingress，并通过 curl/浏览器验证。
02-02-nginx-control-ingressroute.md- 状态：❓ 未验证
- 备注：同上，使用 IngressRoute 验证基本路由链路。
02-03-nginx-worker-ingress.md- 状态：❓ 未验证
- 备注：待在工作节点流量路径上完成 nginx Ingress 验证。
02-04-nginx-worker-ingressroute.md- 状态：❓ 未验证
- 备注：同上，IngressRoute 变体。
02-05-nginx-验证矩阵-一键部署.md- 状态：✅ 已验证（4 种组合 M1～M4 整合）
- 备注：HTTP-only（无域名学习）；有域名时用 03-02 升级版。
3. k3s 常用配置
02-00-nginx-系列说明.md- 状态：❓ 未验证（说明性文档）
- 备注：整理节点调度与 Ingress/IngressRoute 差异（nodeSelector/labels/tolerations 通用排查思路），后续按需补齐验证信息。
03-01-k3s-traefik-dashboard.md- 状态：✅ 已验证
- 备注：在 61/62/63/64 环境各节点启用过 Dashboard 并确认能访问，日志正常。模板：
ansible/files/traefik-dashboard/traefik-dashboard.yaml。
03-02-k3s-traefik-acme.md- 状态：✅ 已验证
- 备注：02-05 的升级版（TLS 矩阵 + ACME）；2026-03 实机跑通。
03-03-k3s-traefik-dashboard-acme.md- 状态：⚠️ 部分验证
- 备注：ACME 配置已与 03-02 对齐（03-02 已实机验证）；Dashboard + ACME 合并流程待实机跑一遍。模板：
ansible/files/traefik-dashboard-acme/traefik-dashboard-acme.yaml。
03-04-k3s-cloudflare-tunnel-配置接入.md- 状态：⚠️ 部分验证
- 备注：cloudflared 侧部署与 Tunnel 接入已在其他项目跑通过，本实验室集群的完整接入流程待实机验证。
03-05-k3s-local-path-pvc.md- 状态：❓ 未验证
- 备注：K3s 自带 local-path-provisioner，PVC 本地持久化；待实机验证。
03-06-k3s-使用nfs存储.md- 状态：❓ 未验证
- 备注：待在实际 NFS 服务器 + K3s 集群上完成 PV/PVC + Pod 挂载验证。
03-07-k3s-longhorn-持久化存储.md- 状态：❓ 未验证
- 备注：Longhorn 安装与 PVC 流程待在本环境实机验证。
03-08-k3s-ha-集群配置与切换.md- 状态：❓ 未验证
- 备注：HA 场景步骤已整理，尚未在当前环境完成双 server + 切换演练。
03-09-k3s-gitops-集群配置管理.md- 状态：❓ 未验证
- 备注：框架草案，待选定 Argo CD 或 Flux 后细化。
可选：依赖文档
01-05-双控制节点ha.md- 状态：❓ 未验证
- 备注：文档已拆分安装/配置流程，尚未在双控制节点 + 外部 LB 的完整场景下全链路验证。
01-06-armv7-nfs服务安装.md- 状态：❓ 未验证
- 备注：NFS 安装命令已经过以往经验验证，本仓库对应 armv7 环境需再跑一遍确认导出与权限。
4. 高级 Node.js（04-01～04-14）
04-01-k3s-nodejs-高级部署.md- 状态：❓ 未验证
- 备注：主入口；具体能力验证依赖
04-02～04-14分项。
04-02-nodejs-镜像与运行命令.md- 状态：❓ 未验证
- 备注：镜像 tag/
imagePullPolicy/command/args在实机拉取与启动验证。
04-03-nodejs-环境变量与配置注入.md- 状态：❓ 未验证
- 备注：ConfigMap/Secret 注入与
printenv/curl结果一致。
04-04-nodejs-端口与Service.md- 状态：❓ 未验证
- 备注：
targetPort与进程监听一致；Endpoints 有地址。
04-05-nodejs-资源请求与限制.md- 状态：❓ 未验证
- 备注：
kubectl top与 OOM/节流行为符合预期。
04-06-nodejs-探针与健康检查.md- 状态：❓ 未验证
- 备注：readiness/liveness 与 Endpoint/重启行为验证。
04-07-nodejs-调度与亲和.md- 状态：❓ 未验证
- 备注：
nodeSelector/亲和/容忍与节点标签实机一致。
04-08-nodejs-安全上下文.md- 状态：❓ 未验证
- 备注：非 root/只读根等策略下应用仍可运行。
04-09-nodejs-存储与卷.md- 状态：❓ 未验证
- 备注：PVC/emptyDir 挂载与读写、配合
03-05/03-07存储选型。
04-10-nodejs-Ingress与Traefik.md- 状态：❓ 未验证
- 备注：path/host/入口点注解与 Traefik 路由一致。
04-11-nodejs-副本与滚动发布.md- 状态：❓ 未验证
- 备注：多副本与
rollout/undo实机验证。
04-12-nodejs-TLS与证书.md- 状态：❓ 未验证
- 备注：HTTPS 与
03-02ACME/Secret 配合验证证书与域名。
04-13-nodejs-HPA.md- 状态：❓ 未验证
- 备注：metrics-server 可用；压测触发扩缩。
04-14-nodejs-GitOps与CI流水线.md- 状态：❓ 未验证
- 备注：流程文档；按
05-03/05-04/03-09任选一条链路实机跑通后更新。
5. 常用应用与监控（05-*）
05-01-k3s-部署homer首页面板.md- 状态：❓ 未验证
- 备注：待在集群内按文档部署 Homer，并确认首页可访问。
05-02-onenav首页面板.md- 状态：❓ 未验证
- 备注：包含 armv7 独立部署 + K3s 反向代理两个部分，需分别验证。
05-03-k3s-安装gitlab-含runner.md- 状态：❓ 未验证
- 备注：待完成 GitLab + Runner 安装与基础流水线运行。
05-04-k3s-配置gitlab-cicd.md- 状态：❓ 未验证
- 备注：需在真实仓库上跑通一次 K3s 部署流水线。
05-05-prometheus与grafana.md- 状态：❓ 未验证
- 备注：待完成 kube-prometheus-stack 安装与 Dashboard 访问。
05-06-openlist挂载网盘与自动备份.md- 状态：❓ 未验证
- 备注：待在实际网盘与备份目录上验证周期备份任务。
05-07-openclaw应用部署.md- 状态：❓ 未验证
- 备注：待在 x86 主机用 Docker 部署 OpenClaw，并在 K3s 中完成静态转发验证。
05-08-openclaw-k3s-实验部署.md- 状态：❓ 未验证
- 备注：待在 K3s 内按实验文档直接部署 OpenClaw Gateway，并确认入口可访问。
6. 排障与运维（06-*）
06-01-k3s-networkpolicy-故障排查.md- 状态：✅ 已验证
- 备注：已在 Fedora 43 + K3s 环境排查并修复过“62:80 不通 / firewalld 拦截 flannel.1 <-> cni0”的问题，脚本与命令均来自实战过程。
06-02-运维小结.md- 状态：❓ 未验证
- 备注：运维建议为经验总结，后续可在日常巡检/备份流程固化后逐条打勾。
8. 如何更新本矩阵
- 修改某篇文档的关键步骤（尤其是“操作步骤 / 验证命令 / 预期”）时：
- 记得同步更新这里对应条目的“状态”和“备注”。
- 大改后建议先把状态退回“未验证”或“部分验证”，等新流程在实机跑完再改回“已验证”。
- 执行中文文档一键安全对齐或大规模内容调整时，建议把 验证矩阵 一起纳入检查范围，避免出现“文档已经改了，但矩阵还显示已验证”的错觉。