Commit Graph
9 Commits
Author SHA1 Message Date
zhangxiang 54783f4068 fix(ops): 磁盘写满事故收口——备份预检按模式取阈值、残档即删
生产全站 502 约 5.5 小时、Gitea 500 约 13 小时,根因是 / 写到 100%(20G/20G)。
仓库侧落这四处;另三处守卫在服务器侧脚本(未入仓,已在 runbook §7.3 登记)。

- backup-cicd.sh:预检阈值必须与本轮实际开销绑定。原 .env 把 MIN_FREE_GB 从 3 降到 1,
  于是 2GB 可用时放行了一次要写 2.6GB 的全量导出,tar 写到 2.0GB 撞盘。改为含仓库导出时
  上调至 BACKUP_FULL_MIN_FREE_GB(默认 4GB),thin 仍按 1GB —— 一并抬高等于又关掉
  「唯一副本、不可重建」的那份 DB 备份,是同一个错法的两个方向。
- backup-cicd.sh:归档失败即删残档。半截归档把一次备份失败升级成了全站故障,
  且 set -e 让末尾的保留清理从未执行,形成「失败越多越容易满盘」的正反馈。
- backup-cicd.sh:Jenkins 容器缺失时只在预检记录并跳过第 [3/3] 步。原先的
  require_container 会让整轮备份(含 Gitea DB dump)在预检阶段就中止。
- nginx-static-production.conf:upstream jenkins_app 后端置 127.0.0.1:1 down。
  Jenkins 下线后 `server jenkins:8080` 让 nginx -t 报 host not found,
  而修 502 正需要 reload,形成死锁。保留结构以便一行还原。
- runbook §7:复发时的四步判据(盘满时 docker ps 读数不可信)、已落地守卫表、9 项未闭环。
- lessons §5.53:诊断仪器在故障态下自身会失真这一族。§5.52 空号是他人未落库的在途段。
2026-11-01 16:58:33 +08:00
zhangxiang 3fabb77caa docs(ops): 补齐 nginx 对齐、门禁读数与 PR #32 记录 2026-10-20 14:57:13 +08:00
zhangxiang 0b1543df8b docs(ops): 记录站内跳转白屏修复发布(2f86c441) 2026-10-20 14:12:29 +08:00
zhangxiang ba05b2e57b docs(acceptance): 首页改版生产发布记录与线上多端验收
- 记录 acb6b673 发布、镜像/备份锚点与 14 路由 200
- 补线上多端探针 report-production 与 prod 截图
- 探针先 eager 加载再滚屏,避免把懒加载未触发误报成破图
2026-10-20 11:24:16 +08:00
zhangxiang f6e750c318 docs(runbook): 修正 build/up 串链位置——注释不能落在 && 之后(否则是 shell 语法错) 2026-10-20 08:23:49 +08:00
zhangxiang 702c732d27 fix(contact): 去掉 useSearchParams 让 /contact 可完整预渲染;补发布后 ISR 预热脚本
冷首访白屏的第二个真因:/contact 用 useSearchParams() 读 ?success,客户端组件里
这会让整页在预渲染时退化成 Suspense fallback(首访只看到「加载中…」,限速下 ~6s 才出内容)。
该参数只用于一次性成功提示 ⇒ 改为挂载后从 window.location 读并 replaceState 清理。

- /contact 冷首访 h1 可见:6.0s → 1.5s;HTML 73KB 含正文(此前只有外壳)。
- 新增 scripts/ops/warm-routes.mjs:按 sitemap 预热并断言全 200、第二遍 <1500ms 或 HIT;
  本轮线上第二遍:非 200 = 0、>1500ms = 0。
- 全站冷首访复测:/ 827ms、/about 1652ms、/contact 1511ms、/products 917ms、
  /services/software 922ms、/insights 1532ms。
- runbook:加发布前磁盘检查(≥2G)与「构建失败必须中止」;加 §4.0 预热步骤。
- 事故记录:第三次重建时服务器磁盘 99%,COPY 报 ENOSPC 而 up -d 仍执行(旧镜像被当已发布);
  清理旧备份 1.8G + docker image prune 1.075G 后回到 81%,重建 015b6d75 成功。
2026-10-20 08:23:34 +08:00
zhangxiang d0090cea56 fix(motion): reduce 偏好下 hydration 不匹配(React #418)且元素停在 opacity:0
线上 /about 白屏排查(§16):30 条路由 + 6 种环境里唯一可复现的缺陷是
webkit/chromium + prefers-reduced-motion:reduce ⇒ pageerror #418,main 内 14 个元素
opacity 恒 0(正常环境只有 3 个首屏以下的滚动入场项)。

根因:useReducedMotion 用 window.matchMedia 作 useState 初值 ⇒ SSR false、客户端首帧 true;
scroll-reveal / template / page-transition 又用它决定 initial/variants/甚至早返回不同树结构,
与 SSR HTML 不一致;且 reduce 时 whileInView 被清空 ⇒ 元素停在 initial 的 opacity:0。

修法(结构恒定,减少动效改用「时长 0」表达):
- hook 首帧恒 false,挂载后 effect 同步真实偏好;
- ScrollReveal/StaggerReveal 的 initial/whileInView/variants 不再按 reduce 清空;
- template.tsx 与 StaggerChildren 去掉早返回裸结构,改空 variants。

回归守卫 e2e/reduced-motion-hydration.spec.ts(/about 与 /):断言 reduce 自证生效、
无 hydration 错误、h1 与末段标题 opacity=1。变异验证:hook 改回 matchMedia 初值 ⇒ 2 红,恢复 ⇒ 2 绿。

另:runbook 明确禁止对 dist/_next/static 用 --delete(回访者旧 HTML 会引用上一代 chunk);
本轮已从备份 --ignore-existing 合并回旧代 101 个文件。复算:tsc/type-check:e2e 0、
jest 35 套件 462 例 0、check:visual 0、check:motion 0、视觉 chromium-desktop 25/25。
2026-10-20 08:00:20 +08:00
zhangxiang 524c1b6575 docs(release): 生产发布记录 §15 + runbook 更正「合 main 不会触发部署」
实测更正:Jenkins 任务 novalon-website-ci-cd 的 config.xml 是 <triggers/>(空)、builds 只有 permalinks
(从未构建)、匿名 POST /job/…/build 返 403、Gitea webhook 打不进去 ⇒「合 main 自动部署」当前不成立。
runbook §3 补「设计路径(需管理员加 GenericTrigger)」与「手动路径(本轮实际执行)」两节。

发布记录(§15):本地重建 → 服务器 dist/public 备份 → rsync 增量(3011 文件 / 2432 传输 /
线上 3.4MB,speedup 44)→ 镜像重建 c2c955d3 → 容器 healthy → 10 个页面全 200 →
线上 HTML 出现新标记(成果槽空态 / results-slot / 预约咨询 / 四轴导航)→ 服务端回退日志 0、error 0 →
停容器迁移(source=cms / issues=0,回传后 chown 1001:1001)→ 迁移后库读数:导航四轴 + 三模型门槛字段 ✓、
内容 38 行未变、案例 0 条 → 线上全页截图人工确认。回滚锚点三项已登记。
2026-10-20 07:49:56 +08:00
zhangxiang cee21e178a docs(ops): 生产侧核对与发布 runbook;新增最小迁移脚本 sync-cms-schema(默认 dry-run)
只读核对生产库(scp 副本、本地 node:sqlite 查询,未写生产):
- navigation 行仍是旧 7 项 IA(panels products,solutions,services)⇒ 新代码每请求退回代码真源;
- 三处 caseStudies 的 ContentModel.fields 缺 authorized/basis ⇒ 后台填不出门槛字段;
- 生产案例条目 **0 条** ⇒ 只发代码不会隐藏任何内容(dataProofs 按裁定不套硬闸)。

新增 scripts/ops/sync-cms-schema.ts:只补 3 个模型的两个子字段 + 把 navigation 行改写为
由 NAVIGATION_V2/MEGA_DROPDOWN_DATA 派生的形状;默认 dry-run,--apply 才写,
写前用真实 resolveNavigation 验收派生形状、写后强制复查(不通过即退出码 1)。
在生产库副本上预演通过:source=cms / issues=0;逐行 diff 证明只动了
3 个 ContentModel 行 + 1 个 ContentItem 行(navigation),其余 37 行内容与 13 个模型逐字节不变。

docs/development/deploy-runbook.md 写清:备份与停容器顺序、**服务器 Node v20 无 node:sqlite
⇒ 迁移必须本机跑再回传**、不推荐用 db:seed(会重写所有覆盖行且需 SEED_ALLOW_EXTERNAL_DB=1)、
发布后四项只读核对、三条回滚路径,以及"合 main = 无人值守线上发布,须决策人显式发起"。
2026-10-20 07:40:37 +08:00