🚀 MBE开发环境部署 - 准备工作

⚠️ 部署前必须完成的步骤

1. 启动Docker Desktop

当前状态: ❌ Docker未运行

操作步骤:

1. 打开 Docker Desktop 应用程序
2. 等待Docker完全启动（任务栏图标不再转动）
3. 确认Docker正在运行

验证Docker状态:

docker ps
# 应该显示容器列表（可能为空）
# 如果显示错误，说明Docker未启动

2. 配置环境变量

当前配置文件: .env.development

必须修改的配置:

# LLM API密钥（必须修改）
LLM_API_KEY=sk-your-deepseek-api-key-here

可选配置:

# 数据库密码（开发环境可以使用默认值）
DB_PASSWORD=mbe_dev_password_2026

# 安全密钥（开发环境可以使用默认值）
SECRET_KEY=dev-secret-key-change-in-production-min-32-chars

如何获取DeepSeek API密钥:

1. 访问 https://platform.deepseek.com/
2. 注册/登录账号
3. 进入"API Keys"页面
4. 创建新的API Key
5. 复制密钥（格式：sk-xxxxxxxxxxxxxxxx）
6. 粘贴到 .env.development 文件中

3. 检查系统资源

最低要求:

• 内存: 8GB RAM
• 硬盘: 20GB 可用空间
• CPU: 4核心

推荐配置:

• 内存: 16GB+ RAM
• 硬盘: 50GB+ 可用空间
• CPU: 8核心+

检查可用资源:

# 检查内存
systeminfo | Select-String "可用物理内存"

# 检查磁盘空间
Get-PSDrive C | Select-Object Used,Free

✅ 准备就绪后执行部署

方式1: 使用部署脚本（推荐）

# 进入项目目录
cd d:\Mises\mises-behavior-engine

# 运行部署脚本
.\scripts\deploy_complete_development.ps1

方式2: 手动部署

# 进入项目目录
cd d:\Mises\mises-behavior-engine

# 使用docker-compose部署
docker-compose -f docker-compose.complete.yml --env-file .env.development up -d

📊 部署过程说明

会发生什么？

1. 停止旧容器 (~10秒)

   • 如果有旧的容器在运行，会先停止

2. 构建Docker镜像 (首次: ~10分钟，之后: ~2分钟)

   • 构建MBE核心API镜像
   • 构建Admin UI镜像
   • 构建3个前端应用镜像
   • 使用缓存加速后续构建

3. 启动所有服务 (~30秒)

   • PostgreSQL数据库
   • Redis缓存
   • MBE核心API（包含专家市场、应用市场）
   • Admin UI
   • MBE Education
   • AIGC Committee
   • Civil Lawyer

4. 初始化数据库 (~10秒)

   • 创建数据表
   • 导入初始数据

5. 健康检查 (~10秒)

   • 验证所有服务正常运行

总耗时:

• 首次部署: ~15分钟
• 后续部署: ~3分钟

🎯 部署后访问地址

核心服务

✅ MBE API:          http://localhost:8001
✅ API文档:          http://localhost:8001/docs
✅ gRPC:             localhost:50051

管理界面

✅ Admin UI:         http://localhost:3010

前端应用

✅ MBE Education:    http://localhost:3011
✅ AIGC Committee:   http://localhost:3012
✅ Civil Lawyer:     http://localhost:3014

数据库

✅ PostgreSQL:       localhost:5433
   用户名: mbe
   密码: mbe_dev_password_2026
   数据库: mbe

✅ Redis:            localhost:6380

📋 部署检查清单

部署前确认：

• Docker Desktop已启动
• .env.development中的LLM_API_KEY已配置
• 系统有足够的内存和磁盘空间
• 端口未被占用（8001, 3010-3014, 5433, 6380）

部署后验证：

• 所有容器都在运行（docker ps）
• API健康检查通过（访问 http://localhost:8001/health）
• 前端应用可以访问
• 数据库连接正常

🔍 验证部署

快速验证

# 查看所有容器状态
docker ps

# 应该看到以下容器：
# - mbe-api
# - mbe-admin-ui
# - mbe-education
# - mbe-aigc-committee
# - mbe-civil-lawyer
# - mbe-postgres
# - mbe-redis

健康检查

# 运行健康检查脚本
.\scripts\check_deployment.ps1 -Environment development

测试API

# 测试API响应
curl http://localhost:8001/health

# 应该返回：{"status":"ok"}

测试前端

在浏览器中访问：

• http://localhost:3011 (Education)
• http://localhost:3012 (AIGC)
• http://localhost:3014 (Lawyer)

📝 查看日志

查看所有日志

docker-compose -f docker-compose.complete.yml --env-file .env.development logs -f

查看特定服务日志

# API日志
docker logs -f mbe-api

# Admin UI日志
docker logs -f mbe-admin-ui

# Education日志
docker logs -f mbe-education

# 数据库日志
docker logs -f mbe-postgres

🛠️ 常用命令

停止所有服务

docker-compose -f docker-compose.complete.yml --env-file .env.development down

重启服务

# 重启所有服务
docker-compose -f docker-compose.complete.yml --env-file .env.development restart

# 重启特定服务
docker restart mbe-api
docker restart mbe-education

重新构建

# 重新构建所有镜像
docker-compose -f docker-compose.complete.yml --env-file .env.development build --no-cache

# 重新构建特定服务
docker-compose -f docker-compose.complete.yml build mbe-api

🚨 常见问题

问题1: Docker未运行

错误: failed to connect to the docker API

解决:

1. 启动Docker Desktop
2. 等待完全启动
3. 重新运行部署脚本

问题2: 端口被占用

错误: port is already allocated

解决:

# 查看占用端口的进程
netstat -ano | findstr :8001
netstat -ano | findstr :3011

# 停止占用端口的进程
Stop-Process -Id <PID>

# 或修改.env.development中的端口

问题3: 内存不足

错误: 容器频繁重启或OOM

解决:

1. 关闭其他应用程序释放内存
2. 增加Docker Desktop的内存限制
   • 打开Docker Desktop → Settings → Resources → Memory
   • 建议设置为8GB+

问题4: 构建失败

错误: 镜像构建过程中出错

解决:

# 清理Docker缓存
docker system prune -a

# 重新构建
docker-compose -f docker-compose.complete.yml --env-file .env.development build --no-cache

💡 开发技巧

热重载

开发环境已配置volume挂载，修改代码会自动重载：

Python代码 (src/)

• 修改后API自动重启（~5秒）

前端代码 (opensource/)

• 修改后浏览器自动刷新（~2秒）

访问本地文件

所有大文件都可以直接访问：

✅ PDF文档: d:\Mises\mises-behavior-engine\docs\expert\
✅ 训练数据: d:\Mises\mises-behavior-engine\training\
✅ 知识库: d:\Mises\mises-behavior-engine\knowledge_bases\

调试

# 进入容器
docker exec -it mbe-api bash

# 查看Python环境
docker exec -it mbe-api python --version

# 运行Python命令
docker exec -it mbe-api python -c "import src; print(src.__file__)"

📚 相关文档

• 数据管理策略
• Docker镜像优化
• 完整部署指南
• 系统架构

🎯 准备好了吗？

确认以下事项：

1. ✅ Docker Desktop已启动并运行
2. ✅ LLM_API_KEY已配置在.env.development
3. ✅ 系统资源充足

现在可以运行部署脚本了！

cd d:\Mises\mises-behavior-engine
.\scripts\deploy_complete_development.ps1

文档创建时间: 2026-02-01
适用环境: 开发环境
预计部署时间: 首次15分钟，后续3分钟

🚀 准备就绪，开始部署！