3.2 KiB
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
轻量应用服务器与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 对象元数据和监控告警纳入发布流水线。