Kaotings/www_site
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
631fce55b3
www_site/docs/production-deployment-2026-09-12.md

3.7 KiB
Raw Blame History

生产部署记录（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 与退出按钮：代码已上线，登录态界面待人工目视确认。

当日追加发布（均为仅 www 或 www+API，同法操作）

提交 内容 发布目录
a06b5f4 所有按钮 hover 统一为登录按钮的青色亮底，去除橙色 releases/a06b5f4-www
d296b7a 页头登录态感知（我的页面/退出登录）；修复 lib/admin.ts 请求丢失 Content-Type 导致删除用户 422 releases/d296b7a-www
af5b4af 退出登录后统一跳首页（页头与账户中心） releases/af5b4af-www
86fc51e 管理后台 TTS 配置（迁移 007_tts_settings.sql，DB 优先于 env；GET/PUT /admin/tts/settings + POST /admin/tts/settings/test 探测；worker 动态读配置，兼容 mp3） releases/86fc51e（www + API 同目录）
  • 86fc51e 已应用迁移（schema_migrations 001–007 齐全）；/api/v1/admin/tts/settings 未登录 401；三服务 active；外部首页 200。
  • 当前软链：kaotings-www→releases/86fc51e、kaotings-api→releases/86fc51e/services/api、kaotings-cms→releases/cms-49a916b。
  • 待办：管理员在后台“TTS 配置”页填入上游地址与 API Key（探测通过后保存），解决生产 UPSTREAM_NOT_CONFIGURED；上游凭据仍建议只走后台配置，不写入 api.env。