4.5 KiB
4.5 KiB
情绪博物馆 - 测试环境部署指南
项目简介
情绪博物馆是一个基于Spring Cloud Alibaba微服务架构的情感AI对话平台，集成了Coze AI平台，提供智能情感分析和对话功能。
系统架构
- 前端: Vue 3 + Ant Design
- 网关: Spring Cloud Gateway
- 微服务: 用户服务、AI服务
- 注册中心: Nacos
- 数据库: MySQL 8.0
- 缓存: Redis 7
- 容器化: Docker + Docker Compose
快速部署
1. 环境要求
- 操作系统: Linux/macOS/Windows (推荐 Ubuntu 20.04+)
- 内存: 最低 4GB，推荐 8GB+
- 磁盘: 最低 20GB 可用空间
- 网络: 能够访问互联网
2. 一键部署
# 下载部署包并解压
cd emotion-museum-1.0.0-20250713_111829
# 执行一键部署（包含环境安装、数据库初始化、服务部署）
chmod +x deploy.sh
./deploy.sh
3. 分步部署
如果需要分步执行，可以使用以下命令：
# 1. 安装基础环境 (Java, Maven, Node.js, Docker等)
./deploy.sh install-env
# 2. 初始化数据库
./deploy.sh init-db
# 3. 构建应用镜像
./deploy.sh build
# 4. 启动服务
./deploy.sh start
4. 跳过某些步骤
# 跳过环境安装（如果已安装）
./deploy.sh --skip-env
# 跳过数据库初始化（如果已初始化）
./deploy.sh --skip-db
# 启用调试模式
./deploy.sh --debug
服务管理
查看服务状态
./deploy.sh status
查看服务日志
# 查看所有服务日志
./deploy.sh logs
# 查看特定服务日志
./deploy.sh logs gateway
./deploy.sh logs user-service
./deploy.sh logs ai-service
# 实时跟踪日志
./deploy.sh logs -f
重启服务
# 重启所有服务
./deploy.sh restart
# 重启特定服务
./deploy.sh restart gateway
停止服务
./deploy.sh stop
健康检查
./deploy.sh health
备份数据
./deploy.sh backup
更新服务
./deploy.sh update
清理资源
./deploy.sh clean
访问地址
部署完成后，可以通过以下地址访问：
- 前端应用: http://localhost
- API网关: http://localhost:9000
- Nacos控制台: http://localhost:8848/nacos (用户名/密码: nacos/nacos)
配置说明
环境变量配置
主要配置文件：.env.test
# 服务器IP（重要：部署时请修改为实际IP）
SERVER_IP=localhost
# 数据库配置
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USERNAME=emotion
MYSQL_PASSWORD=emotion123
# Redis配置
REDIS_HOST=localhost
REDIS_PORT=6379
# Nacos配置
NACOS_SERVER_ADDR=localhost:8848
# COZE AI配置（重要：请配置实际的API Token）
COZE_API_TOKEN=your-coze-api-token
端口配置
- 前端: 80 (Nginx)
- 网关: 9000
- 用户服务: 9001
- AI服务: 9002
- MySQL: 3306
- Redis: 6379
- Nacos: 8848
故障排除
常见问题
-
Docker服务未启动
sudo systemctl start docker sudo systemctl enable docker -
端口被占用
# 查看端口占用 netstat -tlnp | grep :端口号 # 修改 .env.test 文件中的端口配置 -
内存不足
# 调整JVM内存配置 export JVM_XMS=256m export JVM_XMX=512m -
数据库连接失败
# 检查MySQL容器状态 docker logs emotion-mysql # 重新初始化数据库 ./deploy.sh init-db
查看详细日志
# 查看部署日志
./deploy.sh logs --debug
# 查看容器状态
docker ps -a
# 查看容器日志
docker logs emotion-gateway
docker logs emotion-mysql
docker logs emotion-nacos
开发调试
本地开发模式
# 启用调试模式
export DEBUG_MODE=true
./deploy.sh --debug
修改配置
- 修改后端配置：
backend/config/application-test.yml - 修改前端配置：
frontend/config/test.env.js - 修改环境变量：
.env.test
重新构建
# 重新构建并部署
./deploy.sh build
./deploy.sh restart
生产环境部署
- 修改
.env.test中的配置 - 配置实际的服务器IP
- 配置HTTPS证书（如需要）
- 配置域名解析（如需要）
- 调整资源限制和性能参数
技术支持
如遇到问题，请检查：
- 系统资源是否充足
- 网络连接是否正常
- 配置文件是否正确
- 日志中的错误信息
更多详细信息请参考：
DEPLOY.md- 详细部署文档QUICK_START.md- 快速开始指南