From 524c1b6575db5b681659206773312080e50c4b78 Mon Sep 17 00:00:00 2001 From: zhangxiang Date: Tue, 20 Oct 2026 07:49:56 +0800 Subject: [PATCH] =?UTF-8?q?docs(release):=20=E7=94=9F=E4=BA=A7=E5=8F=91?= =?UTF-8?q?=E5=B8=83=E8=AE=B0=E5=BD=95=20=C2=A715=20+=20runbook=20?= =?UTF-8?q?=E6=9B=B4=E6=AD=A3=E3=80=8C=E5=90=88=20main=20=E4=B8=8D?= =?UTF-8?q?=E4=BC=9A=E8=A7=A6=E5=8F=91=E9=83=A8=E7=BD=B2=E3=80=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 实测更正:Jenkins 任务 novalon-website-ci-cd 的 config.xml 是 (空)、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 条 → 线上全页截图人工确认。回滚锚点三项已登记。 --- docs/acceptance/qa-tracker.md | 51 ++++++++++++++++++++++++++++++ docs/development/deploy-runbook.md | 43 ++++++++++++++++++++++--- 2 files changed, 90 insertions(+), 4 deletions(-) diff --git a/docs/acceptance/qa-tracker.md b/docs/acceptance/qa-tracker.md index a450329..6f26afa 100644 --- a/docs/acceptance/qa-tracker.md +++ b/docs/acceptance/qa-tracker.md @@ -1162,3 +1162,54 @@ webkit/mobile 的 Tab 引擎差异取证法、`pollBoundingBox` 的二次读取 发布步骤、发布后核对(页面状态码 / 回退日志计数 / 后台字段 / 视觉抽查)与三条回滚路径: `docs/development/deploy-runbook.md`。**代码发布本身(合 main)仍由决策人显式发起**。 + +--- + +## §15 生产发布记录(2026-10-20,决策人「确认放行」) + +**结论:已上线且核对通过。** `origin/main = 7a410cee`(与 dev 同 sha,FF-only)。 + +### 15.1 一个必须先记的治理发现:这条自动部署链从未接通 + +`dev → main` 合并后本应触发 Jenkins 部署,实测: + +| 读数 | 含义 | +|---|---| +| 服务器 `dist` mtime 仍是 **Oct 8**、容器 `Up 11 days` | 合 main 后**没有任何部署发生** | +| `jobs/novalon-website-ci-cd/config.xml` 里是 **``(空)** | 该任务没有任何触发器;Gitea 的 webhook(`/generic-webhook-trigger/invoke?token=…`)打过去不会触发构建 | +| 该任务 `builds/` 只有 `permalinks` | **从未构建过** | +| `POST /job/…/build` 匿名 ⇒ **403 Authentication required** | 无凭据无法触发;`GET /pulls/{n}/statuses` 也是 `[]`(无回写) | + +⇒ 「合 main = 自动部署」在这套环境里**不成立**。本轮按 `deploy-runbook.md` 走了**手动发布**(见 15.2)。 +后续要么由 Jenkins 管理员给任务加 `GenericTrigger`(含 token 与 `ref=refs/heads/main` 过滤), +要么把 `deploy-runbook.md` 定为正式发布路径 —— 这是治理决策,不是我这侧能改的。 + +### 15.2 本轮实际发布步骤与读数 + +**顺序:先发代码、后迁数据**(新代码对旧导航行 fail-closed,站点全程可用)。 + +| 步骤 | 读数 | +|---|---| +| 本地重建(HEAD `7a410cee`) | `npm run build` EXIT=0;`dist` 380M(`standalone` 162M、`static` 2.6M、`server` 40M) | +| 服务器备份 | `dist_backup_20261020_074545`、`public_backup_20261020_074545`、`data/prod.db.bak.20261020_074752` | +| 增量上传 | rsync:3011 文件、传输 **2432 个**、原始 150.4MB ⇒ 线上实际 **3.4MB**(speedup 44);`dist/_next/static` 用 `--delete` 镜像(双侧 58 文件) | +| 镜像重建 | `docker-compose -f docker-compose.server.yml build` ⇒ `novalon-website:latest`(`c2c955d34372`),BUILD_EXIT=0、UP_EXIT=0 | +| 容器 | `healthy`;`docker inspect` 确认挂载 `data→/app/data`、`uploads→/app/public/uploads` | +| 页面 | `/ /products /products/erp /solutions /solutions/manufacturing /services /insights /news /contact /about` 全 **200** | +| 新代码标记(线上 HTML) | 「还没有可以公开的成果」×1、`data-testid="results-slot…"`、`预约咨询` ×3、导航 行业/能力/洞察/关于我们 | +| 服务端日志 | 迁移前后 `退回代码真源` **0**、`error|unhandled` **0** | +| 数据迁移 | 停容器 → 备份 → 本机 `sync-cms-schema.ts --apply`(`source=cms / issues=0`)→ 回传 + `chown 1001:1001` + 644 → 启容器 | +| 迁移后库读数(拉回本机 `node:sqlite` 只读) | 导航 = 行业/能力/洞察/关于我们 + 面板 industries,capabilities,insights;三模型 `authorized/basis/成果口径` 全 ✓;**内容行数 38 未变**;案例条目 **0** | +| 线上实物 | Playwright 对 `https://www.novalon.cn/` 全页截图:结构、四轴导航、成果槽空态、行业段、能力 accordion、CTA、页脚全部正确(首访顶部只有 Cookie 条) | + +### 15.3 回滚锚点(本轮生成) + +- 静态:`dist_backup_20261020_074545`、`public_backup_20261020_074545` +- 数据库:`data/prod.db.bak.20261020_074752` +- 镜像:旧镜像仍在本地(`docker images` 中 `novalon-website` 的上一条),必要时 `docker-compose up -d` 前先 `docker tag` 回退 + +### 15.4 仍未闭合 + +1. Jenkins 触发器缺失(15.1)——需管理员配置,或确认手动发布为正式路径。 +2. 生产侧案例门槛字段已进库,但**尚未有真实案例数据**(0 条),所以"业务可发布案例"这条端到端路径仍未在真实内容上验证过。 +3. 视觉基线的逐张读图追认(§14.8 / `baseline-audit.md`)仍是决策人动作。 diff --git a/docs/development/deploy-runbook.md b/docs/development/deploy-runbook.md index 06ff108..2ad096b 100644 --- a/docs/development/deploy-runbook.md +++ b/docs/development/deploy-runbook.md @@ -54,11 +54,46 @@ docker start novalon-website ## 3. 发布代码 -- 合 `dev → main` 会触发 Jenkins 的「🚀 部署到生产环境」阶段(`when { branch 'main' }`)—— - 这是一次**无人值守线上发布**,必须由决策人显式发起。 +> **2026-10-20 实测更正:合 `main` 不会触发任何部署。** Jenkins 任务 +> `novalon-website-ci-cd` 的 `config.xml` 里是 ``(空)、`builds/` 只有 `permalinks` +> (从未构建)、匿名 `POST /job/…/build` 返回 **403 Authentication required**, +> Gitea 的 webhook 因此打不进去。⇒ 下面这条"合 main 自动部署"是**设计意图**,当前**不成立**。 +> 本轮实际按 §3.2 的手动路径发布(详见 `docs/acceptance/qa-tracker.md` §15)。 + +### 3.1 设计路径(需 Jenkins 管理员先补齐) + +- Jenkins 任务需加 `GenericTrigger`(token 与 Gitea webhook 的 + `novalon-website-webhook-token-2024` 一致,并用 `refs/heads/main` 过滤), + 或改用 Jenkins 的 Git SCM 轮询;两者都需管理员权限,代理侧无凭据。 - 合并方式与 `#29` 一致:`main` 是 `dev` 的严格祖先时用 **fast-forward-only**,保住 sha 可引用。 -- 发布后产物要点:`dist/_next/static` 镜像必须存在(`deploy.sh` 步骤 1.5 会自动生成; - 缺它 = 全站 CSS/JS 404 而 HTML 全 200)。 +- 发布后产物要点:`dist/_next/static` 镜像必须存在(见 §3.2 步骤 3); + 缺它 = 全站 CSS/JS 404 而 HTML 全 200。 + +### 3.2 手动路径(2026-10-20 实际执行并验证) + +```bash +# 0) 本地按待发布 sha 重建 +npm run build # 产物:dist/standalone + dist/static + dist/server +# 1) 备份(服务器侧) +ssh root@139.155.109.62 'cd /home/novalon/docker-app/novalon-website \ + && cp -a dist dist_backup_$(date +%Y%m%d_%H%M%S) \ + && cp -a public public_backup_$(date +%Y%m%d_%H%M%S)' +# 2) 增量上传(node_modules 基本不变 ⇒ rsync 只传差异,150MB 原始内容线上只走 3.4MB) +rsync -az dist/standalone/ root@…:/home/novalon/docker-app/novalon-website/dist/standalone/ +rsync -az dist/static/ root@…:/home/novalon/docker-app/novalon-website/dist/static/ +rsync -az --delete dist/static/ root@…:/home/novalon/docker-app/novalon-website/dist/_next/static/ # nginx 站点根镜像 +rsync -az public/ root@…:/home/novalon/docker-app/novalon-website/public/ +rsync -az public/ root@…:/home/novalon/docker-app/novalon-website/dist/ # 根级静态资产 +# 3) 重建镜像并重启(compose 是 v1 ⇒ docker-compose) +ssh root@… 'cd /home/novalon/docker-app/novalon-website \ + && docker-compose -f docker-compose.server.yml build novalon-website \ + && docker-compose -f docker-compose.server.yml up -d novalon-website' +# 4) 数据迁移按 §2(停容器 → 备份 → 本机迁移 → 回传 → 启容器) +``` + +关键前置:服务器**没有 sqlite3、Node 是 v20** ⇒ 库的读与迁移都在本机做; +上传目录的属主不影响容器(文件世界可读),但 `data/prod.db` 回传后必须 `chown 1001:1001`。 + ## 4. 发布后核对(全部只读) -- 2.54.0