Skip to content

chore(deploy): M6 Docker Compose 部署与构建期 gzip 预压缩 - #16

Merged
pjm314159 merged 1 commit into
devfrom
chore/deploy
Sep 27, 2026
Merged

pjm314159 merged 1 commit into
devfrom
chore/deploy

Conversation

@pjm314159

Copy link
Copy Markdown
Owner

变更说明

M6 打磨阶段的部署落地(docs/DESIGN.md §8):Docker Compose 一键部署 + 构建期 gzip 预压缩。

  • backend/Dockerfile:多阶段 rust:1-bookworm → debian:bookworm-slim。先用假入口把依赖编出来,改源码只重编本项目 crate(实测依赖层 13m33s / 源码层 44s);非 root uid 10001 运行,装 curl 供 healthcheck
  • frontend/Dockerfile:多阶段 node:24-bookworm-slim → nginx:stable-alpine;VITE_* 经 build.args 注入(值取自根 .env,仓库只留 .env.example 模板)
  • frontend/nginx.conf:/api 读超时 120s(覆盖微信扫码登录 30s 长轮询)、/ws 透传 Upgrade 且读超时 300s、gzip + gzip_static、/assets/ immutable 而 index.html no-cache、SPA 回退;末尾附容器内终结 TLS 的注释模板
  • docker-compose.yml:对外只暴露 80(TLS 交前置反代),frontend 以 service_healthy 依赖 backend,mem_limit 512m/128m 对齐 2 核 2G 预算,日志命名卷持久化
  • 前端接入 vite-plugin-compression2 生成 .gz 产物(index.js 325KB → 101KB)
  • 文档:README 新增「部署(Docker Compose)」章节(含 2G 机器 swap 建议)、DESIGN §8 重写、CHANGELOG、根 .env.example 补部署用法

变更类型

  • chore 构建/依赖/杂项

目标分支

  • dev(feature/fix 常规合并)

自查清单

  • 分支名符合规范(chore/deploy),基于最新 dev 创建
  • 提交信息符合 Conventional Commits
  • 后端 cargo fmt --check / clippy -D warnings / cargo test:本次无 Rust 代码改动(CI 仍会执行)
  • 前端 lint(0 警告)/ tsc / 63 测试 / 构建 全部通过
  • 文档已同步(DESIGN/CHANGELOG/README/.env.example)
  • 无 unwrap()、无 unsafe、无 any
  • 涉及资源分配的改动已确认上限约束(仅容器 mem_limit,不影响 WS 房间资源上限逻辑)

关联 issue / 备注

本机已实跑验证(docker compose build + up -d):

  • backend Up (healthy);GET /api/health 经 nginx 返回 200 {"code":0,...,"status":"up"}
  • /assets/index-*.js 返回 Content-Encoding: gzip、Content-Length: 100955(预压缩 .gz 直出)、Cache-Control: public, max-age=31536000, immutable
  • /index.html 为 Cache-Control: no-cache;/r/12345 SPA 回退 200;/ws 未登录握手 401
  • env_file 注入生效:/api/wechat/status 返回 {"available":true}
  • 运行身份 uid=10001(app),/app/logs 由命名卷挂载且可写
  • 验证完成后已 docker compose down -v 清理

有意未包含:容器内终结 TLS(按需取消 frontend/nginx.conf 末尾注释并打开 443 端口);CI 暂未加入 docker build 步骤。

- 后端 Dockerfile:多阶段 rust:1-bookworm → debian:bookworm-slim,先用假入口编依赖以复用层缓存,非 root uid 10001 运行,装 curl 供 healthcheck
- 前端 Dockerfile:多阶段 node:24-bookworm-slim → nginx:stable-alpine,VITE_* 经 build.args 注入
- frontend/nginx.conf:/api 读超时 120s(覆盖微信扫码登录 30s 长轮询)、/ws 透传 Upgrade 且读超时 300s、gzip + gzip_static、/assets/ immutable 而 index.html no-cache、SPA 回退,末尾附容器内终结 TLS 注释模板
- docker-compose.yml:只暴露 80(TLS 交前置反代),frontend 以 service_healthy 依赖 backend,mem_limit 512m/128m 对齐 2 核 2G 预算,日志命名卷持久化
- 前端接入 vite-plugin-compression2 生成 .gz 产物(index.js 325KB→101KB)
- 根 .env.example、README 部署章节、DESIGN §8、CHANGELOG 同步
@pjm314159
pjm314159 merged commit 1f36d98 into dev Sep 27, 2026
2 checks passed
@pjm314159
pjm314159 deleted the chore/deploy branch September 27, 2026 14:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant