docs(qa): §10 生产发布记录与事故复盘 + deployment §七 web root 契约 + lessons §5.34
- §10:发布内容/序列(build EXIT=0 → 真 prod.db 副本预生产演练 14 路由全 200 → prod.db.bak.20261008_173048 快照 → dist_backup_20261008_173111 → DEPLOY_EXIT=0) - §10.2:本次部署引入的回归与恢复(≈4 分钟),并用 nginx access.log 现取 10-07 同一 URL 为 200 的证据把回归定性为自己引入而非既有状态 - §10.4:Playwright 三页线上健康证据(stylesheets=2、品牌红命中、4xx/5xx GET=0、 console error=0) - §10.5:发布后仍未闭合项,含 AUTH-D2 的真凭据——prod.db 里 Permission.modelCode 仍是旧码 team/legal(各 11 条授予)而 ContentModel 已是 team-page/legal-page/ contact-page 等 16 个模型;并列出三条 seed 执行候选与建议 - deployment.md §七:两种产物形态的契约、镜像生成命令、回滚须连容器一起、 compose/Dockerfile 从不同步导致的挂载漂移 - lessons §5.34:三条规则 + 两条取证法 + 管理归零(预生产演练、资源级门禁)
This commit is contained in:
1 parent
722f08a159
commit
81bdeebc64
3 files changed
+92
No files matched your search
@@ -578,3 +578,26 @@ echo " 3. 重载 Nginx: docker exec novalon-nginx-secure nginx -s reload"
|
||||
- **jenkins 容器**:以 root 运行且挂载 `/var/run/docker.sock` 与 `/root/.ssh`(CI 构建需要,但一旦被攻破即等于宿主机沦陷,建议评估最小权限方案)
|
||||
- **遗留 forgejo 引用**:`dist_backup_20260422_161751/` 与 `novalon-website/.woodpecker.yml` 等旧文件中仍含 forgejo/woodpecker 配置,属历史归档,无需处理
|
||||
- **监控缺失**:本次攻击 2026-08-11 开始,3 天后才被发现;建议配置 fail2ban + 容器日志告警 + 定时恶意文件扫描
|
||||
|
||||
## 七、发布链的 web root 镜像(2026-10-08 线上事故后新增)
|
||||
|
||||
**契约**:远端 nginx 的站点根就是 `deploy.sh` 上传后的 `dist/`——`novalon-nginx/nginx-static-production.conf:132` 写 `root /var/www/novalon;`,而该 mount 指向宿主 `/home/novalon/docker-app/novalon-website/dist`(`docker inspect novalon-nginx-secure` 现取)。同文件 `:136-142` 的 `location /_next/static/ { try_files $uri =404; }` 因此要求磁盘上存在 **`dist/_next/static/**`**,而不是 `dist/static/**`。
|
||||
|
||||
但 `next build` 的产物布局是 `dist/static/**`(无 `_next` 前缀)+ 独立的 `public/**`,而 `postbuild`(`package.json`)只为 **standalone 容器**装配 `dist/standalone/{dist/static,public}`——**两者不是同一份形态**。所以上传前必须另生成一份「nginx web root 镜像」:
|
||||
|
||||
```bash
|
||||
mkdir -p dist/_next && cp -R dist/static dist/_next/static && cp -R public/. dist/
|
||||
```
|
||||
|
||||
该步骤已固化进 `scripts/deploy.sh` 的 **步骤 1.5**(含 `dist/static` 缺失即终止部署的前置校验)。
|
||||
|
||||
**事故(2026-10-08 17:31)**:镜像步骤缺失时,`rsync -avz --delete dist/` 会**抹掉上一次部署留下的镜像**,于是新 `dist/` 只有 `static/` 与 `standalone/`。后果是 nginx 对 `/_next/static/chunks/*.{js,css}`、`/favicon.ico`、`/images/*` 全部返回 404,而**页面本身仍 200**——`deploy.sh` 的 `verify_remote` 只 curl 五个 HTML 路径,于是它打印「✅ 生产环境验证通过 / 🎉 部署成功」,实际线上是无 CSS、无 JS 的破站。恢复:在服务端补做镜像(纯新增,不删任何东西),约 4 分钟后资源全 200。
|
||||
|
||||
**为什么旧部署没红**:`dist_backup_20260905_113209/` 顶层确有 `_next/static` 与合并进根的 `fonts/ images/ *.svg`,即历史发布流程产出过这份镜像;`nginx access.log` 现取 2026-10-07(本次部署前)`/_next/static/chunks/*.js` 为 **200**,证明回归由本次部署引入而非既有状态。
|
||||
|
||||
**已加的门禁**(同文件 `verify_remote`):部署后从**首页 HTML 实际引用的 URL** 里取前 5 个 `/_next/static/*.{js,css}` + `/favicon.ico` 逐个断言 200,任一非 200 即 `return 1`。负对照已实测:把取样 URL 换成不存在者 ⇒ 输出 `RED 404` 且 `failed=1`,不是恒绿断言。
|
||||
|
||||
**仍未闭合的两条(须单独授权,勿夹带)**:
|
||||
|
||||
1. `cmd_rollback` 只恢复 `dist/` 并重载 nginx,**不重建 Next.js 容器** ⇒ 若在新容器已起的情况下回滚,会出现「旧静态资源 + 新服务端代码」的 Server Reference ID 不匹配。正确手工回滚 = 恢复 `dist_backup_*` 后**再**跑一次 `docker-compose -f docker-compose.server.yml build && up -d`。
|
||||
2. 服务器侧 `docker-compose.server.yml` 仍是旧挂载 `./uploads:/app/uploads`,而仓内版本已改为 `./uploads:/app/public/uploads`(`src/lib/media/storage.ts:141` 的落盘根是 `cwd/public/uploads`)。`deploy.sh` **从不同步 compose 与 Dockerfile**,所以该修复从未生效——现取 `docker inspect novalon-website` 的 Mounts 仍是 `/app/uploads`。影响:后台上传写进容器可写层,重建即丢;宿主 `./uploads` 至今只有两个空目录(`image/`、`document/`),无数据可损。
|
||||
Reference in new issue
Block a user