130 lines
3.0 KiB
Markdown
130 lines
3.0 KiB
Markdown
# 🚀 部署工具 - 快速使用指南
|
||
|
||
## ⚡ 快速启动
|
||
|
||
### 方式 1：直接启动部署工具（推荐）
|
||
```bash
|
||
cd AdminTool
|
||
python deploy_tool.py
|
||
```
|
||
**自动跳转到部署功能，忽略后端 API 错误**
|
||
|
||
### 方式 2：完整管理工具
|
||
```bash
|
||
cd AdminTool
|
||
python admin_gui.py
|
||
```
|
||
手动切换到「自动化部署」标签页
|
||
|
||
---
|
||
|
||
## 📦 完整部署流程
|
||
|
||
### 1️⃣ 构建前端
|
||
```bash
|
||
cd D:\main\DesignerCEP\Designer
|
||
npm run build:core
|
||
```
|
||
等待构建完成，生成 `dist_core/` 目录
|
||
|
||
### 2️⃣ 启动部署工具
|
||
```bash
|
||
cd D:\main\DesignerCEP\AdminTool
|
||
python deploy_tool.py
|
||
```
|
||
|
||
### 3️⃣ 配置服务器（首次使用）
|
||
在「服务器配置」区域：
|
||
- 服务器地址：`103.97.201.136`
|
||
- SSH 端口：`22`
|
||
- 用户名：`root`
|
||
- 密码：`***`（填入实际密码）
|
||
|
||
点击「保存配置」
|
||
|
||
### 4️⃣ 部署
|
||
在「部署新版本」区域：
|
||
1. 点击「浏览...」选择 `Designer/dist_core` 目录
|
||
2. 输入备注（可选）：例如 `修复主题同步bug`
|
||
3. 点击 **「🚀 部署到服务器」**
|
||
|
||
### 5️⃣ 等待完成
|
||
部署日志会实时显示进度：
|
||
- ✅ 连接服务器
|
||
- ✅ 备份当前版本
|
||
- ✅ 上传新版本
|
||
- ✅ 保存版本历史
|
||
- ✅ 更新记录
|
||
|
||
完成后访问：https://app.aidg168.uk/
|
||
|
||
---
|
||
|
||
## 🔄 版本回滚
|
||
|
||
如果新版本有问题：
|
||
|
||
1. 在「版本历史管理」表格中查看所有版本
|
||
2. 点击要回滚的版本（表格行）
|
||
3. 点击 **「⏪ 回滚到选中版本」**
|
||
4. 确认操作
|
||
5. 刷新网站验证
|
||
|
||
---
|
||
|
||
## ⚠️ 常见问题
|
||
|
||
### Q: 启动时出现 "500 Server Error" 或 "获取组列表失败"？
|
||
**A**: 这是正常的，可以忽略！
|
||
- 这个错误来自后端 API（组管理功能）
|
||
- **不影响部署功能**
|
||
- 部署功能完全独立，使用 SSH 直接操作服务器
|
||
- 建议使用 `deploy_tool.py` 启动，自动跳过这个错误
|
||
|
||
### Q: 如何确认部署成功？
|
||
**A**:
|
||
1. 查看部署日志，最后应显示「🎉 部署完成！」
|
||
2. 访问 https://app.aidg168.uk/ 验证
|
||
3. 版本历史列表会显示新版本（带 ✅ 当前标记）
|
||
|
||
### Q: 部署需要多久？
|
||
**A**: 通常 1-2 分钟，取决于：
|
||
- 文件大小（dist_core 约 10-15MB）
|
||
- 网络速度
|
||
|
||
### Q: 可以删除旧版本吗？
|
||
**A**: 可以，但注意：
|
||
- ❌ 无法删除当前正在使用的版本
|
||
- 建议保留 3-5 个最近的版本用于回滚
|
||
|
||
---
|
||
|
||
## 🎯 部署前检查清单
|
||
|
||
- [ ] 已运行 `npm run build:core`
|
||
- [ ] `Designer/dist_core/` 目录存在
|
||
- [ ] 服务器 SSH 配置正确
|
||
- [ ] 已点击「测试连接」验证
|
||
|
||
---
|
||
|
||
## 📞 技术支持
|
||
|
||
- 详细文档：[部署功能使用说明.md](./部署功能使用说明.md)
|
||
- 修复说明：[修复说明.md](./修复说明.md)
|
||
- 测试系统：`python test_version_system.py`
|
||
|
||
---
|
||
|
||
## 💡 提示
|
||
|
||
1. **后端 API 错误不影响部署** - 部署功能完全独立
|
||
2. **首次使用建议测试** - 先部署一个测试版本熟悉流程
|
||
3. **保留历史版本** - 方便快速回滚
|
||
4. **非高峰期部署** - 避免影响线上用户
|
||
|
||
---
|
||
|
||
**开始使用：`python deploy_tool.py`** 🚀
|
||
|