Deploy Platform
项目运维平台。
Scripts
npm install
make build
make up
npm run dev
npm run build
npm run lint
npm run test
Docs
Standalone Deploy
构建后可一键运行 dist 和 deploy API：
npm run deploy:run
已有 dist 时直接启动：
npm run deploy:serve
默认地址：http://127.0.0.1:29200。
也可以用 Makefile 一键运行：
make up
部署模板和 TAT 脚本见 deploy/README.md。
数据资源
- API：
GET /deploy/api/hyapp/resources?remote=1 - 链路：Tencent TAT -> deploy 机器
- MySQL、Redis、MQ：腾讯云托管资源
- 业务服务器配置：优先 SSH，失败后 TAT 兜底
- 前端状态：TAT 未返回前保持加载
- 禁止：生产 SQL/Mongo 查询入口
微服务
- 列表：
GET /deploy/api/hyapp/discover?remote=1 - 详情 YAML：
GET /deploy/api/hyapp/discover?remote=1&includeConfig=1 - 链路：Tencent TAT -> deploy 机器
43.164.75.199-> SSH 业务机器 - 数据来源：SSH 读取 systemd、Docker、镜像、资源、日志和配置
- YAML 入口：列表右侧三点、详情配置区
- 禁止：静态假数据兜底展示运行态
CDN 刷新
- 页面：
/cdn-refresh - API：
POST /deploy/api/edgeone/purge-url - 类型：当前只开放 EdgeOne URL 刷新
- 默认站点：
global-interaction.com/zone-3qwew52ihaj2 - 默认允许域名：
h5.global-interaction.com、vivagames.global-interaction.com、asset.global-interaction.com - 参数：
urls、confirmed=true - 验证：接口等待 EdgeOne 任务结束后返回
jobId、status、tasks - 禁止：页面刷新任意未配置域名；需要新增域名时先改
EDGEONE_ALLOWED_HOSTS
生产特殊服务
admin-server 和 cron-service 当前不是标准 hyapp-services.inventory.prod.example.json 里的同一种滚动服务，更新前必须先按真实机器确认运行态。
admin-server
- 机器：Saudi
admin-platform，CVMins-p11begwe，公网43.164.70.49，内网10.2.1.2 - systemd：
hyapp-admin-server - 容器：
hyapp-admin-server - 配置：
/etc/hyapp/admin-server/config.yaml - Docker env：
/etc/hyapp/admin-server/docker.env - migration 目录：
/opt/hyapp/admin-server/migrations - 镜像仓库：
10.2.1.3:18082/hyapp/admin-server:<tag> - 监听：
10.2.1.2:13100 - 验证：
systemctl is-active hyapp-admin-server、docker ps --filter name=hyapp-admin-server、ss -lntp | grep 13100、curl http://10.2.1.2:13100/healthz、curl http://10.2.1.2:13100/readyz
admin-server 更新只允许发布 origin/main。deploy 机拉取 Gitea git@gitea.haiyihy.com:hy/hyapp-server.git 的 origin/main，构建并推送 10.2.1.3:18082/hyapp/admin-server:<tag>；然后通过 Tencent TAT 到 ins-p11begwe 修改 /etc/hyapp/admin-server/docker.env 的 IMAGE，执行 systemctl restart hyapp-admin-server。admin-platform 已配置 Docker 直拉内网 Harbor：/etc/docker/daemon.json 包含 insecure registry 10.2.1.3:18082，/root/.docker/config.json 包含 Harbor 登录凭据。
发布后必须确认：systemd active、容器镜像 tag/digest 正确、10.2.1.2:13100 监听、healthz/readyz 正常、Caddy 容器 yumi-admin-caddy 运行、https://admin-acc.global-interaction.com/ 返回 200、未登录 https://admin-acc.global-interaction.com/api/v1/auth/me 返回 401。
Saudi admin-platform 前端
- 机器：公网
43.164.70.49，内网10.2.1.2 - CVM：
ins-p11begwe - 区域：
me-saudi-arabia - Caddy 容器：
yumi-admin-caddy - Caddy 宿主机目录：
/opt/yumi-admin/frontend-admin - 静态根目录：
/opt/yumi-admin/frontend-admin/site - Node 运行时：
/opt/node-v22.18.0-linux-x64
这台机器承接两个加速后台前端，都是本机拉 Gitea、构建、替换 Caddy 静态目录：
| 入口 | watcher | 仓库 | 静态目录 | API 回源 |
|---|---|---|---|---|
https://yumiadmin-acc.global-interaction.com |
chatapp3-admin-watch.service |
git@gitea.haiyihy.com:hy/chatapp3-admin.git main |
/opt/yumi-admin/frontend-admin/site/yumiadmin-acc |
/console/* -> Saudi 内网 CLB https://10.2.1.12，Host/SNI jvapi.haiyihy.com |
https://admin-acc.global-interaction.com |
hyapp-admin-platform-watch.service |
https://gitea.haiyihy.com/hy/hyapp-admin-platform.git main |
/opt/yumi-admin/frontend-admin/site/hyapp-admin-platform |
/api/* -> http://10.2.1.2:13100 |
两个 watcher 都是 5 秒循环，入口脚本分别是：
/opt/chatapp3-admin/bin/watch-build.sh
/opt/hyapp-admin-platform/bin/watch-build.sh
实际部署脚本分别是：
/opt/chatapp3-admin/bin/deploy-once.sh
/opt/hyapp-admin-platform/bin/deploy-once.sh
部署完成标记：
/opt/chatapp3-admin/.last_built_commit
/opt/hyapp-admin-platform/.deployed_commit
排查或变更后必须验证：
systemctl is-active chatapp3-admin-watch.service hyapp-admin-platform-watch.service
tail -n 100 /opt/chatapp3-admin/logs/deploy.log
tail -n 100 /opt/hyapp-admin-platform/logs/deploy.log
curl -I https://yumiadmin-acc.global-interaction.com/
curl -I https://admin-acc.global-interaction.com/
未登录 API 返回 401 是正常结果，用来证明反代已经打到后端鉴权层：
curl -sS https://yumiadmin-acc.global-interaction.com/console/
curl -sS https://admin-acc.global-interaction.com/api/v1/admin/apps
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，不是生产业务机。
- 测试机：
43.165.195.39/10.11.0.2 - CVM 实例：
lhins-q0m38zc6 - 区域：
ap-jakarta - 根目录：
/opt/hyapp-server-test - 代码目录：
/opt/hyapp-server-test/source - 部署脚本：
/opt/hyapp-server-test/bin/deploy.sh - 自动更新 timer：
hyapp-server-test-deploy.timer - 部署完成标记：
/opt/hyapp-server-test/.deployed_commit - 后台前端：
http://1.14.164.2:7001/
当前测试机不走生产镜像仓库，也不摘 CLB。部署模式是测试机自己拉取远端 test 分支，hyapp-server-test-deploy.timer 每分钟触发一次部署检查；部署成功且 Compose 服务全部 healthy 后，才写入 .deployed_commit。
平台里的“测试服务”页面通过 deploy-platform API 调用 deploy/tencent_tat/hyapp_testbox_config.py，再通过 Tencent TAT 到测试机执行固定动作。页面不开放任意 shell：
GET /deploy/api/hyapp/testbox/status：读取 test 分支、远端 test commit、已部署 commit、timer 和服务状态。GET /deploy/api/hyapp/testbox/configs：读取测试机服务 YAML，默认脱敏密钥字段。POST /deploy/api/hyapp/testbox/service：固定服务操作update/start/stop/restart。POST /deploy/api/hyapp/testbox/timer：固定 timer 操作start/stop/restart/status。POST /deploy/api/hyapp/testbox/config：写入单个服务配置，先备份旧文件，可选保存后重启。GET /deploy/api/hyapp/testbox/migrations：只列出source/server/admin/migrations/*.sql。POST /deploy/api/hyapp/testbox/migrations/apply：只执行测试机仓库里的 migration 文件。
本地或 deploy-platform 机器上确认状态：
curl -fsS "http://127.0.0.1:29200/deploy/api/hyapp/testbox/status?services=gateway-service,room-service,admin-server"
直接走脚本确认状态：
python3 deploy/tencent_tat/hyapp_testbox_config.py status \
--env-file /opt/hy-app-monitor/.env \
--services gateway-service,room-service,admin-server
测试 Server 日志 Debug
先看平台状态，再看测试机日志。
- 在“测试服务”页面刷新，确认
test 分支、已部署 commit、远端 commit、timerState、服务state/health/restartCount。 - 如果页面或 API 报错，先看 deploy-platform 自身日志：
journalctl -u hyapp-deploy-platform -n 200 --no-pager
docker logs --tail=200 -f hyapp-deploy-platform
- 如果 TAT 到测试机成功但服务异常，登录测试机或通过腾讯云 TAT 执行同等只读命令：
ssh root@43.165.195.39
systemctl status hyapp-server-test-deploy.timer --no-pager
journalctl -u hyapp-server-test-deploy.timer -n 100 --no-pager
journalctl -u hyapp-server-test-deploy.service -n 200 --no-pager
cd /opt/hyapp-server-test/source
docker compose -p hyapp-test -f docker-compose.yml -f /opt/hyapp-server-test/docker-compose.testbox.yml ps
docker compose -p hyapp-test -f docker-compose.yml -f /opt/hyapp-server-test/docker-compose.testbox.yml logs --tail=200 -f gateway-service
docker inspect gateway-service
git -C /opt/hyapp-server-test/source status
git -C /opt/hyapp-server-test/source rev-parse HEAD
git -C /opt/hyapp-server-test/source ls-remote origin refs/heads/test
cat /opt/hyapp-server-test/.deployed_commit
如果 /opt/hyapp-server-test/docker-compose.testbox.yml 不存在，去掉第二个 -f。Debug 时优先查具体异常服务的 Compose 日志，例如 room-service、wallet-service、admin-server。配置问题先通过页面查看脱敏 YAML；需要保存配置时必须补齐真实密钥，包含 *** 的配置禁止保存。