日常更新
This commit is contained in:
11
README.md
11
README.md
@@ -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 基线与入口链路诊断脚本。
|
||||
|
||||
Reference in New Issue
Block a user