144 lines
3.1 KiB
Markdown
144 lines
3.1 KiB
Markdown
# 快速部署参考卡片
|
|
|
|
## 🚀 一键部署命令
|
|
|
|
```bash
|
|
# 部署所有服务（推荐）
|
|
bash deploy-all.sh
|
|
|
|
# 仅部署后端
|
|
bash deploy-all.sh backend
|
|
|
|
# 仅部署前端
|
|
bash deploy-all.sh frontend
|
|
```
|
|
|
|
## 📱 访问地址
|
|
|
|
| 服务 | 地址 | 说明 |
|
|
|------|------|------|
|
|
| 前端 | http://101.200.208.45/emotion-museum/ | 主应用 |
|
|
| 后端 API | http://101.200.208.45:19089/api | REST API |
|
|
| WebSocket | ws://101.200.208.45:19089/ws | 实时通信 |
|
|
|
|
## ⏱️ 部署耗时
|
|
|
|
| 操作 | 耗时 |
|
|
|------|------|
|
|
| 后端编译 | 1-2 分钟 |
|
|
| 后端上传 | 30 秒 |
|
|
| 后端启动 | 30 秒 |
|
|
| 前端构建 | 1-2 分钟 |
|
|
| 前端上传 | 30 秒 |
|
|
| **总计** | **3-5 分钟** |
|
|
|
|
## ✅ 部署检查清单
|
|
|
|
部署前：
|
|
- [ ] 代码已提交
|
|
- [ ] 本地编译通过
|
|
- [ ] 没有未保存的文件
|
|
|
|
部署中：
|
|
- [ ] 脚本正常运行
|
|
- [ ] 没有错误提示
|
|
|
|
部署后：
|
|
- [ ] 前端可访问
|
|
- [ ] 后端 API 响应正常
|
|
- [ ] WebSocket 连接正常
|
|
|
|
## 🔍 快速验证
|
|
|
|
```bash
|
|
# 验证后端
|
|
curl http://101.200.208.45:19089/api/health
|
|
|
|
# 验证前端
|
|
curl http://101.200.208.45/emotion-museum/
|
|
|
|
# 查看后端日志
|
|
ssh root@101.200.208.45 "tail -f /data/logs/emotion-museum/emotion-single.log"
|
|
|
|
# 查看前端文件
|
|
ssh root@101.200.208.45 "ls -lh /data/www/emotion-museum/"
|
|
```
|
|
|
|
## 🆘 常见问题
|
|
|
|
| 问题 | 解决方案 |
|
|
|------|---------|
|
|
| JAR 文件不存在 | `cd backend-single && mvn clean package -DskipTests` |
|
|
| dist 目录不存在 | `cd web && npm install && npm run build` |
|
|
| SSH 连接失败 | `ssh-copy-id -i ~/.ssh/id_rsa.pub root@101.200.208.45` |
|
|
| 前端 404 | `ssh root@101.200.208.45 "nginx -s reload"` |
|
|
| 后端无响应 | `ssh root@101.200.208.45 "ps aux \| grep emotion"` |
|
|
|
|
## 📊 部署脚本结构
|
|
|
|
```
|
|
deploy-all.sh
|
|
├── 后端部署
|
|
│ ├── 检查脚本存在
|
|
│ ├── 执行 backend-single/deploy.sh
|
|
│ └── 验证部署结果
|
|
├── 前端部署
|
|
│ ├── 检查脚本存在
|
|
│ ├── 执行 web/deploy.sh
|
|
│ └── 验证部署结果
|
|
└── 输出部署总结
|
|
```
|
|
|
|
## 💡 最佳实践
|
|
|
|
1. **定期备份**
|
|
```bash
|
|
ssh root@101.200.208.45 "tar -czf /data/backups/emotion-museum-$(date +%Y%m%d).tar.gz /data/www/emotion-museum /data/programs/emotion-museum"
|
|
```
|
|
|
|
2. **查看部署历史**
|
|
```bash
|
|
ssh root@101.200.208.45 "ls -lh /data/logs/emotion-museum/"
|
|
```
|
|
|
|
3. **监控服务状态**
|
|
```bash
|
|
ssh root@101.200.208.45 "ps aux | grep emotion"
|
|
```
|
|
|
|
4. **查看磁盘使用**
|
|
```bash
|
|
ssh root@101.200.208.45 "df -h /data"
|
|
```
|
|
|
|
## 🔄 部署流程图
|
|
|
|
```
|
|
开始
|
|
↓
|
|
检查部署类型
|
|
├─→ backend: 执行后端部署
|
|
├─→ frontend: 执行前端部署
|
|
└─→ all: 执行后端 + 前端部署
|
|
↓
|
|
验证部署结果
|
|
├─→ 成功: 输出访问地址
|
|
└─→ 失败: 输出错误信息
|
|
↓
|
|
结束
|
|
```
|
|
|
|
## 📞 获取帮助
|
|
|
|
- 详细说明: `一键部署说明.md`
|
|
- 后端部署: `backend-single/部署说明.md`
|
|
- 前端部署: `web/部署说明.md`
|
|
- 后端脚本: `backend-single/deploy.sh`
|
|
- 前端脚本: `web/deploy.sh`
|
|
|
|
---
|
|
|
|
**快速参考版本**: 1.0
|
|
**最后更新**: 2025-10-26
|
|
|