Files
DP/tempdocs/部署工具使用.md
zuowei1216 1b19ff1b92 20251222
2025-12-22 21:06:29 +08:00

3.0 KiB
Raw Blame History

🚀 部署工具 - 快速使用指南

快速启动

方式 1直接启动部署工具推荐

cd AdminTool
python deploy_tool.py

自动跳转到部署功能,忽略后端 API 错误

方式 2完整管理工具

cd AdminTool
python admin_gui.py

手动切换到「自动化部署」标签页


📦 完整部署流程

1 构建前端

cd D:\main\DesignerCEP\Designer
npm run build:core

等待构建完成,生成 dist_core/ 目录

2 启动部署工具

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 配置正确
  • 已点击「测试连接」验证

📞 技术支持


💡 提示

  1. 后端 API 错误不影响部署 - 部署功能完全独立
  2. 首次使用建议测试 - 先部署一个测试版本熟悉流程
  3. 保留历史版本 - 方便快速回滚
  4. 非高峰期部署 - 避免影响线上用户

开始使用:python deploy_tool.py 🚀