feat: standardize DeerFlow offline deployment
This commit is contained in:
1 parent
1764d0d5f2
commit
d9a94245fc
37 files changed
+3761
-2
No files matched your search
@@ -0,0 +1,66 @@
|
||||
# 直接覆盖源码并重启(最简单方式)
|
||||
|
||||
当前部署已经把前后台代码作为宿主机目录挂载到容器。日常修改源码时不需要重新打镜像,也不需要重新加载离线镜像。
|
||||
|
||||
## 需要替换的目录
|
||||
|
||||
在 DeerFlow 部署目录中只替换以下内容:
|
||||
|
||||
```text
|
||||
source/
|
||||
├── backend/
|
||||
│ ├── app/ # 替换为 offline-backend-20260512/backend/app
|
||||
│ ├── packages/ # 替换为 offline-backend-20260512/backend/packages
|
||||
│ └── tests/ # 替换为 offline-backend-20260512/backend/tests
|
||||
├── frontend/
|
||||
│ └── dist/ # 替换为 frontend-web 执行 pnpm build 后的 dist
|
||||
└── wheelhouse/ # 离线 Python wheel 与 requirements.txt;日常源码替换不要删除
|
||||
```
|
||||
|
||||
注意:后端目录名是 `tests`,不是 `test`。
|
||||
|
||||
## 前端怎么生成 dist
|
||||
|
||||
在开发或构建机器执行:
|
||||
|
||||
```bash
|
||||
cd frontend-web
|
||||
pnpm install
|
||||
pnpm build
|
||||
```
|
||||
|
||||
只把生成的 `frontend-web/dist/` 内容上传到部署目录的 `source/frontend/dist/`。服务器不需要 Node.js,也不会在启动时安装 npm 依赖。
|
||||
|
||||
## 替换完成后重启
|
||||
|
||||
进入服务器当前 DeerFlow 部署目录:
|
||||
|
||||
```bash
|
||||
sudo ./OFFLINE_INSTALL.sh --restart
|
||||
```
|
||||
|
||||
该脚本只执行以下操作:
|
||||
|
||||
1. 检查四个代码目录和前端 `index.html`;
|
||||
2. 从 `deploy.env` 重新生成数据库、模型和前端运行配置;
|
||||
3. 检查 `source/wheelhouse`,仅在内容变化时离线安装依赖;
|
||||
4. 使用一次性容器检查后端 Python 导入;
|
||||
5. 依次重建并重启后端、前端容器;
|
||||
6. 等待两个服务健康。
|
||||
|
||||
它不会执行数据库预检,不会 `docker load`,不会构建、拉取或删除镜像,也不会修改 `config/deploy.env`、数据库业务数据、技能、智能体或知识文件。容器会重建以应用新增的挂载和环境变量,但数据库卷、用户数据卷、浏览器上下文卷和 Python 依赖卷均保留。
|
||||
|
||||
## 哪些修改不能这样更新
|
||||
|
||||
如果修改了以下内容,不能只覆盖源码:
|
||||
|
||||
- 后端 `pyproject.toml`、`uv.lock`、`requirements-offline.txt` 中涉及无法通过纯 Python wheel 提供的依赖;
|
||||
- 系统软件、Python/Office/浏览器依赖;
|
||||
- Nginx 镜像运行环境;
|
||||
- Dockerfile 或容器启动命令。
|
||||
|
||||
这些修改涉及系统运行环境,需要重新制作基础镜像包。新增普通纯 Python/C-extension wheel 时,可按 `docs/13-wheelhouse离线新增依赖与多模型.md` 操作,无需重做镜像;单纯修改后端 `app/packages/tests` 和前端页面代码可以直接覆盖。
|
||||
|
||||
## 建议的安全替换方式
|
||||
|
||||
上传时先放到临时目录,确认完整后再改名覆盖,避免服务运行期间读到上传一半的文件。替换之前可复制一份旧目录作为备份;若新代码有问题,恢复旧目录后再次运行 `OFFLINE_INSTALL.sh --restart`。
|
||||
Reference in new issue
Block a user