49 lines
3.7 KiB
Markdown
49 lines
3.7 KiB
Markdown
# 北京测试环境清单
|
||
|
||
本文用于第一轮真实模型联调,不代表最终生产架构。当前约定为:应用服务器放在阿里云北京地域,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、可靠重试及完整计费是后续节点。
|