diff --git a/docs/gadm-local.md b/docs/gadm-local.md index 9a0dba1..2d95fcc 100644 --- a/docs/gadm-local.md +++ b/docs/gadm-local.md @@ -1,7 +1,8 @@ # gadm 由 105 入口转发到 Studio `gadm.tkmind.cn` 的生产链路和 Plaza 一样,都是 `105 入口 -> Studio 生产机`。 -这里的后台服务名是 `memind_adm`,代码入口在本仓库的 `admin-server.mjs`。 +这里的后端服务名是 `memind_adm`,代码入口在本仓库的 `admin-server.mjs`; +根路径 `/` 则会先跳到 `ops` 门户页。 ## 角色拆分 @@ -11,6 +12,7 @@ 105 公网入口(gadm.tkmind.cn) ↓ nginx / 反代 Studio / 本机生产机 + ├─ ops 前台(/ops/,Vite 开发服务) └─ memind_adm :8082(admin-server.mjs) ├─ /healthz ├─ /admin-api/* @@ -18,7 +20,7 @@ Studio / 本机生产机 ``` `memind_adm` 只负责后端管理 API,不直接托管大部分前台页面。 -开发时,`ops/` 里的后台 SPA 会把请求代理到它;生产上则由 `gadm.tkmind.cn` 入口把请求转给 Studio。 +`ops/` 里的后台 SPA 是独立页面,生产上由 `gadm.tkmind.cn/` 先跳转到 `/ops/`,再由 105 反代回 Studio。 ## 本地开发 @@ -56,7 +58,11 @@ bash scripts/deploy-to-test-host.sh ## 生产发布流程 -生产上,`gadm.tkmind.cn` 解析到 105,105 只做反代,最终回源到 Studio 上的 `memind_adm`。 +生产上,`gadm.tkmind.cn` 解析到 105,105 负责把: + +- `/` 重定向到 `/ops/` +- `/ops/` 反代到 Studio 上的 ops 页面 +- `/admin-api/` 和 `/api/ops/v1/` 反代到 Studio 上的 `memind_adm` ### 0. 本地改动确认 @@ -121,9 +127,10 @@ 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 -I https://gadm.tkmind.cn/ +curl -I https://gadm.tkmind.cn/ops/ curl -s -D - -o /dev/null https://gadm.tkmind.cn/admin-api/summary +curl -s https://gadm.tkmind.cn/healthz ``` ## 故障排查顺序