llm-survey/doc/deployment.md

74 lines
1.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 部署文档
## 1. 开发环境配置
### 1.1 环境变量
- `DOCKER_DATA_DIR`: Docker数据目录默认为 `/Volumes/working/docker`
### 1.2 开发环境组件
- Tomcat: 运行在Docker容器中
- 数据目录: `$DOCKER_DATA_DIR/tomcat`
- 日志目录: `$DOCKER_DATA_DIR/tomcat/logs`
- 应用目录: `$DOCKER_DATA_DIR/tomcat/webapps`
## 2. 项目构建
### 2.1 编译打包
```bash
# 进入后端项目目录
cd backend
# 清理并打包项目(跳过测试)
mvn clean package -DskipTests
# 打包结果
# - WAR包位置backend/target/llm-survey-api.war
```
### 2.2 数据库初始化
```bash
# 进入数据库脚本目录
cd database
# 添加执行权限
chmod +x init_database.sh
# 执行初始化脚本
./init_database.sh
# 初始化内容
# - 创建数据库llm_survey
# - 创建表users, questions, options, survey_responses
# - 插入基础数据:工作领域和岗位性质相关的问题和选项
```
## 3. 开发环境部署
### 3.1 部署WAR包
```bash
# 复制WAR包到Tomcat的webapps目录
cp backend/target/llm-survey-api.war $DOCKER_DATA_DIR/tomcat/webapps/
# 部署后的访问地址
# - 上下文路径:/llm-survey-api
# - API基础路径/llm-survey-api/api
```
### 3.2 查看部署结果
```bash
# 查看Tomcat日志
tail -f $DOCKER_DATA_DIR/tomcat/logs/catalina.out
# 检查应用是否成功部署
ls -l $DOCKER_DATA_DIR/tomcat/webapps/llm-survey-api/
```
### 3.3 验证部署
- 访问测试接口:`http://localhost:8080/llm-survey-api/user/check/13800000000`
- 预期返回:`false`(表示手机号未注册)
## 4. 注意事项
1. 确保MySQL服务已启动且能够通过localhost:3306访问
2. 确保Tomcat容器已启动且8080端口可访问
3. 部署前确保数据库已正确初始化
4. 如需重新部署可直接覆盖webapps目录下的WAR包Tomcat会自动重新部署