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
@@ -387,3 +387,53 @@ S-3(about/contact/erp-upgrade 无 revalidate + revalidateTag no-op,涉渲染
|
||||
| `AGENTS.md`(**被 `.gitignore:316` 排除,仅本机**) | 视觉回归行的 21 失败/104 通过/94-31 系列读数标注作废并指向 §9;lint 行补 2026-10-08 一手复测 104;`-u` 模式描述同 `quality-gates.md` 更正 |
|
||||
|
||||
**PR 描述**:新建 `.pr-seal-2026-10-08.md`(覆盖 `a0328a6..HEAD` 全链,含 §8/§9 两轮),`bash scripts/check-pr-checklist.sh .pr-seal-2026-10-08.md` ⇒ **EXIT=0 通过**。按用户裁定与 `.pr-seal-2026-09-*.md` 同列**保持未跟踪**,需要时直接粘进 Gitea 表单;上一份 `.pr-seal-2026-09-30.md` 的叙述已停在 seal 轮,**不得再用于建 PR**。
|
||||
|
||||
---
|
||||
|
||||
## §10 2026-10-08 · 生产发布(用户指令「提交变更并发布到生产」)
|
||||
|
||||
### 10.1 发布内容与序列
|
||||
|
||||
| 步 | 动作 | 读数 / 凭据 |
|
||||
|---|---|---|
|
||||
| 1 | `npm run build` | **BUILD_EXIT=0**,产物 BUILD_ID `uiV6QrbCH7jmurgLVp-nd`(树 `19079e1`,代码封版点仍是 `a0328a6`);`postbuild` 已装配 standalone 三件套(`dist/standalone/{server.js,dist/static,public}`) |
|
||||
| 2 | 预生产演练(**部署前**) | 从服务器取 `prod.db` 副本(413,696 B)→ `PORT=3111 DATABASE_URL=file:/tmp/prod-copy.db node dist/standalone/server.js` → 14 条真实路由**全 200**(`/`、`/products/{,erp,erp-upgrade}`、`/solutions/{,manufacturing}`、`/about{,/brand}`、`/contact`、`/news`、`/cases`、`/services`、`/methodology`、`/admin/login`) |
|
||||
| 3 | 生产库快照 | `data/prod.db.bak.20261008_173048`(AUTH-D2 的硬前置;此前仅有 `bak.20260820_093111`) |
|
||||
| 4 | 远端 dist 快照 | 脚本自动产出 `dist_backup_20261008_173111` |
|
||||
| 5 | `./scripts/deploy.sh deploy --skip-build` | **DEPLOY_EXIT=0**;步骤 3/5/6/6.5 全绿,容器重建后 `curl 127.0.0.1:3000` 就绪,`verify_remote` 五页 200 |
|
||||
|
||||
上传前把 `dist/dev`(606M) 与 `dist/cache`(193M) 清掉,实际上传 205M(服务器出网带宽仅 ≈1Mbps,见 `docs/deployment.md` §6.5)。
|
||||
|
||||
### 10.2 本次部署引入的线上回归(已恢复,≈4 分钟)
|
||||
|
||||
**症状**:部署后首页 HTML 200,但其引用的 `/_next/static/chunks/*.js|*.css`、`/favicon.ico` **全 404**(nginx 应答,`try_files $uri =404`)⇒ 真实用户看到的是无 CSS、无 JS 的破站。
|
||||
|
||||
**根因**:远端 nginx 的站点根 = 上传后的 `dist/`,要求磁盘上存在 `dist/_next/static/**`;而 `next build` 出的是 `dist/static/**`,`postbuild` 只补容器形态。**这份「web root 镜像」历史上由旧发布流程产出**(`dist_backup_20260905_113209/` 顶层确有 `_next/static` 与合并的 `fonts/ images/ *.svg`),本次 `rsync --delete` 把它抹掉了。`nginx access.log` 现取 **2026-10-07**(部署前)同一 URL 为 200 ⇒ 确证是本次部署引入,非既有状态。
|
||||
|
||||
**恢复**:在服务端补做镜像(`mkdir -p dist/_next && cp -R dist/static dist/_next/static && cp -R public/. dist/`,**纯新增、零删除**)+ `chown www-data` / `chmod 755`。恢复后:首页与 `/products/erp` 引用的 **19+ 件资源全 200**;`/images/logo-white.svg` 仍 404 属正确行为(该路径在 `public/` 里不存在,是我构造的探测 URL)。
|
||||
|
||||
**门禁盲区(管理归零)**:`verify_remote` 只 curl 五个 HTML 路径,所以它在破站状态下打印了「✅ 生产环境验证通过 / 🎉 部署成功」。**HTML 200 ≠ 站点可用**。
|
||||
|
||||
### 10.3 已落地的两处修复(`scripts/deploy.sh`,同笔提交)
|
||||
|
||||
1. **步骤 1.5**:上传前本地生成 web root 镜像(`dist/static → dist/_next/static`、`public/. → dist/`),并在 `dist/static` 缺失时**终止部署**而非静默继续。
|
||||
2. **`verify_remote` 资源级断言**:部署后从首页 HTML **实际引用的 URL** 取前 5 个 `/_next/static/*.{js,css}` + `/favicon.ico`,逐个断言 200,任一非 200 即 `return 1`。**负对照已实测**:把取样 URL 换成不存在者 ⇒ `RED 404` 且 `failed=1`,证明该断言可失败。`bash -n` 通过,`deploy --dry-run` 复跑 ⇒ 六项取样全 200。
|
||||
|
||||
### 10.4 线上健康证据(Playwright 无头,`chromium`)
|
||||
|
||||
| URL | stylesheets | h1 / 字号 | 品牌红 | 4xx·5xx GET | console error |
|
||||
|---|---|---|---|---|---|
|
||||
| `/` | 2 | 「让每一家企业都拥有数据驱动的决策能力」/ 81px `geistSans` | 命中 | **0** | **0** |
|
||||
| `/products/erp` | 2 | 「睿新ERP管理系统」/ 81px | 命中 | **0** | **0** |
|
||||
| `/contact` | 2 | 「随时欢迎聊一聊」/ 108px | 命中 | **0** | **0** |
|
||||
|
||||
`TOTAL_FAILED_GETS=0`。安全头单次下发已核(`server: nginx` + CSP/HSTS/XP 等一组,无重复头报错);线上 nginx 的 `X-Frame-Options: SAMEORIGIN` 与仓内 `next.config.mjs` 的 `DENY` 叠加问题仍在(判定书 §5 已登记,修复须单独投递 nginx conf)。
|
||||
|
||||
### 10.5 发布后仍未闭合(须单独授权)
|
||||
|
||||
| # | 项 | 现状与依据 |
|
||||
|---|---|---|
|
||||
| AUTH-D2 | **生产 `db:seed` 未执行**(快照已就绪) | 真凭据:`prod.db` 里 `Permission.modelCode` 仍是旧码 `team`/`legal`(各 11 条授予),而 `ContentModel.code` 已是 `team-page`/`legal-page`/`contact-page`/`navigation`/`methodology`/`page-copy`/`site-config`(共 16 个模型)⇒ `src/lib/permissions.ts:26` 精确匹配下,非 `super_admin` 四个角色对这些模型**无授予**。机制待定:服务器无 `src/`、`prisma/`(只有 `dist/`+`public/`+`data/`),`Dockerfile.prod` 是纯 COPY 镜像 ⇒ 无法在容器内直接跑 `npx tsx prisma/seed.ts`;宿主有 node v20.20.2 但无仓库源码。三条候选:① 宿主 `git clone` 后 `npm ci` 跑 seed(服务器出网 ≈1Mbps,248MB 全量 clone 约 35 分钟);② 本地对 `prod.db` 副本跑 seed 后整库换回(SQLite 换文件有并发写风险,需停容器);③ 把 seed 做成可 `docker cp` 进容器执行的产物。**建议 ①**,且需明文授权 |
|
||||
| H | compose / Dockerfile 配置漂移 | 服务器 `docker-compose.server.yml` 仍是旧挂载 `./uploads:/app/uploads`(仓内已修成 `/app/public/uploads`),`deploy.sh` 从不同步 compose/Dockerfile ⇒ 上传落进容器可写层、重建即丢。详述见 `docs/deployment.md` §七 |
|
||||
| I | `cmd_rollback` 不重建容器 | 回滚只恢复 `dist/` + 重载 nginx,会留下「旧静态 + 新服务端」的 Server Reference ID 不匹配。手工正确姿势已写进 `docs/deployment.md` §七 |
|
||||
| J | PR / 合并 `main` | 生产已运行 `a0328a6` 代码,但 `origin/main` 落后 44 笔且**无 PR 记录**(本环境无 Gitea token)。治理缺口:产物与 main 不同源。人工入口 `https://git.f.novalon.cn/novalon/novalon-website/pulls/new/qa/seal-2026-09-28`,描述用 `.pr-seal-2026-10-08.md` |
|
||||
Reference in new issue
Block a user