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>
132 lines
5.0 KiB
Markdown
132 lines
5.0 KiB
Markdown
# Analytics / SEO·GEO 生产发布 Runbook
|
||
|
||
跨仓库发布顺序与命令速查。统计平台说明见 [analytics-platform.md](analytics-platform.md)。
|
||
|
||
## 架构（2026-08 起）
|
||
|
||
```text
|
||
公开页 / 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
|
||
bash scripts/release-umami-105.sh --yes
|
||
```
|
||
|
||
脚本会：
|
||
|
||
1. 打包部署文件上传到 `105:/opt/memind-analytics/incoming/`
|
||
2. **在 105 原生** `pnpm install`（复用 `node_modules` 缓存）+ `pnpm run build-docker`
|
||
3. 产出 artifact → `/opt/memind-analytics/releases/umami-<release_id>/`
|
||
4. `backup/backup.sh` 备份 PostgreSQL
|
||
5. 切换 `/opt/memind-analytics/live` symlink，`systemctl restart memind-analytics-umami`
|
||
|
||
### 监控（SSH 断开不影响构建）
|
||
|
||
```bash
|
||
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
|
||
```
|
||
|
||
### 验收
|
||
|
||
```bash
|
||
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`](https://git.tkmind.cn/tkmind/memind-analytics/src/branch/main/deploy/105-runbook.md)。
|
||
|
||
## 2. 103 Portal（Memind）
|
||
|
||
```bash
|
||
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](local-analytics.md)。
|
||
|
||
## 3. 103 管理后台（memind_adm）
|
||
|
||
```bash
|
||
cd /Users/john/Project/memind_adm
|
||
bash scripts/release-prod.sh --yes
|
||
```
|
||
|
||
### 生产 `.env`（Analytics 相关）
|
||
|
||
```env
|
||
# 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`）。
|
||
|
||
### 验收
|
||
|
||
1. [md.tkmind.cn/analytics](https://md.tkmind.cn/analytics) → **Analytics 配置** → 「打开 Umami 分析后台」可 SSO 登录
|
||
2. [md.tkmind.cn/analytics/seo-geo](https://md.tkmind.cn/analytics/seo-geo) → **SEO / GEO 流量** → 表格加载无 SSO/凭证错误
|
||
3. 抽样对比 Umami「所有生成页面明细」与 adm 看板列口径一致
|
||
|
||
详见 memind_adm [`docs/analytics-deploy.md`](../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) |
|
||
|
||
## 相关文档
|
||
|
||
| 文档 | 内容 |
|
||
|------|------|
|
||
| [analytics-platform.md](analytics-platform.md) | 平台边界、字段口径、Rybbit 退役 |
|
||
| [local-analytics.md](local-analytics.md) | 本地 Umami 与 Memind env |
|
||
| [105-server-operations.md](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 配置 |
|