docs(release): 生产发布记录 §15 + runbook 更正(仅文档) #44
No files matched your search
@@ -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` 里是 **`<triggers/>`(空)** | 该任务没有任何触发器;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`)仍是决策人动作。
|
||||
@@ -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` 里是 `<triggers/>`(空)、`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. 发布后核对(全部只读)
|
||||
|
||||
|
||||
Reference in new issue
Block a user