Files
moyi-model-intelligence-hub/infra/moyi
..

MOYI 容器化部署基线

北京服务器测试部署(当前入口)

当前已确认 Ubuntu 24.04 / 4C8G、RDS PostgreSQL 15、Tair 标准架构、moyi.soulofmodel.com。 完整阿里云配置、发布包、环境变量、证书、启动和回退说明见 服务器测试部署手册。 推荐 python3 deploy.py init 生成配置,使用 deploy.py check/up/smoke,无证书时默认 SSH 隧道,有证书时添加 --mode https。 发布包由 scripts/package-deployment.ps1 构建,只包含编译产物及非敏感配置,不包含真实 .env.cloud 或证书。

这套 Compose 用于 MOYI 的 Java 后端迁移基线:Vue 前端以 Nginx 生产构建运行,Java Control Plane 以 Spring Boot 运行,PostgreSQL 和 Redis 使用独立持久化卷。OSS 不在 Compose 中自建,生产环境连接云厂商 OSS;本地如需模拟对象存储,可另行增加 MinIO profile。

当前迁移状态

control-plane-java/ 提供认证、模型目录、项目、Key、非流式同步供应商转发、Tair 网关保护及审计。真实异步执行、流式响应、OSS 和计费仍未完成,不要直接切入生产流量。

启动

cd infra/moyi
Copy-Item .env.example .env

编辑 .env 中的数据库、Redis、管理员和密钥变量,然后执行:

docker compose build
docker compose up -d
docker compose ps
Invoke-WebRequest http://localhost:8080/health

前端入口为 http://localhost:8080。可先使用邀请码登录、查看模型目录、创建项目和 API Key,并通过 Key 调用 Mock 的 /v1/chat/completions;真实供应商和异步任务仍需后续节点接入。

云上托管依赖

RDS、Tair 和 OSS 不部署在轻量应用服务器上。填写 .env.cloud 后优先使用 deploy.py 预检查。以下原始命令仅用于理解底层 Compose 行为;默认只在服务器回环地址监听:

docker compose --env-file .env.cloud -f docker-compose.cloud.yml build
docker compose --env-file .env.cloud -f docker-compose.cloud.yml up -d

切换预编译发布包

把新发布包解压到独立的 releases/<版本>/ 目录后,从新目录执行升级脚本。脚本会先在当前运行目录执行数据库备份,再校验发布清单、复制证书和环境配置、固定镜像标签,最后使用同一个 Compose 项目名逐步启动新服务。它不会执行 docker compose down,也不会删除卷;--accept-migrations 是确认已完成数据库备份的显式开关。

cd /opt/moyi/releases/<版本>/infra/moyi
python3 upgrade_release.py \
  --new-dir /opt/moyi/releases/<版本>/infra/moyi \
  --old-dir /opt/moyi/releases/<当前版本>/infra/moyi \
  --mode https --network --accept-migrations --smoke --login

不确定当前目录时可以省略 --old-dir,脚本会从 moyi-test-moyi-api-1 容器标签读取;如果备份、发布清单、镜像标签或配置校验失败,脚本会在启动新版前退出。通过 SSH heredoc 调用时,脚本及 deploy.py 会让子进程从 /dev/null 读取标准输入,避免 docker compose run 吃掉后续命令。

轻量应用服务器与RDS/Redis通常需要在阿里云控制台配置同地域内网互通和白名单;如果直接使用ECS并放在同一VPC,则不需要这层轻量服务器互通配置。OSS优先填写同地域内网Endpoint。

停止与数据

docker compose down

不要在没有备份的情况下使用 docker compose down -v,它会删除 PostgreSQL 和 Redis 的本地卷。

生产注意事项

  • 生产环境把 MOYI_HTTP_PORT 放在反向代理之后,只暴露 HTTPS 入口,不直接公网暴露 PostgreSQL 和 Redis。
  • POSTGRES_PASSWORD、REDIS_PASSWORD、AUTH_PASSWORD_PEPPER、管理员密码、供应商 Key 和 OSS Secret 不提交 Git,也不要写入前端构建参数。
  • OSS AccessKey 只授予目标 Bucket 的最小权限,应用使用临时凭证或 RAM 子账号优先。
  • 正式上线前固定基础镜像 digest,执行漏洞扫描、依赖许可证审计、数据库备份恢复演练和回滚演练。
  • Java 服务完成业务迁移后,再把数据库迁移、Redis 队列、OSS 对象元数据和监控告警纳入发布流水线。