343 lines
8.4 KiB
Markdown
343 lines
8.4 KiB
Markdown
# 情绪博物馆自定义目录部署指南
|
||
|
||
## 📋 部署架构
|
||
|
||
根据您的要求，本部署方案采用以下目录结构：
|
||
|
||
```
|
||
/data/
|
||
├── www/emotion-museum/ # 前端静态文件目录
|
||
│ ├── index.html
|
||
│ ├── assets/
|
||
│ └── ...
|
||
├── builds/ # 后端JAR文件目录
|
||
│ ├── emotion-gateway.jar
|
||
│ ├── emotion-ai.jar
|
||
│ └── emotion-user.jar
|
||
└── logs/emotion-museum/ # 日志目录
|
||
├── nginx/
|
||
├── gateway/
|
||
├── ai/
|
||
├── user/
|
||
├── mysql/
|
||
├── redis/
|
||
└── nacos/
|
||
```
|
||
|
||
## 🏗️ 服务架构
|
||
|
||
```
|
||
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
|
||
│ 用户访问 │───▶│ Nginx │───▶│ 静态文件 │
|
||
└─────────────┘ │ (80/443) │ │ /data/www/ │
|
||
└─────────────┘ └─────────────┘
|
||
│
|
||
▼
|
||
┌─────────────┐ ┌─────────────┐
|
||
│ API代理 │───▶│ Gateway │
|
||
│ /api/* │ │ (9000) │
|
||
└─────────────┘ └─────────────┘
|
||
│
|
||
▼
|
||
┌─────────────┐ ┌─────────────┐
|
||
│ 微服务集群 │ │ JAR文件 │
|
||
│ AI/User/... │ │ /data/builds│
|
||
└─────────────┘ └─────────────┘
|
||
```
|
||
|
||
## 🚀 快速部署
|
||
|
||
### 1. 准备环境
|
||
|
||
```bash
|
||
# 确保Docker和Docker Compose已安装
|
||
docker --version
|
||
docker-compose --version
|
||
|
||
# 创建必要目录
|
||
sudo mkdir -p /data/www/emotion-museum
|
||
sudo mkdir -p /data/builds
|
||
sudo mkdir -p /data/logs/emotion-museum
|
||
```
|
||
|
||
### 2. 配置环境变量
|
||
|
||
```bash
|
||
# 编辑环境变量文件
|
||
vim .env
|
||
```
|
||
|
||
**配置说明**：
|
||
```bash
|
||
# Coze API配置（已配置为与开发环境一致）
|
||
COZE_API_TOKEN=pat_GCR4qKzqpf90wMCvKsldMrB18KG3QsLDci65bZthssKsbLxu8X70BKYumleDcabO
|
||
|
||
# 数据库密码（可根据需要修改）
|
||
MYSQL_ROOT_PASSWORD=123456
|
||
MYSQL_PASSWORD=emotion123
|
||
```
|
||
|
||
### 3. 一键部署
|
||
|
||
```bash
|
||
# 给脚本执行权限
|
||
chmod +x deploy-custom.sh
|
||
|
||
# 执行自定义部署
|
||
./deploy-custom.sh
|
||
```
|
||
|
||
## 📁 文件说明
|
||
|
||
### 新增配置文件
|
||
|
||
1. **`docker-compose.custom.yml`** - 自定义Docker配置
|
||
- 前端文件直接从宿主机目录提供
|
||
- 后端JAR文件挂载到容器
|
||
- 日志统一保存到指定目录
|
||
|
||
2. **`deploy-custom.sh`** - 自定义部署脚本
|
||
- 自动检查和构建前后端
|
||
- 部署文件到指定目录
|
||
- 启动Docker服务
|
||
|
||
3. **`manage-custom.sh`** - 自定义管理脚本
|
||
- 服务管理和监控
|
||
- 日志查看和健康检查
|
||
- 数据备份和恢复
|
||
|
||
### 修改的配置文件
|
||
|
||
1. **`deploy/nginx/conf.d/emotion-museum.conf`** - Nginx配置
|
||
- 前端文件直接从 `/data/www/emotion-museum` 提供
|
||
- API请求代理到Docker容器内的服务
|
||
- 日志保存到 `/data/logs/emotion-museum/nginx/`
|
||
|
||
2. **`deploy/nginx/nginx.conf`** - Nginx主配置
|
||
- 更新上游服务器定义
|
||
- 支持容器间通信
|
||
|
||
## 🔧 端口配置
|
||
|
||
| 服务 | 容器端口 | 宿主机端口 | 说明 |
|
||
|------|----------|------------|------|
|
||
| Nginx | 80/443 | 80/443 | Web访问 |
|
||
| Gateway | 9000 | 9000 | API网关 |
|
||
| AI Service | 9002 | 9002 | AI服务 |
|
||
| User Service | 9001 | 9001 | 用户服务 |
|
||
| MySQL | 3306 | 3306 | 数据库 |
|
||
| Redis | 6379 | 6379 | 缓存 |
|
||
| Nacos | 8848 | 8848 | 注册中心 |
|
||
|
||
## 🛠️ 管理命令
|
||
|
||
### 服务管理
|
||
```bash
|
||
# 启动所有服务
|
||
./manage-custom.sh start
|
||
|
||
# 停止所有服务
|
||
./manage-custom.sh stop
|
||
|
||
# 重启所有服务
|
||
./manage-custom.sh restart
|
||
|
||
# 重启指定服务
|
||
./manage-custom.sh restart emotion-ai
|
||
|
||
# 查看服务状态
|
||
./manage-custom.sh status
|
||
```
|
||
|
||
### 日志管理
|
||
```bash
|
||
# 查看所有日志
|
||
./manage-custom.sh logs
|
||
|
||
# 跟踪日志输出
|
||
./manage-custom.sh logs -f
|
||
|
||
# 查看指定服务日志
|
||
./manage-custom.sh logs -s nginx
|
||
./manage-custom.sh logs -s emotion-gateway
|
||
```
|
||
|
||
### 健康检查
|
||
```bash
|
||
# 执行健康检查
|
||
./manage-custom.sh health
|
||
|
||
# 实时监控
|
||
./manage-custom.sh monitor
|
||
```
|
||
|
||
### 数据管理
|
||
```bash
|
||
# 备份数据
|
||
./manage-custom.sh backup
|
||
|
||
# 更新服务
|
||
./manage-custom.sh update
|
||
|
||
# 清理资源
|
||
./manage-custom.sh clean
|
||
```
|
||
|
||
## 📊 目录详情
|
||
|
||
### 前端目录 `/data/www/emotion-museum/`
|
||
```
|
||
/data/www/emotion-museum/
|
||
├── index.html # 主页面
|
||
├── assets/ # 静态资源
|
||
│ ├── css/ # 样式文件
|
||
│ ├── js/ # JavaScript文件
|
||
│ └── images/ # 图片文件
|
||
└── favicon.ico # 网站图标
|
||
```
|
||
|
||
### 后端目录 `/data/builds/`
|
||
```
|
||
/data/builds/
|
||
├── emotion-gateway.jar # 网关服务JAR
|
||
├── emotion-ai.jar # AI服务JAR
|
||
└── emotion-user.jar # 用户服务JAR
|
||
```
|
||
|
||
### 日志目录 `/data/logs/emotion-museum/`
|
||
```
|
||
/data/logs/emotion-museum/
|
||
├── nginx/ # Nginx日志
|
||
│ ├── access.log
|
||
│ └── error.log
|
||
├── gateway/ # 网关服务日志
|
||
├── ai/ # AI服务日志
|
||
├── user/ # 用户服务日志
|
||
├── mysql/ # MySQL日志
|
||
├── redis/ # Redis日志
|
||
└── nacos/ # Nacos日志
|
||
```
|
||
|
||
## 🔄 更新流程
|
||
|
||
### 更新前端
|
||
```bash
|
||
# 1. 重新构建前端
|
||
cd web
|
||
npm run build
|
||
|
||
# 2. 部署到目标目录
|
||
sudo rm -rf /data/www/emotion-museum/*
|
||
sudo cp -r dist/* /data/www/emotion-museum/
|
||
sudo chown -R www-data:www-data /data/www/emotion-museum
|
||
|
||
# 3. 重启Nginx（可选）
|
||
./manage-custom.sh restart nginx
|
||
```
|
||
|
||
### 更新后端
|
||
```bash
|
||
# 1. 重新构建后端
|
||
cd backend
|
||
mvn clean package -DskipTests
|
||
|
||
# 2. 部署JAR文件
|
||
sudo cp emotion-gateway/target/emotion-gateway-1.0.0.jar /data/builds/emotion-gateway.jar
|
||
sudo cp emotion-ai/target/emotion-ai-1.0.0.jar /data/builds/emotion-ai.jar
|
||
sudo cp emotion-user/target/emotion-user-1.0.0.jar /data/builds/emotion-user.jar
|
||
|
||
# 3. 重启相关服务
|
||
./manage-custom.sh restart emotion-gateway
|
||
./manage-custom.sh restart emotion-ai
|
||
./manage-custom.sh restart emotion-user
|
||
```
|
||
|
||
### 一键更新
|
||
```bash
|
||
# 自动构建和部署
|
||
./manage-custom.sh update
|
||
```
|
||
|
||
## 🚨 故障排除
|
||
|
||
### 常见问题
|
||
|
||
#### 1. 前端访问404
|
||
```bash
|
||
# 检查前端文件是否存在
|
||
ls -la /data/www/emotion-museum/
|
||
|
||
# 检查Nginx配置
|
||
./manage-custom.sh logs -s nginx
|
||
|
||
# 检查文件权限
|
||
sudo chown -R www-data:www-data /data/www/emotion-museum
|
||
```
|
||
|
||
#### 2. API调用失败
|
||
```bash
|
||
# 检查网关服务状态
|
||
./manage-custom.sh logs -s emotion-gateway
|
||
|
||
# 检查服务健康状态
|
||
curl http://localhost:9000/actuator/health
|
||
```
|
||
|
||
#### 3. 服务启动失败
|
||
```bash
|
||
# 检查JAR文件是否存在
|
||
ls -la /data/builds/
|
||
|
||
# 检查服务日志
|
||
./manage-custom.sh logs -s emotion-ai
|
||
|
||
# 检查容器状态
|
||
docker-compose -f docker-compose.custom.yml ps
|
||
```
|
||
|
||
#### 4. 日志文件过大
|
||
```bash
|
||
# 清理日志文件
|
||
sudo find /data/logs/emotion-museum -name "*.log" -size +100M -delete
|
||
|
||
# 设置日志轮转
|
||
sudo logrotate -f /etc/logrotate.conf
|
||
```
|
||
|
||
## 📞 技术支持
|
||
|
||
### 快速诊断
|
||
```bash
|
||
# 执行健康检查
|
||
./manage-custom.sh health
|
||
|
||
# 查看服务状态
|
||
./manage-custom.sh status
|
||
|
||
# 查看实时监控
|
||
./manage-custom.sh monitor
|
||
```
|
||
|
||
### 获取帮助
|
||
```bash
|
||
# 查看管理命令帮助
|
||
./manage-custom.sh --help
|
||
|
||
# 查看部署脚本帮助
|
||
./deploy-custom.sh --help
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ 部署检查清单
|
||
|
||
- [ ] **目录创建**: `/data/www/emotion-museum`, `/data/builds`, `/data/logs/emotion-museum`
|
||
- [ ] **环境配置**: `COZE_API_TOKEN` 已配置为与开发环境一致
|
||
- [ ] **前端部署**: 静态文件已复制到 `/data/www/emotion-museum/`
|
||
- [ ] **后端部署**: JAR文件已复制到 `/data/builds/`
|
||
- [ ] **服务启动**: 所有Docker容器正常运行
|
||
- [ ] **访问测试**: 前端页面和API接口正常访问
|
||
- [ ] **日志检查**: 日志文件正常生成到 `/data/logs/emotion-museum/`
|
||
|
||
**🎉 恭喜！您的情绪博物馆项目已成功部署到自定义目录结构！**
|