261 lines
4.5 KiB
Markdown
261 lines
4.5 KiB
Markdown
# 情绪博物馆 - 测试环境部署指南
|
|
|
|
## 项目简介
|
|
|
|
情绪博物馆是一个基于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. 一键部署
|
|
|
|
```bash
|
|
# 下载部署包并解压
|
|
cd emotion-museum-1.0.0-20250713_111829
|
|
|
|
# 执行一键部署（包含环境安装、数据库初始化、服务部署）
|
|
chmod +x deploy.sh
|
|
./deploy.sh
|
|
```
|
|
|
|
### 3. 分步部署
|
|
|
|
如果需要分步执行，可以使用以下命令：
|
|
|
|
```bash
|
|
# 1. 安装基础环境 (Java, Maven, Node.js, Docker等)
|
|
./deploy.sh install-env
|
|
|
|
# 2. 初始化数据库
|
|
./deploy.sh init-db
|
|
|
|
# 3. 构建应用镜像
|
|
./deploy.sh build
|
|
|
|
# 4. 启动服务
|
|
./deploy.sh start
|
|
```
|
|
|
|
### 4. 跳过某些步骤
|
|
|
|
```bash
|
|
# 跳过环境安装（如果已安装）
|
|
./deploy.sh --skip-env
|
|
|
|
# 跳过数据库初始化（如果已初始化）
|
|
./deploy.sh --skip-db
|
|
|
|
# 启用调试模式
|
|
./deploy.sh --debug
|
|
```
|
|
|
|
## 服务管理
|
|
|
|
### 查看服务状态
|
|
```bash
|
|
./deploy.sh status
|
|
```
|
|
|
|
### 查看服务日志
|
|
```bash
|
|
# 查看所有服务日志
|
|
./deploy.sh logs
|
|
|
|
# 查看特定服务日志
|
|
./deploy.sh logs gateway
|
|
./deploy.sh logs user-service
|
|
./deploy.sh logs ai-service
|
|
|
|
# 实时跟踪日志
|
|
./deploy.sh logs -f
|
|
```
|
|
|
|
### 重启服务
|
|
```bash
|
|
# 重启所有服务
|
|
./deploy.sh restart
|
|
|
|
# 重启特定服务
|
|
./deploy.sh restart gateway
|
|
```
|
|
|
|
### 停止服务
|
|
```bash
|
|
./deploy.sh stop
|
|
```
|
|
|
|
### 健康检查
|
|
```bash
|
|
./deploy.sh health
|
|
```
|
|
|
|
### 备份数据
|
|
```bash
|
|
./deploy.sh backup
|
|
```
|
|
|
|
### 更新服务
|
|
```bash
|
|
./deploy.sh update
|
|
```
|
|
|
|
### 清理资源
|
|
```bash
|
|
./deploy.sh clean
|
|
```
|
|
|
|
## 访问地址
|
|
|
|
部署完成后，可以通过以下地址访问：
|
|
|
|
- **前端应用**: http://localhost
|
|
- **API网关**: http://localhost:9000
|
|
- **Nacos控制台**: http://localhost:8848/nacos (用户名/密码: nacos/nacos)
|
|
|
|
## 配置说明
|
|
|
|
### 环境变量配置
|
|
|
|
主要配置文件：`.env.test`
|
|
|
|
```bash
|
|
# 服务器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
|
|
|
|
## 故障排除
|
|
|
|
### 常见问题
|
|
|
|
1. **Docker服务未启动**
|
|
```bash
|
|
sudo systemctl start docker
|
|
sudo systemctl enable docker
|
|
```
|
|
|
|
2. **端口被占用**
|
|
```bash
|
|
# 查看端口占用
|
|
netstat -tlnp | grep :端口号
|
|
|
|
# 修改 .env.test 文件中的端口配置
|
|
```
|
|
|
|
3. **内存不足**
|
|
```bash
|
|
# 调整JVM内存配置
|
|
export JVM_XMS=256m
|
|
export JVM_XMX=512m
|
|
```
|
|
|
|
4. **数据库连接失败**
|
|
```bash
|
|
# 检查MySQL容器状态
|
|
docker logs emotion-mysql
|
|
|
|
# 重新初始化数据库
|
|
./deploy.sh init-db
|
|
```
|
|
|
|
### 查看详细日志
|
|
|
|
```bash
|
|
# 查看部署日志
|
|
./deploy.sh logs --debug
|
|
|
|
# 查看容器状态
|
|
docker ps -a
|
|
|
|
# 查看容器日志
|
|
docker logs emotion-gateway
|
|
docker logs emotion-mysql
|
|
docker logs emotion-nacos
|
|
```
|
|
|
|
## 开发调试
|
|
|
|
### 本地开发模式
|
|
|
|
```bash
|
|
# 启用调试模式
|
|
export DEBUG_MODE=true
|
|
./deploy.sh --debug
|
|
```
|
|
|
|
### 修改配置
|
|
|
|
1. 修改后端配置：`backend/config/application-test.yml`
|
|
2. 修改前端配置：`frontend/config/test.env.js`
|
|
3. 修改环境变量：`.env.test`
|
|
|
|
### 重新构建
|
|
|
|
```bash
|
|
# 重新构建并部署
|
|
./deploy.sh build
|
|
./deploy.sh restart
|
|
```
|
|
|
|
## 生产环境部署
|
|
|
|
1. 修改 `.env.test` 中的配置
|
|
2. 配置实际的服务器IP
|
|
3. 配置HTTPS证书（如需要）
|
|
4. 配置域名解析（如需要）
|
|
5. 调整资源限制和性能参数
|
|
|
|
## 技术支持
|
|
|
|
如遇到问题，请检查：
|
|
|
|
1. 系统资源是否充足
|
|
2. 网络连接是否正常
|
|
3. 配置文件是否正确
|
|
4. 日志中的错误信息
|
|
|
|
更多详细信息请参考：
|
|
- `DEPLOY.md` - 详细部署文档
|
|
- `QUICK_START.md` - 快速开始指南
|