Initial commit - DesignerCEP Project with Caddy deployment
This commit is contained in:
zuowei1216
330
AdminTool/README.md
Normal file
330
AdminTool/README.md
Normal file
@@ -0,0 +1,330 @@
|
||||
# DesignerCEP AdminTool 使用说明
|
||||
|
||||
## 📦 安装依赖
|
||||
|
||||
```bash
|
||||
cd AdminTool
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 一、自动化部署脚本 (auto_deploy_core.py)
|
||||
|
||||
### 功能说明
|
||||
|
||||
自动化完成以下所有步骤：
|
||||
1. ✅ 构建前端（Shell + Core）
|
||||
2. ✅ 打包 Shell.zip（供 CEP 扩展下载）
|
||||
3. ✅ 上传到服务器（SSH/SFTP）
|
||||
4. ✅ 更新 MySQL 数据库版本号
|
||||
5. ✅ 清除本地缓存（测试用）
|
||||
|
||||
### 使用方法
|
||||
|
||||
#### 1. 首次使用 - 配置服务器
|
||||
|
||||
```bash
|
||||
python auto_deploy_core.py --version 1.0.6 --setup
|
||||
```
|
||||
|
||||
会提示你输入：
|
||||
- 服务器地址
|
||||
- SSH 端口、用户名、密码
|
||||
- 远程路径
|
||||
- MySQL 地址、端口、用户名、密码、数据库名
|
||||
|
||||
配置会保存到 `deploy_config.json`，下次直接使用。
|
||||
|
||||
#### 2. 仅构建（不部署）
|
||||
|
||||
```bash
|
||||
python auto_deploy_core.py --version 1.0.6
|
||||
```
|
||||
|
||||
只在本地构建 Shell 和 Core，不上传到服务器。
|
||||
|
||||
#### 3. 构建并部署
|
||||
|
||||
```bash
|
||||
python auto_deploy_core.py --version 1.0.6 --deploy
|
||||
```
|
||||
|
||||
构建并自动上传到服务器：
|
||||
- Shell 在线登录页 → `/static/shell/`
|
||||
- Core 核心应用 → `/static/core/1.0.6/`
|
||||
- Shell.zip 下载包 → `/static/downloads/shell-1.0.6.zip`
|
||||
|
||||
#### 4. 构建、部署并更新数据库
|
||||
|
||||
```bash
|
||||
python auto_deploy_core.py --version 1.0.6 --deploy --update-db
|
||||
```
|
||||
|
||||
完整流程：构建 → 上传 → 更新 MySQL 数据库版本号。
|
||||
|
||||
**数据库更新 SQL：**
|
||||
```sql
|
||||
UPDATE plugin_groups SET current_version = '1.0.6' WHERE id = 1;
|
||||
```
|
||||
|
||||
#### 5. 其他选项
|
||||
|
||||
```bash
|
||||
# 跳过清除缓存
|
||||
python auto_deploy_core.py --version 1.0.6 --deploy --skip-clean
|
||||
|
||||
# 重新配置服务器
|
||||
python auto_deploy_core.py --version 1.0.6 --setup
|
||||
```
|
||||
|
||||
### 配置文件示例
|
||||
|
||||
`deploy_config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"host": "your-server.com",
|
||||
"port": "22",
|
||||
"username": "root",
|
||||
"password": "your-password",
|
||||
"remote_path": "/var/www/DesignerCEP/Server/static",
|
||||
"mysql": {
|
||||
"host": "localhost",
|
||||
"port": "3306",
|
||||
"username": "root",
|
||||
"password": "your-mysql-password",
|
||||
"database": "designer_cep",
|
||||
"table": "plugin_groups"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 二、图形化管理工具 (admin_gui.py)
|
||||
|
||||
### 功能说明
|
||||
|
||||
提供可视化界面管理：
|
||||
- 用户组管理
|
||||
- 用户权限管理
|
||||
- 版本上传和分配
|
||||
- **自动化部署**（新增）
|
||||
|
||||
### 使用方法
|
||||
|
||||
```bash
|
||||
python admin_gui.py
|
||||
```
|
||||
|
||||
### 主要功能
|
||||
|
||||
#### 1. 组与用户管理
|
||||
|
||||
- 创建用户组
|
||||
- 修改组备注
|
||||
- 查看组内用户
|
||||
- 移动用户到其他组
|
||||
- 修改用户权限
|
||||
|
||||
#### 2. 发布与上传
|
||||
|
||||
- 上传 ZIP 版本文件
|
||||
- 查看历史版本
|
||||
- 分配版本给用户组
|
||||
|
||||
#### 3. 自动化部署 ⭐ (新增)
|
||||
|
||||
完全图形化的部署流程：
|
||||
|
||||
**3.1 服务器配置**
|
||||
- 服务器地址、SSH 端口
|
||||
- 用户名、密码
|
||||
- 远程路径
|
||||
- 保存/加载配置
|
||||
- 测试 SSH 连接
|
||||
|
||||
**3.2 本地构建配置**
|
||||
- 项目根目录（自动检测）
|
||||
- 版本号
|
||||
|
||||
**3.3 部署选项**
|
||||
- ☑️ 部署 Shell（在线登录页）
|
||||
- ☑️ 部署 Core（核心应用）
|
||||
- ☑️ 打包 Shell 为 .zip
|
||||
- ☑️ 构建前端（npm run build）
|
||||
|
||||
**3.4 一键部署**
|
||||
- 点击 "🚀 开始部署" 按钮
|
||||
- 实时查看部署日志
|
||||
- 进度条显示当前进度
|
||||
- 部署完成后显示访问地址
|
||||
|
||||
---
|
||||
|
||||
## 📖 三、部署流程说明
|
||||
|
||||
### 完整部署流程
|
||||
|
||||
```
|
||||
1. 构建前端
|
||||
└─> npm run build (Designer/)
|
||||
└─> 生成 dist/Shell/ 和 dist/Designer/
|
||||
|
||||
2. 打包 Shell.zip
|
||||
└─> 压缩 dist/Shell/ → shell-{version}.zip
|
||||
|
||||
3. 连接服务器 (SSH)
|
||||
└─> 使用配置的服务器信息
|
||||
|
||||
4. 创建远程目录
|
||||
└─> /static/shell/
|
||||
└─> /static/core/{version}/
|
||||
└─> /static/downloads/
|
||||
|
||||
5. 上传文件
|
||||
└─> Shell → /static/shell/ (在线登录页)
|
||||
└─> Core → /static/core/{version}/ (核心应用)
|
||||
└─> shell-{version}.zip → /static/downloads/ (CEP 扩展下载)
|
||||
|
||||
6. 更新数据库 (MySQL)
|
||||
└─> UPDATE plugin_groups SET current_version = '{version}'
|
||||
|
||||
7. 完成！
|
||||
└─> 显示访问地址
|
||||
```
|
||||
|
||||
### 服务器目录结构
|
||||
|
||||
```
|
||||
/var/www/DesignerCEP/Server/static/
|
||||
├── shell/ # Shell 在线登录页
|
||||
│ ├── index.html
|
||||
│ └── assets/
|
||||
├── downloads/ # 下载文件
|
||||
│ └── shell-1.0.6.zip
|
||||
└── core/ # Core 核心应用
|
||||
├── 1.0.5/
|
||||
└── 1.0.6/
|
||||
├── index.html
|
||||
└── assets/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 四、常见问题
|
||||
|
||||
### Q1: SSH 连接失败
|
||||
|
||||
**A**: 检查以下几点：
|
||||
1. 服务器地址和端口是否正确
|
||||
2. 用户名密码是否正确
|
||||
3. 服务器防火墙是否开放 SSH 端口
|
||||
4. 本地网络是否正常
|
||||
|
||||
### Q2: MySQL 连接失败
|
||||
|
||||
**A**: 检查以下几点：
|
||||
1. MySQL 地址和端口是否正确
|
||||
2. 用户名密码是否正确
|
||||
3. 数据库是否存在
|
||||
4. MySQL 是否允许远程连接
|
||||
|
||||
### Q3: 构建失败
|
||||
|
||||
**A**:
|
||||
1. 检查是否安装了 Node.js 和 npm
|
||||
2. 检查项目目录是否正确
|
||||
3. 运行 `npm install` 安装依赖
|
||||
4. 查看错误日志
|
||||
|
||||
### Q4: 上传速度慢
|
||||
|
||||
**A**:
|
||||
1. 检查网络带宽
|
||||
2. 考虑使用国内服务器
|
||||
3. 可以先在本地构建，然后手动上传
|
||||
|
||||
### Q5: 如何回滚版本？
|
||||
|
||||
**A**:
|
||||
1. 在数据库中修改版本号为旧版本
|
||||
2. 或删除 `/static/core/{new_version}/` 目录
|
||||
|
||||
---
|
||||
|
||||
## 📝 五、配置文件说明
|
||||
|
||||
### deploy_config.json
|
||||
|
||||
| 字段 | 说明 | 示例 |
|
||||
|------|------|------|
|
||||
| `host` | 服务器地址 | `your-server.com` |
|
||||
| `port` | SSH 端口 | `22` |
|
||||
| `username` | SSH 用户名 | `root` |
|
||||
| `password` | SSH 密码 | `your-password` |
|
||||
| `remote_path` | 远程静态文件路径 | `/var/www/DesignerCEP/Server/static` |
|
||||
| `mysql.host` | MySQL 地址 | `localhost` |
|
||||
| `mysql.port` | MySQL 端口 | `3306` |
|
||||
| `mysql.username` | MySQL 用户名 | `root` |
|
||||
| `mysql.password` | MySQL 密码 | `your-mysql-password` |
|
||||
| `mysql.database` | 数据库名 | `designer_cep` |
|
||||
| `mysql.table` | 表名 | `plugin_groups` |
|
||||
|
||||
### deploy_config.txt (admin_gui.py 使用)
|
||||
|
||||
纯文本格式，一行一个配置：
|
||||
```
|
||||
host=your-server.com
|
||||
port=22
|
||||
user=root
|
||||
password=your-password
|
||||
remote_path=/var/www/DesignerCEP/Server/static
|
||||
project_root=D:\main\DesignerCEP
|
||||
version=1.0.6
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎉 六、快速开始
|
||||
|
||||
### 方法一：命令行部署（推荐）
|
||||
|
||||
```bash
|
||||
# 1. 首次配置
|
||||
python auto_deploy_core.py --version 1.0.6 --setup
|
||||
|
||||
# 2. 部署到服务器
|
||||
python auto_deploy_core.py --version 1.0.6 --deploy --update-db
|
||||
|
||||
# 完成！
|
||||
```
|
||||
|
||||
### 方法二：图形化部署
|
||||
|
||||
```bash
|
||||
# 1. 启动图形界面
|
||||
python admin_gui.py
|
||||
|
||||
# 2. 切换到"自动化部署"标签
|
||||
# 3. 配置服务器信息
|
||||
# 4. 点击"开始部署"按钮
|
||||
|
||||
# 完成！
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📞 技术支持
|
||||
|
||||
如遇到问题，请检查：
|
||||
1. 部署日志输出
|
||||
2. 服务器 SSH 日志
|
||||
3. MySQL 连接状态
|
||||
4. 网络连接情况
|
||||
|
||||
---
|
||||
|
||||
**最后更新**: 2024-12-17
|
||||
|
||||
Reference in New Issue
Block a user