Unify plaza and gadm release docs

2026-06-20 15:46:32 +08:00
parent cb51b94f2c
commit 41470bafcb
2 changed files with 44 additions and 33 deletions
@@ -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)
-
@@ -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 已废弃 / 不可用