32 lines
2.4 KiB
Markdown
32 lines
2.4 KiB
Markdown
|
# 生产部署记录（2026-09-12）
|
|||
|
|
|
|||
|
|
## 发布
|
|||
|
|
|
|||
|
|
- 发布提交：`49a916b`（首页菜单增加"主页"入口；全站按钮改为透明底 + hover 动态背景，按钮内文字前加品牌 logo 小图标 `components/brand-icon.tsx`；CMS 中文化标签、i18n（en/zh）、自定义退出按钮 `/cms/api/cms-logout`）。
|
|||
|
|
- 发布目录：`/home/flym/releases/49a916b-www`（www，服务器构建）、`/home/flym/releases/cms-49a916b`（CMS，服务器构建）。
|
|||
|
|
- 软链：`kaotings-www`→`releases/49a916b-www`、`kaotings-cms`→`releases/cms-49a916b`、`kaotings-api`→`releases/ad87a71/services/api`（未变更，未重启）。
|
|||
|
|
- 数据库迁移：无（CMS 改动仅为标签/i18n/组件，无字段结构变化）。
|
|||
|
|
|
|||
|
|
## 过程
|
|||
|
|
|
|||
|
|
1. 本地提交 `49a916b` 并推送 origin（`57c854a..49a916b`）。
|
|||
|
|
2. `git archive` 打包 www 全量与 `apps/cms`，scp 上传（`kaotings_deploy` 密钥）。
|
|||
|
|
3. 服务器 `cp -a` 上一发布后解包覆盖；关键文件 SHA256 与本地一致（`lib/content.ts`、`brand-icon.tsx`、`payload.config.ts`）。
|
|||
|
|
4. 服务器构建：www（`NODE_ENV=production CMS_PUBLIC_API_URL=http://127.0.0.1:3001/cms npm run build`）与 CMS（`npm run build`）均成功。
|
|||
|
|
5. CMS 产物完整性：`.next/node_modules` 经符号链接实文件 319 个（pino 207），符合"服务器构建"要求，无 09-11 的 Windows 构建空目录问题。
|
|||
|
|
6. 切换顺序：先 CMS（重启 `kaotings-cms`，验证 200）→ 再 www（重启 `kaotings-web`）。软链属主为 flym，切换本身无需 sudo；仅 `systemctl restart` 使用 sudo。
|
|||
|
|
|
|||
|
|
## 回滚
|
|||
|
|
|
|||
|
|
- www 回滚：`kaotings-www`→`releases/ad87a71-www` + `systemctl restart kaotings-web`。
|
|||
|
|
- CMS 回滚：`kaotings-cms`→`releases/cms-ad87a71-c` + `systemctl restart kaotings-cms`。
|
|||
|
|
- 无迁移，回滚无数据兼容问题。
|
|||
|
|
|
|||
|
|
## 验收
|
|||
|
|
|
|||
|
|
- `systemctl is-active`：kaotings-api / kaotings-cms / kaotings-web 均 active。
|
|||
|
|
- `GET /healthz`（127.0.0.1:8000 与 https://www.kaotings.com）：ok / 200。
|
|||
|
|
- www 首页（本地 3000 与外部 https 一致）：主导航含"主页"（→`/`）；登录/联系我们为统一透明底按钮（hover 出背景）；页面 `/_next/image` 图标 18 处（含按钮 logo 与品牌标）；`/icon.png` 200。
|
|||
|
|
- CMS：`/cms/admin` 200；`/cms/api/products?where[status][equals]=published` 200（www 产品列表依赖正常）。
|
|||
|
|
- 管理端中文标签/i18n 与退出按钮：代码已上线，登录态界面待人工目视确认。
|