Doclib 旧版服务器关闭与过期发现文件¶
背景¶
端点模式版本 2 将发现绑定到每个进程的 server_id。然而,升级后,已在运行的版本 1 服务器仍拥有同一个 MinerU 主目录,并暴露一个没有该标识符的端点。将该端点视为无效,可能使新的 CLI 针对同一个 SQLite 数据库和后台队列启动第二个服务器。
服务器关闭目前还会无条件删除端点和 UDS 路径。因此,在替换进程启动后退出的旧进程可能会删除由替换进程拥有的文件。
决策¶
端点版本 1 仅作为旧版身份格式被接受。其 PID 会与 GET /server/status 返回的 PID 进行比较;匹配的值用于识别旧版进程。端点版本 2 继续仅使用 server_id 作为身份。对于版本 2,PID 仍仅用于诊断。
服务器进程关闭和 mineru server stop 不再删除端点或 UDS 文件。Stop 会发送关闭请求,并等待直到已识别的服务器不再可达。Restart 仅在该等待成功后才启动替换进程。
过期发现文件会在启动前立即删除,前提是探测已确认没有由该端点识别的服务器正在运行。随后,新服务器会绑定其套接字,并原子地写入一个新的版本 2 端点。
错误处理¶
PID 与服务器状态不一致的版本 1 端点会被拒绝,并报告为 server_instance_mismatch。未在 15 秒等待期内完成的关闭会以 service_unavailable 失败,并且不会启动替换进程。
验证¶
测试覆盖版本 1 解析、PID 匹配与不匹配、版本 2 的 PID 独立性、保留的关闭文件、启动前的过期文件清理以及重启等待。真实进程升级模拟验证了停止和重启操作绝不会让两个服务器同时附加到同一个 MinerU 主目录。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 mi/MinerU