From 41470bafcb22f13996267d241c234ee9aae1e210 Mon Sep 17 00:00:00 2001 From: john Date: Sat, 20 Jun 2026 15:46:32 +0800 Subject: [PATCH] Unify plaza and gadm release docs --- docs/gadm-local.md | 45 ++++++++++++++++++++++++++++++++++++------ docs/release-deploy.md | 32 +++++------------------------- 2 files changed, 44 insertions(+), 33 deletions(-) diff --git a/docs/gadm-local.md b/docs/gadm-local.md index 8243fa1..9a0dba1 100644 --- a/docs/gadm-local.md +++ b/docs/gadm-local.md @@ -58,7 +58,7 @@ bash scripts/deploy-to-test-host.sh 生产上，`gadm.tkmind.cn` 解析到 105，105 只做反代，最终回源到 Studio 上的 `memind_adm`。 -### 1. 在 Studio 上更新代码 +### 0. 本地改动确认 推荐从本地开发目录发布到 Studio： @@ -69,28 +69,61 @@ git status --short 如果你改的是 `admin-server.mjs`、`admin-routes.mjs`、`admin-*.mjs` 或 `ops/`，记得先本地自测。 -### 2. 启动 / 重启 `memind_adm` +### 1. 本地启动 / 自测 ```bash -cd /Users/john/Project/Memind pnpm dev:adm ``` -如果你们的生产环境是 launchd、pm2、systemd 或别的守护方式，就让它最终执行同一个入口： +默认监听 `http://127.0.0.1:8082`，启动后先看： ```bash +curl -s http://127.0.0.1:8082/healthz +``` + +### 2. 同步到测试机 + +```bash +bash scripts/deploy-to-test-host.sh --only-adm +``` + +测试镜像目录是 `/Users/john/PycharmProjects/test/test-memindadm`。 + +### 3. Studio 生产机启动 / 重启 + +在 Studio 机器上，`memind_adm` 最终都应该由同一个入口启动： + +```bash +cd /Users/john/Project/Memind node admin-server.mjs ``` -### 3. 105 入口反代 +如果你们在 Studio 上用了 launchd / pm2 / systemd，就让守护脚最终执行上面这条命令。 + +常见的生产检查： + +```bash +curl -s http://127.0.0.1:8082/healthz +curl -s http://127.0.0.1:8082/admin-api/summary +``` + +### 4. 105 入口反代 105 上的 nginx 应该把 `gadm.tkmind.cn` 回源到 Studio 的 `memind_adm :8082`。 +如果你要确认 nginx 当前配置，优先看： + +```bash +ssh ssh105 'nginx -t && systemctl reload nginx' +ssh ssh105 'sed -n "1,220p" /etc/nginx/conf.d/gadm.tkmind.cn.conf' +``` + 上线后优先验证： ```bash curl -I https://gadm.tkmind.cn/healthz curl -s https://gadm.tkmind.cn/healthz +curl -s -D - -o /dev/null https://gadm.tkmind.cn/admin-api/summary ``` ## 故障排查顺序 @@ -101,10 +134,10 @@ curl -s https://gadm.tkmind.cn/healthz 2. Studio 上 `memind_adm` 是否还在运行 3. 105 上 nginx 是否把 `gadm.tkmind.cn` 转发到了 Studio 4. `ADMIN_CONSOLES`、`ADMIN_API_ALLOWED_HOSTS`、`OPS_API_ALLOWED_HOSTS` 是否限制过严 +5. `ops/` 是否还在用正确的 `'/admin-api'` 代理地址 ## 相关文件 - [`admin-server.mjs`](/Users/john/PycharmProjects/test/test-memind/admin-server.mjs) - [`scripts/deploy-to-test-host.sh`](/Users/john/PycharmProjects/test/test-memind/scripts/deploy-to-test-host.sh) - [`scripts/local-test-proxy.mjs`](/Users/john/PycharmProjects/test/test-memind/scripts/local-test-proxy.mjs) - diff --git a/docs/release-deploy.md b/docs/release-deploy.md index 92b3139..084e62e 100644 --- a/docs/release-deploy.md +++ b/docs/release-deploy.md @@ -246,41 +246,19 @@ bash scripts/deploy-to-test-host.sh 目标：`test-memind` / `test-memindadm` / `test-memindplaza`。同步后需按该机习惯手动重启服务。 -### 10.2 Plaza 105 静态站 +### 10.2 Plaza 105 入口转发 ```bash pnpm deploy:plaza-105 ``` -依赖 goose-h5 已部署（`pnpm deploy:105` 或全量 rsync）。详见 [Plaza 本机部署](./plaza-local.md)。 +`plaza.tkmind.cn` 一样是 `105 -> Studio` 的入口模式，只是它对应的是 Plaza 前台而不是管理后台。 +当前真实链路见 [Plaza 入口与发布](./plaza-local.md)。 ### 10.3 gadm / memind_adm -`gadm.tkmind.cn` 是 `memind_adm` 的生产入口，当前流程和 Plaza 一样也是： - -```text -本地开发目录 -> Studio 生产机 -> 105 入口反代 -> 公网域名 -``` - -开发入口： - -```bash -pnpm dev:adm -``` - -测试机同步： - -```bash -bash scripts/deploy-to-test-host.sh --only-adm -``` - -生产发布时优先检查： - -1. Studio 上 `http://127.0.0.1:8082/healthz` -2. 105 上 `gadm.tkmind.cn` 反代是否指向 Studio -3. `ADMIN_CONSOLES` / `ADMIN_API_ALLOWED_HOSTS` / `OPS_API_ALLOWED_HOSTS` - -详细说明见 [gadm 入口与发布](./gadm-local.md)。 +`gadm.tkmind.cn` 的生产入口和 Plaza 相同，也是 `105 -> Studio`。 +更完整的操作手册见 [gadm 入口与发布](./gadm-local.md)。 ### 10.4 已废弃 / 不可用