60 lines
3.2 KiB
Markdown
60 lines
3.2 KiB
Markdown
# 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 对象元数据和监控告警纳入发布流水线。
|