后台增加自动部署更新功能

This commit is contained in:
2026-08-10 21:41:36 +08:00
parent 2022664e7e
commit df35018805
9 changed files with 513 additions and 5 deletions
+61
View File
@@ -418,6 +418,67 @@ curl -I http://127.0.0.1/ --header "Host: www.tgoim.com"
### 10.1 更新代码
#### 方式一:后台一键部署(推荐)
网站后台已集成"在线部署"功能,可在浏览器中一键从 Git 拉取最新代码并自动完成更新,无需登录服务器。
**使用步骤:**
1. 登录后台管理 `https://www.tgoim.com/admin/`
2. 在左侧菜单进入「部署日志」(核心 → 部署日志)
3. 点击右上角「一键部署更新」按钮
4. 在确认对话框中点击「确定」
5. 页面会跳转到日志详情页,每 3 秒自动刷新显示部署进度
6. 部署完成后会自动重启服务
**部署流程会依次执行:**
1. `git pull origin main` 拉取最新代码
2. `pip install -r requirements.txt` 安装/更新依赖
3. `python manage.py migrate` 执行数据库迁移
4. `python manage.py collectstatic --noinput` 收集静态文件
5. `sudo supervisorctl restart tgoim` 重启服务
**前置条件(一次性配置):**
为了让运行 Django 的 `www-data` 用户能够执行 `git pull` 和重启服务,需要配置 sudoers 允许其无密码执行特定命令。在服务器上执行:
```bash
# 创建 sudoers 配置,允许 www-data 无密码执行 supervisorctl
sudo cat > /etc/sudoers.d/tgoim-deploy << 'EOF'
# 允许 www-data 无密码重启 tgoim 服务(用于在线部署)
www-data ALL=(root) NOPASSWD: /usr/bin/supervisorctl restart tgoim
www-data ALL=(root) NOPASSWD: /usr/bin/supervisorctl status tgoim
EOF
# 设置正确的权限
sudo chmod 440 /etc/sudoers.d/tgoim-deploy
# 验证配置语法(重要!避免 sudo 配置错误导致系统问题)
sudo visudo -c
```
**Git 仓库权限配置:**
确保 `www-data` 用户对项目目录有足够的权限执行 git pull:
```bash
# 设置项目目录所有者为 www-data
sudo chown -R www-data:www-data /opt/company_website
# 确保数据库和媒体目录可写
sudo chown www-data:www-data /opt/company_website/db.sqlite3
sudo chown -R www-data:www-data /opt/company_website/media
sudo chown -R www-data:www-data /opt/company_website/staticfiles
```
**注意事项:**
- 部署过程中请勿同时登录服务器手动执行 `git pull`,以免冲突
- 系统会自动防止并发部署(已有任务运行时按钮会禁用)
- 如果自动重启失败,日志会提示手动执行命令,按提示操作即可
- 所有部署操作会记录在「部署日志」中,可随时查看历史
#### 方式二:手动命令行部署
```bash
cd /opt/company_website