29 lines
1.4 KiB
Markdown
29 lines
1.4 KiB
Markdown
# Python Worker
|
||
|
||
`python_worker` 是 n8n、OGame Agent 与其他自动化流程共同使用的 FastAPI
|
||
服务。本次迁移只调整运行归属和宿主机目录，不重构业务接口。
|
||
|
||
## 目录边界
|
||
|
||
- `app/`：从 `/volume2/docker/n8n/python_worker` 分两阶段同步的应用、虚拟
|
||
环境和运行状态，不纳入 Git。
|
||
- `runtime.env`：从旧容器提取的宿主机运行参数，权限必须为 `0600`，不包含
|
||
模型或平台凭据，不纳入 Git。
|
||
- `.migration-state`：切换成功后写入的回滚定位信息，不纳入 Git。
|
||
- `README.md`：唯一纳入 Gitea 的目录说明。
|
||
|
||
容器继续使用 `python_worker` 名称、8000 端口和 `n8n_default` 网络，因此现有
|
||
n8n 工作流及 OGame Agent 仍通过 `http://python_worker:8000` 访问，不需要修改
|
||
调用地址。`/files` 仍是 n8n 与 Worker 共用的数据目录，本阶段不迁移。
|
||
|
||
## 迁移策略
|
||
|
||
迁移前先在旧 Worker 在线时把约 921 MB 的目录预复制到
|
||
`/volume2/docker/infra/python_worker/app`。正式切换时停止旧容器，再执行一次
|
||
增量同步，随后由 Infra Compose 启动新容器。旧目录和停止状态的旧容器都会
|
||
保留，以便回滚。
|
||
|
||
当前沿用本地镜像 `n8n-python_worker` 和已有 `.venv`，这是降低首次迁移风险的
|
||
过渡方案。后续必须单独补充固定版本的生产 Dockerfile，停止容器启动时联网安装
|
||
依赖，再将该服务纳入可复现构建。
|