# MOYI 容器化部署基线 ## 北京服务器测试部署(当前入口) 当前已确认 Ubuntu 24.04 / 4C8G、RDS PostgreSQL 15、Tair 标准架构、`moyi.soulofmodel.com`。 完整阿里云配置、发布包、环境变量、证书、启动和回退说明见 [服务器测试部署手册](../../docs/11-server-test-deployment.md)。 推荐 `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 和计费仍未完成,不要直接切入生产流量。 ## 启动 ```powershell cd infra/moyi Copy-Item .env.example .env ``` 编辑 `.env` 中的数据库、Redis、管理员和密钥变量,然后执行: ```powershell 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 行为;默认只在服务器回环地址监听: ```powershell 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。 ## 停止与数据 ```powershell 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 对象元数据和监控告警纳入发布流水线。