53 lines
2.6 KiB
Markdown
53 lines
2.6 KiB
Markdown
# MOYI 容器化部署基线
|
|
|
|
这套 Compose 用于 MOYI 的 Java 后端迁移基线:Vue 前端以 Nginx 生产构建运行,Java Control Plane 以 Spring Boot 运行,PostgreSQL 和 Redis 使用独立持久化卷。OSS 不在 Compose 中自建,生产环境连接云厂商 OSS;本地如需模拟对象存储,可另行增加 MinIO profile。
|
|
|
|
## 当前迁移状态
|
|
|
|
`control-plane-java/` 当前提供 Java 21 / Spring Boot 的认证、模型目录、项目、Key、权限和最小 OpenAI 兼容接口。真实供应商适配、Redis 队列/限流、异步任务和计费完成并通过 UAT 前,不要直接把生产流量切到 Java 服务。
|
|
|
|
## 启动
|
|
|
|
```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、Redis 和 OSS 不需要部署在轻量应用服务器上。云上使用托管服务时,复制 `.env.cloud.example` 为 `.env.cloud`,填写 RDS/Redis 私网连接信息,然后执行:
|
|
|
|
```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 对象元数据和监控告警纳入发布流水线。
|