部署

AGENTS.md

@@ -25,6 +25,17 @@
 3. 配置 YAML 只在列表右侧三点和详情配置区展示。
 4. 读取 YAML 时使用 `includeConfig=1`，密钥字段保持脱敏。
 
+## 生产特殊服务
+
+1. `admin-server` 不在标准 prod inventory 的滚动服务清单里；它部署在独立机器 `134.175.160.86` / `172.16.0.6`。
+2. `admin-server` 的 systemd 是 `hyapp-admin-server`，二进制是 `/opt/hyapp/admin-server/admin-server`，配置是 `/etc/hyapp/admin-server/config.yaml`，监听 `172.16.0.6:13100`。
+3. 更新 `admin-server` 时构建 Linux 二进制，上传到 `134.175.160.86`，替换二进制后重启 `hyapp-admin-server`；发布后必须验证 systemd `active`、`13100` 监听和 `healthz/readyz`。
+4. HyApp `cron-service` 当前部署在 Saudi 主服务机器 `new-app-1`，实例 `ins-fi5zufpk`，内网 `10.2.1.4`。
+5. `cron-service` 的 systemd 是 `hyapp-cron-service`，容器是 `hyapp-cron-service`，配置是 `/etc/hyapp/cron-service/config.yaml`，Docker env 是 `/etc/hyapp/cron-service/docker.env`，监听 `13007`。
+6. `cron-service` 当前不在标准 prod inventory 的 `services` 清单里；更新时构建并推送 `10.2.1.3:18082/hyapp/cron-service:<tag>`，通过 Tencent TAT 到 `new-app-1` 修改 docker env 的 `IMAGE` 后重启 `hyapp-cron-service`。
+7. 更新 `cron-service` 后必须验证镜像 tag、Docker health、systemd `active` 和 `13007` 监听。
+8. 腾讯云 `ap-singapore` 的实例名 `cron` 机器是 `ins-nt6bsay0` / `10.3.1.14`；当前没有 HyApp `hyapp-cron-service`，不要把它当成 HyApp `cron-service` 发布目标。
+
 ## 测试 server / testbox
 
 1. 测试 server 指 HyApp 后端测试机 testbox：`43.165.195.39` / `10.11.0.2`，实例 `lhins-q0m38zc6`，区域 `ap-jakarta`。

README.md

@@ -62,6 +62,44 @@ make up
 - YAML 入口：列表右侧三点、详情配置区
 - 禁止：静态假数据兜底展示运行态
 
+## 生产特殊服务
+
+`admin-server` 和 `cron-service` 当前不是标准 `hyapp-services.inventory.prod.example.json` 里的同一种滚动服务，更新前必须先按真实机器确认运行态。
+
+### admin-server
+
+- 机器：公网 `134.175.160.86`，内网 `172.16.0.6`
+- systemd：`hyapp-admin-server`
+- 二进制：`/opt/hyapp/admin-server/admin-server`
+- 配置：`/etc/hyapp/admin-server/config.yaml`
+- 启动参数：`/opt/hyapp/admin-server/admin-server -config /etc/hyapp/admin-server/config.yaml`
+- 监听：`172.16.0.6:13100`
+- 验证：`systemctl is-active hyapp-admin-server`、`ss -lntp | grep 13100`
+
+`admin-server` 更新走独立机器发布：本地或 deploy 机构建 Linux 二进制，上传到 `134.175.160.86`，替换 `/opt/hyapp/admin-server/admin-server` 后重启 `hyapp-admin-server`。发布后必须确认 systemd `active`、端口监听、`healthz/readyz` 正常。
+
+### cron-service
+
+- 当前线上 HyApp `cron-service` 部署在 Saudi 主服务机器 `new-app-1`
+- 区域：`me-saudi-arabia`
+- 实例：`ins-fi5zufpk`
+- 内网：`10.2.1.4`
+- systemd：`hyapp-cron-service`
+- 容器：`hyapp-cron-service`
+- 配置：`/etc/hyapp/cron-service/config.yaml`
+- Docker env：`/etc/hyapp/cron-service/docker.env`
+- 监听：`:13007`
+- 验证：`systemctl is-active hyapp-cron-service`、`docker ps -a | grep hyapp-cron-service`、`ss -lntp | grep 13007`
+
+`cron-service` 当前不在标准 prod inventory 的 `services` 清单里。更新时先构建并推送 `10.2.1.3:18082/hyapp/cron-service:<tag>`，再通过 Tencent TAT 到 `new-app-1` 修改 `/etc/hyapp/cron-service/docker.env` 中的 `IMAGE` 并重启 `hyapp-cron-service`。发布后必须确认容器镜像 tag、Docker health、systemd `active` 和 `13007` 监听。
+
+腾讯云 `ap-singapore` 有一台实例名为 `cron` 的机器：
+
+- 实例：`ins-nt6bsay0`
+- 内网：`10.3.1.14`
+
+这台新加坡 `cron` 机器当前没有 HyApp 的 `hyapp-cron-service`。最近一次核实时 `hyapp-cron-service` 为 `inactive`，Docker 里只有 `likei-cron-sg-1-week-star-job`。
+
 ## 测试 Server
 
 这里的测试 server 指 HyApp 后端测试机 testbox，不是生产业务机。