john
871688550e
Memind CI / Test, build, and release guards (push) Has been cancelled
同步 Analytics 发布 runbook 与 admin 默认 PUBLIC_HOST，与 memind_adm 生产入口一致。 Co-authored-by: Cursor <cursoragent@cursor.com>
5.0 KiB
5.0 KiB
Analytics / SEO·GEO 生产发布 Runbook
跨仓库发布顺序与命令速查。统计平台说明见 analytics-platform.md。
架构（2026-08 起）
公开页 / H5
-> Memind /analytics/* 代理
-> 105 Umami（systemd + 原生 artifact，127.0.0.1:3100）
-> PostgreSQL（仅 db 容器，127.0.0.1:55432）
memind_adm SEO/GEO 看板
-> /admin-api/analytics/seo-geo-pages
-> 105 Umami memind-pages API（overlay）
已废弃： Rybbit；105 上 Docker 编译 Umami 镜像；Docker 跑 Umami 应用容器（docker-umami profile 仅遗留）。
推荐发布顺序
| 顺序 | 仓库 | 何时必须发 | 命令 |
|---|---|---|---|
| 1 | memind-analytics | 改了 deploy/umami/overlay/、memind-pages API |
bash scripts/release-umami-105.sh --yes |
| 2 | Memind | 改了 discovery 埋点、Umami 代理、公开页 delivery | bash scripts/release-portal-runtime-prod.sh |
| 3 | memind_adm | 改了 SEO/GEO 看板、Analytics 配置页、Umami 代理 | bash scripts/release-prod.sh --yes |
只改 overlay / API 时，发 105 即可；只改 adm 看板 UI 时，发 103 md.tkmind.cn（memind_adm） 即可。
Memind discovery 字段（discovery_channel 等）未上线前，adm 看板可能暂无 SEO/GEO 分列数据。
1. 105 Umami（memind-analytics）
工作目录：本机 memind-analytics 仓库（或 worktree memind-analytics-release-main）。
bash scripts/release-umami-105.sh --yes
脚本会：
- 打包部署文件上传到
105:/opt/memind-analytics/incoming/ - 在 105 原生
pnpm install（复用node_modules缓存）+pnpm run build-docker - 产出 artifact →
/opt/memind-analytics/releases/umami-<release_id>/ backup/backup.sh备份 PostgreSQL- 切换
/opt/memind-analytics/livesymlink，systemctl restart memind-analytics-umami
监控（SSH 断开不影响构建）
ssh root@120.26.184.105 tail -f /opt/memind-analytics/.build/build-<release_id>.log
# 或
ssh root@120.26.184.105 tail -f /opt/memind-analytics/.build/release-<release_id>.log
验收
ssh root@120.26.184.105 '
systemctl is-active memind-analytics-umami
curl -sf http://127.0.0.1:3100/api/heartbeat
readlink /opt/memind-analytics/live
'
公网：https://fxi.tkmind.cn/api/heartbeat
详细路径、回滚与 nginx 见 memind-analytics 仓库 deploy/105-runbook.md。
2. 103 Portal（Memind）
cd /Users/john/Project/Memind
bash scripts/check-release-ready.sh # 发布闸门
bash scripts/release-portal-runtime-prod.sh --yes
与 Analytics 相关的 Memind 改动通常包括：
mindspace-analytics-discovery.mjs— SEO/GEO 分类mindspace-analytics.mjs— 事件维度- Portal
/analytics/*反代
本地环境变量见 local-analytics.md。
3. 103 管理后台（memind_adm）
cd /Users/john/Project/memind_adm
bash scripts/release-prod.sh --yes
生产 .env（Analytics 相关）
# SEO/GEO 看板拉 Umami memind-pages API 所需（105 SSO-only 时用 MEMIND_UMAMI_SSO_SECRET）
MEMIND_UMAMI_SSO_SECRET=<与 105 .env 一致>
UMAMI_SSO_USERNAME=admin
UMAMI_URL=https://fxi.tkmind.cn # 可选，默认 http://127.0.0.1:3100
UMAMI_WEBSITE_ID=<Memind 公共页面 Website ID>
H5_PUBLIC_BASE_URL=https://md.tkmind.cn
103 需能访问 105 Umami（内网或配置的 UMAMI_URL）。
验收
- md.tkmind.cn/analytics → Analytics 配置 → 「打开 Umami 分析后台」可 SSO 登录
- md.tkmind.cn/analytics/seo-geo → SEO / GEO 流量 → 表格加载无 SSO/凭证错误
- 抽样对比 Umami「所有生成页面明细」与 adm 看板列口径一致
详见 memind_adm docs/analytics-deploy.md。
常见问题
| 现象 | 处理 |
|---|---|
105 构建 check-db 失败 |
应使用 build-docker（已写入 build-umami-artifact.sh），勿改回 pnpm build |
Umami database is not running |
使用 backup/backup.sh，不要用根目录旧版 backup.sh |
| 105 构建很慢 | 首次 install+compile 约 20–40 分钟；后续 overlay 小改可复用 node_modules |
| adm SEO/GEO 看板空 | 确认 Memind discovery 已发布且有真实 SEO/GEO 流量 |
| Rybbit 相关报错 | 已退役，删除遗留 env/文档引用，见 analytics-platform.md |
相关文档
| 文档 | 内容 |
|---|---|
| analytics-platform.md | 平台边界、字段口径、Rybbit 退役 |
| local-analytics.md | 本地 Umami 与 Memind env |
| 105-server-operations.md | 105 运维边界（含 /opt/memind-analytics） |
memind-analytics README.md |
Umami 仓库运维与 overlay |
memind_adm docs/analytics-deploy.md |
md.tkmind.cn Analytics / SEO·GEO 配置 |