jack/Deploy-Laboratory
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

对齐文件规范

Browse Source
This commit is contained in:
Jack
2026-03-27 16:58:41 +08:00
parent 231b6713c4
commit 31709425e2
235 changed files with 5433 additions and 2850 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
docs/04-01-k3s-nodejs-高级部署.md
View File

@@ -1,8 +1,16 @@
# 04-01-k3s Node.js 高级部署
# 04-01-k3s-nodejs-高级部署
> Node.js 属于 `04` 高级部署序列。
> 本文作为 Node.js 主入口：先跑通基础链路，再扩展到自定义端口、存储与构建。
## TL;DR
- **自动化验收**：`./scripts/verify.sh run 04-01`
- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
- **成功判据**：达到本文「预期」且 playbook 断言通过
- **排障**：见本文「排障」
## 前置条件
- 已完成 `01-02-k3s-工作节点.md`
@@ -22,11 +30,11 @@
| 项 | 路径 / 命令 |
|----|-------------|
| 清单文件 | [`ansible/files/04-01-nodejs-demo/04-01-nodejs-demo.yaml`](../ansible/files/04-01-nodejs-demo/04-01-nodejs-demo.yaml) |
| 手工应用 | `kubectl apply -f ansible/files/04-01-nodejs-demo/04-01-nodejs-demo.yaml` |
| Ansible | `ansible-playbook -i ansible/inventory.ini ansible/playbooks/nodejs-demo-apply.yml -e nodejs_demo_manifest=04-01-nodejs-demo.yaml` |
| 清单文件 | [`ansible/files/04-01/04-01-nodejs-demo.yaml`](../ansible/files/04-01/04-01-nodejs-demo.yaml) |
| 手工应用 | `kubectl apply -f ansible/files/04-01/04-01-nodejs-demo.yaml` |
| Ansible | `ansible-playbook -i ansible/inventory.ini ansible/playbooks/verify/04-01.yml -e nodejs_demo_manifest=04-01-nodejs-demo.yaml` |
索引与累积说明见 [`ansible/files/04-01-nodejs-demo/README.md`](../ansible/files/04-01-nodejs-demo/README.md)。
索引与累积说明见 `ansible/files/04-01/` 目录内的累积清单文件（`04-01`～`04-14`）。
### 相对上游
@@ -41,7 +49,7 @@
应用方式：
```bash
kubectl apply -f ansible/files/04-01-nodejs-demo/04-01-nodejs-demo.yaml
kubectl apply -f ansible/files/04-01/04-01-nodejs-demo.yaml
```
## 基础验证
@@ -61,18 +69,18 @@ curl -s --max-time 3 http://192.168.2.62/node/
## 部署阶段扩展（分项导航）
在本文 `nodejs-demo` 基线上按主题增量实践（建议顺序大致由上到下）。**每篇分项均链接到 `ansible/files/04-01-nodejs-demo/` 下累积清单**，并附 **相对上一篇的变更表**；与 [`ansible/playbooks/nodejs-demo-apply.yml`](../ansible/playbooks/nodejs-demo-apply.yml) 共用。
在本文 `nodejs-demo` 基线上按主题增量实践（**`04-02`～`04-14` 已按 Core→Plus→Pro、从简到繁编号**）。**每篇分项均链接到 `ansible/files/04-01/` 下累积清单**，并附 **相对上一篇的变更表**；与 [`ansible/playbooks/verify/04-01.yml`](../ansible/playbooks/verify/04-01.yml) 共用。
- `04-02-nodejs-镜像与运行命令.md`：镜像 tag、`imagePullPolicy`、`command`/`args`
- `04-03-nodejs-环境变量与配置注入.md`：ConfigMap/Secret、`env`/`envFrom`
- `04-04-nodejs-端口与Service.md`：`containerPort` 与 Service/Ingress 端口对应
- `04-05-nodejs-资源请求与限制.md`：`resources`、OOM/CPU 节流
- `04-06-nodejs-探针与健康检查.md`：存活/就绪/启动探针
- `04-07-nodejs-调度与亲和.md`：`nodeSelector`、亲和、容忍
- `04-08-nodejs-安全上下文.md`：`securityContext`、非 root、只读根等
- `04-09-nodejs-存储与卷.md`：`emptyDir`、PVC、配置卷挂载
- `04-10-nodejs-Ingress与Traefik.md`：路径、主机名、`web`/`websecure`
- `04-11-nodejs-副本与滚动发布.md`：`replicas`、滚动策略
- `04-02-nodejs-端口与Service.md`：`containerPort` 与 Service/Ingress 端口对应
- `04-03-nodejs-镜像与运行命令.md`：镜像 tag、`imagePullPolicy`、`command`/`args`
- `04-04-nodejs-环境变量与配置注入.md`：ConfigMap/Secret、`env`/`envFrom`
- `04-05-nodejs-探针与健康检查.md`：存活/就绪/启动探针
- `04-06-nodejs-副本与滚动发布.md`：`replicas`、滚动策略
- `04-07-nodejs-Ingress与Traefik.md`：路径、主机名、`web`/`websecure`
- `04-08-nodejs-资源请求与限制.md`：`resources`、OOM/CPU 节流
- `04-09-nodejs-调度与亲和.md`：`nodeSelector`、亲和、容忍
- `04-10-nodejs-安全上下文.md`：`securityContext`、非 root、只读根等
- `04-11-nodejs-存储与卷.md`：`emptyDir`、PVC、配置卷挂载
- `04-12-nodejs-TLS与证书.md`：Ingress `tls`、HTTPS（与 `03-02` ACME 配合）
- `04-13-nodejs-HPA.md`：水平自动扩缩容
- `04-14-nodejs-GitOps与CI流水线.md`：构建镜像、GitOps/CI 闭环
@@ -80,3 +88,9 @@ curl -s --max-time 3 http://192.168.2.62/node/
## 下一步
- 返回 `00-00-构建总览.md`，按导航继续。
## 排障
- **先看 playbook 输出**：失败时先定位是 deploy/wait/http_check 哪一步。
- **集群侧总览**：`kubectl get nodes -o wide`、`kubectl -n kube-system get pods -o wide`。
- **事件与日志**：`kubectl -n <ns> describe ...`、`kubectl -n <ns> logs ... --tail=200`。