7.1 KiB
7.1 KiB
情绪博物馆测试环境快速部署指南
📦 包内容说明
emotion-museum-1.0.0-YYYYMMDD_HHMMSS/
├── frontend/ # 前端构建产物
│ ├── assets/ # 静态资源
│ ├── index.html # 主页面
│ ├── Dockerfile # 前端容器配置
│ ├── nginx.conf # Nginx配置
│ └── config/ # 前端配置
├── backend/ # 后端JAR文件
│ ├── emotion-gateway-*.jar # 网关服务
│ ├── emotion-ai-*.jar # AI服务
│ ├── emotion-user-*.jar # 用户服务
│ ├── config/ # 配置文件
│ │ ├── application-test.yml
│ │ ├── gateway-test.yml
│ │ └── ai-test.yml
│ ├── gateway-Dockerfile # 网关容器配置
│ ├── ai-Dockerfile # AI服务容器配置
│ └── user-Dockerfile # 用户服务容器配置
├── database/ # 数据库脚本
│ ├── mysql_emotion_museum_final.sql
│ └── verify-database-script.sql
├── deploy/ # 部署配置
│ ├── nginx/conf.d/ # Nginx配置
│ ├── mysql/conf.d/ # MySQL配置
│ └── redis/ # Redis配置
├── docker-compose.yml # 默认配置
├── docker-compose.test.yml # 测试环境配置
├── deploy.sh # 主部署脚本
├── install-environment.sh # 环境安装脚本
├── init-database.sh # 数据库初始化脚本
├── manage.sh # 管理脚本（兼容）
├── .env.test # 测试环境变量
├── README.md # 快速开始指南
├── VERSION.txt # 版本信息
├── DEPLOY.md # 详细部署文档
└── QUICK_START.md # 本文件
🚀 快速部署步骤
1. 系统要求
- 操作系统: Linux/macOS (推荐 Ubuntu 20.04+)
- 内存: 最少4GB，推荐8GB+
- 磁盘: 最少20GB可用空间
- 网络: 能够访问互联网
2. 部署步骤
方式一：一键部署（推荐）
# 1. 解压部署包
tar -xzf emotion-museum-*.tar.gz
cd emotion-museum-*
# 2. 配置环境变量（重要）
vim .env.test
# 修改 SERVER_IP 为实际IP
# 配置 COZE_API_TOKEN
# 3. 一键部署（包含环境安装、数据库初始化、服务部署）
chmod +x deploy.sh
./deploy.sh
方式二：分步部署
# 1. 解压部署包
tar -xzf emotion-museum-*.tar.gz
cd emotion-museum-*
# 2. 配置环境变量
vim .env.test
# 3. 分步部署
chmod +x deploy.sh
./deploy.sh install-env # 安装环境
./deploy.sh init-db # 初始化数据库
./deploy.sh build # 构建镜像
./deploy.sh start # 启动服务
方式三：跳过某些步骤
# 如果已安装环境，跳过环境安装
./deploy.sh --skip-env
# 如果已初始化数据库，跳过数据库初始化
./deploy.sh --skip-db
# 启用调试模式
./deploy.sh --debug
3. 验证部署
# 查看服务状态
./deploy.sh status
# 健康检查
./deploy.sh health
# 查看日志
./deploy.sh logs
4. 访问应用
- 前端应用: http://localhost (或 http://your-server-ip)
- API网关: http://localhost:9000
- Nacos控制台: http://localhost:8848/nacos (nacos/nacos)
⚙️ 配置说明
必须配置项
编辑 .env.test 文件中的以下配置：
# 服务器IP（重要：修改为实际IP）
SERVER_IP=your-server-ip
# Coze API配置（必须）
COZE_API_TOKEN=your-actual-coze-api-token
# 数据库密码（建议修改）
MYSQL_ROOT_PASSWORD=your-secure-password
MYSQL_PASSWORD=your-secure-password
# JWT密钥（建议修改）
JWT_SECRET=your-production-jwt-secret-key
可选配置项
# 时区设置
TZ=Asia/Shanghai
# 端口配置
GATEWAY_PORT=9000
USER_SERVICE_PORT=9001
AI_SERVICE_PORT=9002
# 日志和存储路径
LOG_PATH=/data/logs/emotion-museum
UPLOAD_PATH=/data/uploads/emotion-museum
🛠️ 管理命令
# 主要部署命令
./deploy.sh # 完整部署
./deploy.sh start # 启动服务
./deploy.sh stop # 停止服务
./deploy.sh restart # 重启服务
./deploy.sh status # 查看状态
# 日志管理
./deploy.sh logs # 查看所有日志
./deploy.sh logs -f # 跟踪日志
./deploy.sh logs gateway # 查看网关日志
./deploy.sh logs ai-service # 查看AI服务日志
# 数据管理
./deploy.sh backup # 备份数据
./deploy.sh health # 健康检查
./deploy.sh clean # 清理资源
# 独立脚本
./install-environment.sh # 安装环境
./init-database.sh # 初始化数据库
# 兼容命令（旧版本）
./manage.sh start # 启动服务
./manage.sh status # 查看状态
🔧 生产环境配置
1. 使用生产配置
# 使用生产环境配置
docker-compose -f docker-compose.prod.yml up -d
2. 配置HTTPS
# 1. 放置SSL证书
cp your-domain.crt deploy/nginx/ssl/emotion-museum.crt
cp your-domain.key deploy/nginx/ssl/emotion-museum.key
# 2. 修改Nginx配置
vim deploy/nginx/conf.d/emotion-museum.conf
# 取消HTTPS相关配置的注释
# 3. 重启Nginx
docker-compose restart nginx
3. 配置域名
# 修改Nginx配置中的域名
vim deploy/nginx/conf.d/emotion-museum.conf
# 将 localhost 替换为您的域名
🚨 故障排除
常见问题
-
环境安装失败
# 检查系统要求 ./install-environment.sh verify # 手动安装特定组件 ./install-environment.sh docker -
端口冲突
# 检查端口占用 netstat -tlnp | grep :80 netstat -tlnp | grep :3306 # 修改 .env.test 中的端口配置 -
数据库初始化失败
# 查看MySQL容器日志 docker logs emotion-mysql # 重新初始化 ./init-database.sh clean ./init-database.sh -
服务启动失败
# 查看服务日志 ./deploy.sh logs service-name # 查看容器状态 docker ps -a -
网络连接问题
# 检查Docker网络 docker network ls # 健康检查 ./deploy.sh health
获取帮助
- 查看详细文档:
cat DEPLOY.md - 查看快速指南:
cat README.md - 查看版本信息:
cat VERSION.txt - 查看部署命令:
./deploy.sh --help
📞 技术支持
如遇到问题，请按以下步骤排查：
- 查看详细日志：
./deploy.sh logs --debug - 检查服务状态：
./deploy.sh status - 验证配置文件：检查
.env.test配置 - 查看详细文档：
DEPLOY.md - 重新部署：
./deploy.sh clean && ./deploy.sh
📝 重要提醒
- ⚠️ 首次部署：请务必修改
.env.test中的SERVER_IP和COZE_API_TOKEN - ⚠️ 生产环境：请修改所有默认密码和密钥
- ⚠️ 防火墙：确保开放必要的端口 (80, 3306, 6379, 8848, 9000-9002)
部署完成后，请及时修改默认密码和敏感配置！