Unify plaza and gadm release docs
This commit is contained in:
+39
-6
@@ -58,7 +58,7 @@ bash scripts/deploy-to-test-host.sh
|
|||||||
|
|
||||||
生产上,`gadm.tkmind.cn` 解析到 105,105 只做反代,最终回源到 Studio 上的 `memind_adm`。
|
生产上,`gadm.tkmind.cn` 解析到 105,105 只做反代,最终回源到 Studio 上的 `memind_adm`。
|
||||||
|
|
||||||
### 1. 在 Studio 上更新代码
|
### 0. 本地改动确认
|
||||||
|
|
||||||
推荐从本地开发目录发布到 Studio:
|
推荐从本地开发目录发布到 Studio:
|
||||||
|
|
||||||
@@ -69,28 +69,61 @@ git status --short
|
|||||||
|
|
||||||
如果你改的是 `admin-server.mjs`、`admin-routes.mjs`、`admin-*.mjs` 或 `ops/`,记得先本地自测。
|
如果你改的是 `admin-server.mjs`、`admin-routes.mjs`、`admin-*.mjs` 或 `ops/`,记得先本地自测。
|
||||||
|
|
||||||
### 2. 启动 / 重启 `memind_adm`
|
### 1. 本地启动 / 自测
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd /Users/john/Project/Memind
|
|
||||||
pnpm dev:adm
|
pnpm dev:adm
|
||||||
```
|
```
|
||||||
|
|
||||||
如果你们的生产环境是 launchd、pm2、systemd 或别的守护方式,就让它最终执行同一个入口:
|
默认监听 `http://127.0.0.1:8082`,启动后先看:
|
||||||
|
|
||||||
```bash
|
```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
|
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`。
|
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
|
```bash
|
||||||
curl -I https://gadm.tkmind.cn/healthz
|
curl -I https://gadm.tkmind.cn/healthz
|
||||||
curl -s 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` 是否还在运行
|
2. Studio 上 `memind_adm` 是否还在运行
|
||||||
3. 105 上 nginx 是否把 `gadm.tkmind.cn` 转发到了 Studio
|
3. 105 上 nginx 是否把 `gadm.tkmind.cn` 转发到了 Studio
|
||||||
4. `ADMIN_CONSOLES`、`ADMIN_API_ALLOWED_HOSTS`、`OPS_API_ALLOWED_HOSTS` 是否限制过严
|
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)
|
- [`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/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)
|
- [`scripts/local-test-proxy.mjs`](/Users/john/PycharmProjects/test/test-memind/scripts/local-test-proxy.mjs)
|
||||||
|
|
||||||
|
|||||||
+5
-27
@@ -246,41 +246,19 @@ bash scripts/deploy-to-test-host.sh
|
|||||||
|
|
||||||
目标:`test-memind` / `test-memindadm` / `test-memindplaza`。同步后需按该机习惯手动重启服务。
|
目标:`test-memind` / `test-memindadm` / `test-memindplaza`。同步后需按该机习惯手动重启服务。
|
||||||
|
|
||||||
### 10.2 Plaza 105 静态站
|
### 10.2 Plaza 105 入口转发
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pnpm deploy:plaza-105
|
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
|
### 10.3 gadm / memind_adm
|
||||||
|
|
||||||
`gadm.tkmind.cn` 是 `memind_adm` 的生产入口,当前流程和 Plaza 一样也是:
|
`gadm.tkmind.cn` 的生产入口和 Plaza 相同,也是 `105 -> Studio`。
|
||||||
|
更完整的操作手册见 [gadm 入口与发布](./gadm-local.md)。
|
||||||
```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)。
|
|
||||||
|
|
||||||
### 10.4 已废弃 / 不可用
|
### 10.4 已废弃 / 不可用
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user