Files
moyi-model-intelligence-hub/docs/10-beijing-test-environment-checklist.md
T

3.7 KiB
Raw Blame History

北京测试环境清单

本文用于第一轮真实模型联调,不代表最终生产架构。当前约定为:应用服务器放在阿里云北京地域,RDS、Tair 和 OSS 优先复用北京资源。

已确认:Ubuntu 24.04 / 4C8G,RDS PostgreSQL 15,Tair 标准架构,域名 moyi.soulofmodel.com。当前执行手册以 服务器测试部署手册 为准。

推荐规格

本次测试环境采用 4 核 8 GiB 轻量应用服务器,运行 Java Control Plane、Vue/Nginx、Docker Compose、日志和基础监控。RDS、Tair、OSS 在云上托管后,应用服务器不承担数据库和缓存的内存压力;这个规格可以为公开测试、构建镜像和异步任务突发保留更充足的余量。

2 核 4 GiB 也可以支撑低频内部联调,但当前已经选择 4 核 8 GiB,不需要再调整。模型推理和 3D 生成仍由上游供应商承担;后续是否扩容应根据 CPU、内存、队列长度和接口延迟监控决定。

云资源拓扑

北京轻量应用服务器
  ├─ frontend (Nginx,公网 80/443)
  └─ moyi-api (Java,仅内网 8787)
       ├─ 北京 RDS PostgreSQL:业务、Key、模型目录、用量审计
       ├─ 北京 Tair/Redis:按 Key 限流、按模型并发租约
       └─ 北京 OSS:预留,Java 结果文件落盘尚未接入

轻量服务器需要配置到 RDS/Tair 所属 VPC 的内网互通,并添加私网 IP 白名单。SSH 隧道测试仅需受限 22 端口;域名测试先配置 HTTPS 和受限 80/443。8787 不对公网开放。迁移前先备份,高可用留待生产设计。

现在必须确认

  • 轻量应用服务器的操作系统、CPU 架构、磁盘容量、Docker/Compose 版本和私网 IP。
  • RDS 数据库引擎和版本、北京地域/可用区、内网地址和端口、数据库名、应用账号,以及白名单配置。当前 Java 工程使用 PostgreSQL 驱动和 PostgreSQL Flyway 迁移;如果现有 RDS 是 MySQL,需要先做数据库适配,不能直接填连接串。
  • Tair 实例的内网地址和端口、Redis 兼容模式、是否启用 TLS、账号/密码或 ACL、白名单。Tair 不需要创建“库表”;Redis 的逻辑 DB/Key 空间由应用使用,当前连接默认使用 DB 0。
  • OSS 当前可后置;后续接入时再提供北京 Region、Bucket、内网 Endpoint、读写权限和生命周期,不要提前交付 AccessKey。

真实联调前再提供

  • 测试域名或临时访问地址,以及 HTTPS 证书方式。
  • DeepSeek、Kimi、GLM、Seedance、Tripo/VAST 的测试 Key、Base URL、模型 ID、限额和回调/文件下载要求。密钥在服务器的 .env.cloud 或 Secrets Manager 中填写,不要发到聊天或 Git。
  • 4--5 位验收账号、3--4 个项目的场景、额度和价格规则、失败扣费/退款规则、任务文件保留时间。

关于境外模型

北京服务器可以先作为测试环境。是否需要香港中转,不由地域名称决定,而由每家供应商 API 的实际连通性、延迟、限流和文件回源结果决定;先从北京测试直连并记录指标,只有某个供应商持续不稳定时,再为该供应商增加独立中转/适配层。应用、RDS、Tair、OSS 不需要为了少数境外模型整体迁移到香港。

验收顺序

  1. 配置 RDS/Tair/OSS 白名单并从服务器验证内网连通。
  2. 在 infra/moyi 执行 python3 deploy.py init,填写连接配置;脚本生成随机安全密钥。
  3. 使用 deploy.py check/up/smoke 完成配置检查、启动与验收,参见最新手册。
  4. 本次先验收同步调用、Key 和审计;真实异步任务、OSS、可靠重试及完整计费是后续节点。