modify: 进程插进目录结构更新

This commit is contained in:
2026-08-26 09:37:31 +08:00
parent 741d7cda09
commit 2270f2f6e8
4 changed files with 28 additions and 25 deletions
+7 -7
View File
@@ -383,8 +383,8 @@ load_mode = "external" # 独立进程运行,经 Zenoh 注册路由
```bash
cd workers/demo
uv run worker_serve --type demo # 本地调试(首次先 uv sync 装依赖)
./start.sh # 与容器一致的启动方式(uv sync + 启动)
uv run chongming-worker --type demo # 本地调试(首次先 uv sync 装依赖)
./start.sh # 与容器一致的启动方式(uv sync + 启动)
```
- 生产部署:进程插件与网关**分别打包到不同容器**
@@ -410,7 +410,7 @@ config/workers/<name>/ 插件注册 + 端点配置
config/zenoh_config.json5 Zenoh 会话配置
config.toml 最小根配置(仅 [zenoh] 节,worker 启动必需)
pyproject.toml uv 依赖清单(chongming-worker 内网 git 源)
start.sh 容器入口:uv sync + worker_serve --type <name>
start.sh 容器入口:uv sync + chongming-worker --type <name>
```
- 打包自动排除 `__pycache__` / `*.pyc` / `.venv` 等,`start.sh` 权限强制 0o755
@@ -554,8 +554,8 @@ uv run serve # 启动开发服务
uv run gen_plugin <name> # 生成统一风格插件骨架
uv run gen_models # 生成 Pydantic 模型
uv run build # 构建打包(PyInstaller/Nuitka)
uv run worker_serve --type <name> # 独立 Worker 进程(本地调试,load_mode=external)
chongming-worker --type <name> # 独立 Worker 进程(容器入口)
uv run chongming-worker --type <name> # 独立 Worker 进程(项目根下本地调试,load_mode=external)
chongming-worker --type <name> # 独立 Worker 进程(容器入口)
uv pip install -e utils/<name> # 安装/更新工具包
```
@@ -594,7 +594,7 @@ uv pip install -e utils/<name> # 安装/更新工具包
- **插件加载模式**:按插件粒度声明在 `config/workers/<name>/config.toml` 的 `[workers]` 节
- `load_mode = "inline"`(默认):插件在网关进程内加载
- `load_mode = "external"`:插件以独立进程运行(进程编排交给 Docker/K8s,
进程入口 `uv run worker_serve --type <name>`),经 Zenoh 在 `chongming/routes/**`
进程入口 `uv run chongming-worker --type <name>`),经 Zenoh 在 `chongming/routes/**`
注册路由,网关动态挂载 HTTP 端点(RouteRegistry 常驻订阅,无需在网关侧保留插件配置)
- 两种模式可同时存在(混合部署)
- **进程插件与网关完全隔离**:进程插件只依赖 `chongming-worker` SDK + zenoh,
@@ -603,7 +603,7 @@ uv pip install -e utils/<name> # 安装/更新工具包
**生产部署时进程插件与网关分别打包到不同容器**:
- 网关容器:`chongming`(含 `src/chongming/`)+ 依赖
- 进程插件容器:插件代码(`workers/<name>/`)+ `chongming-worker` + 依赖,
入口 `chongming-worker --type <name>`(或 `uv run worker_serve --type <name>`),
入口 `chongming-worker --type <name>`),
打包: `uv run build_plugin <name>` → `dist/<name>.zip`(见「进程插件打包」)
- **Zenoh 配置**:`config/zenoh_config.json5`
- **插件注册**:`config/workers/<name>/config.toml` 的 `[workers]` 节,定义加载方式、副本数与运行时配置(旧全局 `config/workers/config.toml` 仅作兜底兼容)