iii-engine-config

用途：配置 iii 引擎的两种模式之一，二者不可混用。托管 Compose 引擎：worker-compose.yaml 中出现 engine: 即由 Compose 拥有引擎进程，engine.workers 为直接映射，无嵌套 config: 字段；engine.url 默认 ws://127.0.0.1:49134。启动命令：iii compose --namespace orders-daemon --up --file worker-compose.yaml。允许的引擎 worker 基础名仅 configuration、iii-worker-manager、iii-http-functions、iii-stream、iii-sandbox，可用 #instance 声明额外实例；iii-engine-functions、iii-telemetry、iii-observability 自动注入，不得声明。HTTP、cron、queue、state、pubsub、bridge、application 及自定义 worker 放在 containers: 下，可用 iii trigger -n orders-daemon compose::add worker=state 添加。直接监管引擎：仅当 systemd、Kubernetes 等监管进程时保留列表形 config.yaml，用 iii --config config.yaml 启动，再单独启动外部 Compose 守护进程，外部文件须省略 engine:，可用 III_URL 替代 --engine。RBAC：将引擎端口保持内部，用 rbac-proxy 面向不可信 worker、浏览器或代理；它开启独立 WebSocket 端口，逐连接认证（rbac.auth_function_id），按 rbac.expose_functions 及认证结果的 allowed_functions/forbidden_functions 控制调用与触发绑定，并过滤 engine::* 发现结果。安全与运维：引擎端口绑定 127.0.0.1，仅暴露 rbac-proxy 端口；公共代理必须设置 auth_function_id 并收窄 expose_functions；密钥用环境变量配置；迁移时保留 configuration、stream、state、queue 存储路径；用 compose::status 查看进程归属，engine::workers::list 查看连接；compose::add 不会修改 engine: 或重启引擎。限制：项目 worker 生命周期归 Compose，不属于 config.yaml 或 iii worker；函数与触发代码见 iii-core-primitives；worker 专属行为见对应文档。