日常更新

This commit is contained in:
2026-03-29 09:08:01 +08:00
parent 31709425e2
commit befdefd222
224 changed files with 7240 additions and 3297 deletions

View File

@@ -14,7 +14,8 @@
- 脚本主入口:`scripts/README.md`
- 仓库契约AI/贡献者必读):`project-context.md`真源、验证框架、noop/gate、敏感信息约束
- 测试与验证框架设计:`docs/00-03-测试与验证框架.md`
- **验证入口**`./scripts/verify.sh``full/run-all/run`
- **验证入口**`./ansible/bin/verify.sh``full/run-all/run`;单篇简写 `./scripts/cs <XX-YY>`(与 `verify.sh run` 等价,**任意执行域 doc_id 通用**
- **Helm**:家庭实验里装 Longhorn、监控栈等常用CLI 与环境见 `docs/00-02-部署环境说明.md`,各篇索引见 `docs/00-03-测试与验证框架.md` §1.1。
编号语义(用于快速判断“是否必须可执行”):
@@ -27,7 +28,7 @@
- `README.md`:新手入口,看「要做什么、按什么顺序做」;
- `docs/00-00-构建总览.md`:文档导航 + **学习主线6 步)**与**附录长单**
- `docs/00-01-k3s-基础概念.md`:概念速查,看「不懂的 K3s/Traefik/NetworkPolicy 术语」;
- `./scripts/verify.sh`:按 `doc_id` 的自动化验证入口(`full/run-all/run`;清单由 `ansible/playbooks/verify/` 自动生成,且仅包含执行域 `XX>0 && YY>0`)。
- `./ansible/bin/verify.sh`:按 `doc_id` 的自动化验证入口(`full/run-all/run`;清单由 `ansible/playbooks/verify/` 自动生成,且仅包含执行域 `XX>0 && YY>0`)。
目录约定:
@@ -40,9 +41,9 @@
1. **总览与环境**:读 `docs/00-00-构建总览.md`;需要对照机器与版本时打开 `docs/00-02-部署环境说明.md`
2. **概念速查(可跳过)**:读 `docs/00-01-k3s-基础概念.md`;时间紧可跳过,**碰壁再回来看**。
3. **安装 K3s二选一****自动化** — `docs/01-06-节点初始化-ansible-实践.md`,或仓库根执行 `./scripts/deploy-lab.sh k3s`(可选 `K3S_PREPARE_STORAGE=true`,详见 `scripts/README.md`**手动** — `docs/01-01-k3s-控制节点含traefik.md``docs/01-02-k3s-工作节点.md`
3. **安装 K3s二选一****自动化** — `docs/01-05-节点初始化-ansible-实践.md`,或仓库根执行 `./ansible/bin/deploy-lab.sh k3s`(可选 `K3S_PREPARE_STORAGE=true`,详见 `scripts/README.md`**手动** — `docs/01-01-k3s-控制节点含traefik.md``docs/01-02-k3s-工作节点.md`
4. **确认节点 Ready**`kubectl get nodes`,全部 Ready。
5. **Nginx 最小验证**`docs/02-00-nginx-系列说明.md``docs/02-05-nginx-验证矩阵-一键部署.md`,先打通「能访问」;也可在装好集群并配置 `.env.verify` 后直接 `./scripts/verify.sh run 02-05`
5. **Nginx 最小验证**`docs/02-00-nginx-系列说明.md``docs/02-05-nginx-验证矩阵-一键部署.md`,先打通「能访问」;也可在装好集群并配置 `.env.verify` 后直接 `./ansible/bin/verify.sh run 02-05`
6. **Node.js 主线入口**`docs/04-01-k3s-nodejs-高级部署.md``docs/04-02``04-14` 为分项,**按需展开**,不挤进主线编号。
**主线之后(按需,不占主线序号)**Traefik 面板与证书(如 `docs/03-01-k3s-traefik-dashboard.md``docs/03-02-k3s-traefik-acme.md`)、存储与应用(`03-05` 起、`05-**`)等 — 见总览中的「主线之后的分叉」与专题导航。
@@ -53,7 +54,7 @@
相当于**跳过主线第 2 步(概念)**并**压缩第 1 步(只抓总览要点)**;跑通再按 6 步补全。
1. **装集群**Ansible 按 `docs/01-06-节点初始化-ansible-实践.md`(推荐);或 `docs/01-01` + `docs/01-02` 手动装控制节点61与工作节点62
1. **装集群**Ansible 按 `docs/01-05-节点初始化-ansible-实践.md`(推荐);或 `docs/01-01` + `docs/01-02` 手动装控制节点61与工作节点62
2. `kubectl get nodes`,确认节点 Ready。
3.`docs/02-05-nginx-验证矩阵-一键部署.md` 部署 nginx 矩阵并访问一次(可先读 `docs/02-00-nginx-系列说明.md`)。
4. 若访问不通,按 `scripts/README.md` 先跑 firewalld 基线与入口链路诊断脚本。