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

49 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 北京测试环境清单
本文用于第一轮真实模型联调,不代表最终生产架构。当前约定为:应用服务器放在阿里云北京地域,RDS、Tair 和 OSS 优先复用北京资源。
已确认:Ubuntu 24.04 / 4C8G,RDS PostgreSQL 15,Tair 标准架构,域名 `moyi.soulofmodel.com`。当前执行手册以 [服务器测试部署手册](11-server-test-deployment.md) 为准。
## 推荐规格
本次测试环境采用 **4 核 8 GiB 轻量应用服务器**,运行 Java Control Plane、Vue/Nginx、Docker Compose、日志和基础监控。RDS、Tair、OSS 在云上托管后,应用服务器不承担数据库和缓存的内存压力;这个规格可以为公开测试、构建镜像和异步任务突发保留更充足的余量。
2 核 4 GiB 也可以支撑低频内部联调,但当前已经选择 4 核 8 GiB,不需要再调整。模型推理和 3D 生成仍由上游供应商承担;后续是否扩容应根据 CPU、内存、队列长度和接口延迟监控决定。
## 云资源拓扑
```text
北京轻量应用服务器
├─ 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、可靠重试及完整计费是后续节点。