Files
moyi-model-intelligence-hub/docs/08-java-container-deployment.md
T

4.0 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 仓库。

三、迁移节点

  1. Java 工程启动、健康检查和基础配置。
  2. PostgreSQL Flyway 迁移:用户、邀请码、会话、工作区、供应商、模型、Key、用量、审计。
  3. Redis 会话与限流:替换内存 session、登录限流和幂等键。
  4. 认证接口迁移:保持 /api/auth/* 返回结构兼容。
  5. 模型目录和供应商来源迁移:保持 /api/models、/api/admin/providers、/api/admin/models 兼容。
  6. API Key、模型权限、统一 /v1/* 调用和供应商适配迁移。
  7. 异步任务、队列、OSS 结果文件和 Webhook 迁移。
  8. 监控、备份、压测、灰度和回滚验证。

四、云环境信息清单

现在必须提供

本阶段只需要确认部署边界,不需要把真实密码或 API Key 发到聊天中:

  • 云服务器是否使用现有服务器;操作系统、CPU/内存/磁盘、CPU 架构和 Docker / Compose 版本。
  • 计划使用的域名、DNS 管理方式、是否已有 Nginx/Caddy、HTTPS 证书和备案状态。
  • PostgreSQL 使用云数据库还是 Docker;版本、内网地址、端口、数据库名、账号和网络白名单。
  • Redis 使用云 Redis 还是 Docker;版本、内网地址、端口、是否 TLS、ACL 用户和网络白名单。
  • OSS 使用哪家云厂商;Region、Endpoint、Bucket、内网访问 Endpoint、对象公开/私有策略和生命周期规则。

开始真实联调前需要提供

  • 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 注入;我只需要变量名、网络连通性和脱敏后的连接信息来完成配置和验证。