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
@@ -523,6 +523,24 @@ Object.defineProperty(window, 'requestAnimationFrame', { configurable: true, val
|
||||
|
||||
**来源**:`docs/acceptance/2026-10-08-baselines/attribution.md` §5、`docs/acceptance/qa-tracker.md` §9.4(含本条的作废声明与更正)、`src/components/detail/detail-product-value.tsx:70-100`、`node_modules/playwright/lib/program.js:202`。
|
||||
|
||||
### 5.34 「🎉 部署成功」之后线上是破站:HTML 全 200,而它引用的 CSS/JS 全 404
|
||||
|
||||
**事故(2026-10-08 17:31)**:`./scripts/deploy.sh deploy` 打完 `DEPLOY_EXIT=0`、五个页面全 200、脚本自己输出「✅ 生产环境验证通过 / 🎉 部署成功」。但用 `curl` 取首页 HTML 里**实际引用**的 `/_next/static/chunks/*.js|*.css` 与 `/favicon.ico`,全部 **404**(`server: nginx` 应答,`try_files $uri =404`)⇒ 真实用户打开的是无样式、无脚本的破站。恢复耗时约 4 分钟,且是**我在脚本判绿之后另做复核**才发现的——不是门禁抓到的,是人抓到的。
|
||||
|
||||
**根因是两种产物形态 + 一次 `--delete`**:远端 nginx 的站点根就是上传后的 `dist/`(`nginx-static-production.conf:132` `root /var/www/novalon;`,而该 mount 指向宿主 `.../novalon-website/dist`),`location /_next/static/` 因此要求磁盘上有 **`dist/_next/static/**`**;但 `next build` 出的是 `dist/static/**`(无 `_next` 前缀),`postbuild` 只补 **standalone 容器**形态。历史上那份「web root 镜像」是旧发布流程手工产出的(`dist_backup_20260905_113209/` 顶层确有 `_next/static` 与合并进来的 `fonts/ images/ *.svg`),本次 `rsync -avz --delete` 把它抹掉 ⇒ 第一次「干净部署」即红。
|
||||
|
||||
**三条规则**:
|
||||
|
||||
1. **部署后验证必须从页面实际引用的 URL 取样,而不是只查页面路径**。已固化进 `verify_remote`:抓首页 HTML → 取前 5 个 `/_next/static/*.{js,css}` + `/favicon.ico` → 逐个断言 200,任一非 200 即 `return 1`。并做**负对照**:把取样 URL 换成不存在者,实测输出 `RED 404` 且 `failed=1`——不能失败的门禁不是门禁(同 §5.23、§5.30 的「空集合 `every` 为真」族)。
|
||||
2. **`rsync --delete` 的目标目录若被别的流程写入,本脚本必须自己重新生成那部分内容**。否则镜像/派生文件会在第一次部署时被静默删除,而删除动作在日志里完全不可见。修法是把生成步骤放进上传之前(`deploy.sh` 步骤 1.5),并对前置条件缺失(`dist/static` 不存在)**终止部署**而非继续。
|
||||
3. **改任何一侧产物形态前,先确认另一侧的契约**:`standalone`(容器内 `COPY dist/standalone`、`dist/static`、`public`)与 nginx web root(`_next/static` + 根级 public)不是同一棵树。`Dockerfile.prod` 两侧 md5 一致(`0ccd495490694a6bf71d4ff17270d2ed`)排除了镜像构建漂移,问题只出在上传目录。
|
||||
|
||||
**区分「我引入」与「既有」的取证法(值得复用)**:`nginx access.log` 里按 URL grep 历史状态码——本次现取 **2026-10-07**(部署前一日)`/_next/static/chunks/*.js` 为 **200**,一句话就把回归定性成自己引入的,不必猜。同理,`docker inspect <容器> --format '{{range .Mounts}}...'` 看**真实挂载**,比读仓内 compose 可靠:仓里 `docker-compose.server.yml` 已把 uploads 改成 `/app/public/uploads`,服务器跑的仍是旧的 `/app/uploads`,因为 `deploy.sh` 从不同步 compose/Dockerfile(登记为发布链漂移,见 `docs/deployment.md` §七)。
|
||||
|
||||
**管理归零**:① 发布类脚本的「成功」判据必须包含**资源级**断言,已写进 `verify_remote`;② 生产发布前新增一道**预生产演练**——取真 `prod.db` 副本、用同一份产物在本地端口起 `node dist/standalone/server.js` 打 14 条路由(本次全 200,才继续上线);③ 回滚路径要连容器一起回(`cmd_rollback` 只恢复 `dist/`,会留下「旧静态 + 新服务端」的 Server Reference ID 不匹配),正确手工步骤已写进 `docs/deployment.md` §七。
|
||||
|
||||
**来源**:`docs/acceptance/qa-tracker.md` §10(时间线、恢复命令、Playwright 三页 0 失败资源证据)、`scripts/deploy.sh`(步骤 1.5 与资源断言)、`/home/novalon/docker-app/novalon-nginx/nginx-static-production.conf:132,136-142`、`dist_backup_20260905_113209/` 目录形态、`nginx access.log` 2026-10-07 状态码。
|
||||
|
||||
## 6. 代码组织
|
||||
|
||||
### 6.1 组件版本膨胀
|
||||
@@ -577,3 +595,4 @@ Object.defineProperty(window, 'requestAnimationFrame', { configurable: true, val
|
||||
| 2026-09-23 | 增加 §5.30(覆盖率门禁 `collectCoverageFrom` 不含 `src/app/**` ⇒ route handler 全在棘轮外,专项审查找出 3 个 P1:`admin/stats` 只验会话即返回跨模型草稿标题、`checkUserPermission` 从不读 User 行使停用账号旧令牌 24h 内仍可用、B-6 的 `isInternalRedirect` 定义成私有函数致姊妹路由 `draft/disable` 开放重定向复活。管理归零:安全抽象必须可导入、修完要 grep 函数名看命中数是否等于应有数、每处修复做「临时移除 guard ⇒ 用例判红 ⇒ 恢复转绿」的 RED 实测、改共享鉴权函数打爆测试桩是信号不是障碍 | 2026-09-23 `src/app/**` 盲区专项审查(N-17..N-21)+ 三项修复与 RED 探针 |
|
||||
| 2026-09-30 | 增加 §5.32(「按文件名推断机制不存在」写出的假事实:DEC-N21b 记「无 middleware.ts ⇒ /admin 无服务端 gating」,实况是 Next 16 已改名 `src/proxy.ts` 且 `CLAUDE.md:108` 早已写明;同族第二例是「85 张基线未提交」而 `git ls-files` 实测 107 张全在库) | `src/proxy.ts:77-105`、`docs/acceptance/2026-09-30-seal/final-verdict.md` |
|
||||
| 2026-10-08 | 增加 §5.33(把「本轮零源码改动」误用成「参照与树同源」⇒ 将 `+30px` 判成运行期漂移;实际旧参照采集树是 `040951c`(09-22),当前树含 `a366bd1`(09-28 第五轮),根因是 Q-6 count-up 动画从 render 体迁入 `useEffect`,旧参照冻结了中间帧。附三条口径:归因须对「采集树 vs 当前树」、基线数量须标「例/张」、裸 `--update-snapshots` 实为 `changed` 模式不重写通过项) | `docs/acceptance/2026-10-08-baselines/{attribution.md,row-diff.cjs}`、`docs/acceptance/qa-tracker.md` §9.4 |
|
||||
| 2026-10-08 | 增加 §5.34(`deploy.sh` 打印「🎉 部署成功」后线上实为破站:HTML 全 200 而首页引用的 CSS/JS/图标全 404。根因 = nginx web root 需要 `dist/_next/static/**`,而 `next build` 出 `dist/static/**`、`postbuild` 只补 standalone 形态,历史镜像被 `rsync --delete` 抹掉。三条规则:部署后验证须从页面实际引用的 URL 取样并做负对照;`--delete` 目标若被别的流程写入则本脚本须自行重新生成;改产物形态前先确认另一侧契约。附「用 nginx access.log 历史状态码区分我引入 vs 既有」与「`docker inspect` 看真实挂载而非读仓内 compose」两条取证法) | `docs/acceptance/qa-tracker.md` §10、`scripts/deploy.sh` 步骤 1.5 + 资源断言、`docs/deployment.md` §七 |
|
||||
Reference in new issue
Block a user