托管 Parse Server 停止预算设计¶
问题¶
mineru server stop 最多等待 15 秒,让 doclib 停止并释放其 HOME 所有权锁。当前托管 parse-server 的关闭流程会独立地将 parse_server_stop_timeout_sec 应用于控制关闭、终止和 kill 阶段。在默认值为 10 秒时,关闭过程在 doclib 继续剩余清理之前可能消耗长达 30 秒。
在模型预加载期间,即使控制监视器已设置 server.should_exit,parse-server 进程仍可能停留在模型初始化内部。在观察到的 E2E 失败中,它忽略关闭请求达 10 秒,忽略终止请求又达 10 秒。CLI 在 15 秒后返回,而 doclib 仍然持有所有权锁。
决策¶
将 parse_server_stop_timeout_sec 视为托管 parse-server 停止的总预算。
对于默认的 10 秒预算:
- 健康或已建立连接(established)的进程:在控制关闭请求后最多等待 5 秒。
- 启动或预加载中的进程:在控制关闭请求后最多等待 2 秒。
- 在终止后最多等待 3 秒。
- 使用 kill 之后的剩余预算来回收(reap)进程。
每个阶段都从一个单调递减的截止时间中派生自己的超时。较早阶段使用的时间不会加回总预算。
现有 15 秒的 CLI 停止超时保持不变。这为剩余的 background tasks、数据库关闭、端点清理和所有权锁释放留下大约 5 秒。
范围¶
关闭策略仍集中在 stop_managed_parse_server 中。
调用方从现有的 ParseServerHealth.local_starting 状态传入托管进程是否仍在启动。不会为单个 background tasks 添加新的配置键或超时逻辑。
托管 parse-server 使用专用的 multiprocessing.connection 控制通道,而不是 stdin。Unix 使用 AF_UNIX;Windows 使用 AF_PIPE。让模型初始化具备协作式可取消能力需要更广泛的模型运行时变更,并且不是限制 doclib 关闭时间所必需的。
失败处理¶
- 发送控制关闭命令是第一个关闭动作。
- 如果控制通道不可用,跳过优雅等待并直接发送 terminate。
- 如果优雅关闭阶段超过其分配的时间,发送 terminate。
- 如果 terminate 超过其分配的时间,发送 kill。
- 如果 kill 或回收失败,记录失败并让 doclib 继续关闭,而不是延长配置的预算。
- 进程在任意阶段退出时都会立即返回。
测试¶
- 验证 EOF、terminate 和 kill 使用同一个总截止时间中的各个部分,而不是各自独立获得完整的超时。
- 验证启动/预加载状态获得更短的优雅关闭间隔。
- 验证忽略 EOF 和 terminate 的进程会在配置的总预算内被 kill 并回收。
- 验证 restart 和 doclib 关闭会将现有启动状态传递给集中式辅助函数。
- 重新运行 CLI 服务器生命周期单元测试,以及从
JSONERR-004到JSONERR-005的聚焦 E2E 序列。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 mi/MinerU