4.2 KiB
4.2 KiB
Java 后端与容器化部署基线
一、技术决策
MOYI 后端从当前 TypeScript Control Plane 迁移到 Java 21 + Spring Boot。迁移采用并行替换:先保持现有 API 契约和前端不变,再按认证、目录、Key、路由、队列和任务顺序迁移接口。旧实现只有在 Java 版本完成同等接口、数据迁移和 UAT 后才下线。
目标组件:
| 组件 | 责任 | 第一版部署方式 |
|---|---|---|
| Vue + Nginx | 用户端和管理端静态页面、同源反向代理 | frontend 容器 |
| Java Control Plane | 认证、目录、Key、路由、计量和管理 API | moyi-api 容器 |
| PostgreSQL | 业务数据和审计数据持久化 | postgres 容器或云数据库 |
| Redis | 会话、限流、并发计数、幂等和任务队列 | redis 容器或云 Redis |
| OSS | 图片、视频、3D 文件和用户上传文件 | 云 OSS,不放进应用镜像 |
| Otari / Provider Adapter | 网关、模型上游和供应商适配 | 独立服务,按联调需要接入 |
二、容器边界
前端使用生产构建,不在生产运行 Vite dev server。Nginx 将 /api/ 和 /v1/ 代理到 Java 服务,浏览器只访问一个域名,因此不需要把数据库、Redis、供应商 Key 暴露给前端。
Java 服务使用环境变量读取数据库、Redis、OSS 和供应商配置。数据库密码、Redis 密码、管理员密码、OSS Secret 和供应商 API Key 不进入镜像、前端静态资源或 Git 仓库。
三、迁移节点
- Java 工程启动、健康检查和基础配置。
- PostgreSQL Flyway 迁移:用户、邀请码、会话、工作区、供应商、模型、Key、用量、审计。
- 认证接口迁移:保持
/api/auth/*返回结构兼容。 - 模型目录、项目、Key、模型权限和最小
/v1/*Mock 接口迁移(当前节点已完成)。 - Redis 会话/限流、并发计数、幂等键和任务队列。
- 同步供应商适配:先接入一个真实文本/多模态模型,再扩展其他厂商。
- 异步任务、队列、OSS 结果文件和 Webhook 迁移。
- 监控、备份、压测、灰度和回滚验证。
四、云环境信息清单
现在必须提供
本阶段只需要确认部署边界,不需要把真实密码或 API Key 发到聊天中。若使用托管 RDS、Redis、OSS,应用容器只保存连接配置,不在服务器本地运行这些基础设施:
- 云服务器是否使用现有服务器;操作系统、CPU/内存/磁盘、CPU 架构和 Docker / Compose 版本。
- 计划使用的域名、DNS 管理方式、是否已有 Nginx/Caddy、HTTPS 证书和备案状态。
- PostgreSQL 使用云数据库还是 Docker;版本、内网地址、端口、数据库名、账号和网络白名单。
- Redis 使用云 Redis 还是 Docker;版本、内网地址、端口、是否 TLS、ACL 用户和网络白名单。
- OSS 使用哪家云厂商;Region、Endpoint、Bucket、内网访问 Endpoint、对象公开/私有策略和生命周期规则。
本地依赖使用 docker-compose.yml;云上托管依赖使用 docker-compose.cloud.yml 和 .env.cloud.example。
开始真实联调前需要提供
- DeepSeek、Kimi、GLM、Seedance、Tripo/VAST 以及其他中转渠道的测试环境 Key、Base URL、模型 ID 和限额。
- 测试域名、回调/Webhook 地址、允许访问的 IP、日志和数据留存要求。
- 4—5 名内部测试用户、3—4 个项目的验收场景和预计并发。
- 额度、价格、失败扣费、退款、任务文件保留和超限策略。
生产开放前再确认
- 生产域名、证书自动续期、备份周期、恢复目标、监控告警和应急联系人。
- 云数据库/Redis/OSS 的高可用、备份、跨可用区和访问审计方案。
- 供应商授权、数据出境/地区限制、隐私政策、用户协议、内容安全和日志脱敏边界。
- 发布审批、镜像签名或 digest、漏洞扫描、灰度发布和回滚方案。
五、密钥交付方式
不要把 PostgreSQL 密码、Redis 密码、OSS AccessKey Secret 或模型 API Key 直接粘贴到聊天或 Git。建议由你在服务器上创建 infra/moyi/.env,或使用云厂商 Secrets Manager / KMS 注入;我只需要变量名、网络连通性和脱敏后的连接信息来完成配置和验证。