客户端/服务器实现

报告问题 查看源代码

Bazel 系统实现为长期有效的服务器进程。这样,它就可以执行许多批量实现所无法实现的优化,例如将 BUILD 文件、依赖关系图和其他元数据从一个 build 缓存到下一个 build。这样可以提高增量构建的速度,并允许不同的命令(如 buildquery)共享已加载软件包的同一缓存,从而加快查询速度。

当您运行 bazel 时,您就是在运行客户端。客户端根据输出库查找服务器,输出库默认情况下由基本工作区目录和您的 userid 的路径确定,因此,如果您在多个工作区中进行构建,您将拥有多个输出库,从而拥有多个 Bazel 服务器进程。同一工作站上的多个用户可以在同一工作区中同时构建,因为他们的输出基数不同(用户 ID 不同)。

如果客户端找不到正在运行的服务器实例,则会启动一个新的服务器实例。为此,它会检查输出库是否已存在,这意味着 blaze 归档已解压缩。否则,如果输出基准不存在,客户端会解压缩归档文件的文件,并将其 mtime 设置为未来 9 年的日期。安装后,客户端会确认解压缩文件的 mtime 是否等于最新日期,以确保未发生安装篡改。

服务器进程将在处于不活动状态一段时间(默认为 3 小时,这可通过启动选项 --max_idle_secs 进行修改)后停止。在大多数情况下,用户看不到服务器正在运行这一事实,但有时记住这一点会有所帮助。例如,如果您运行的脚本在不同目录中执行大量自动构建,请务必确保不会累积大量空闲服务器;为此,您可以在执行完这些服务器后明确将其关闭,或指定较短的超时期限。

Bazel 服务器进程的名称在 ps xps -e f 的输出中显示为 bazel(dirname),其中 dirname 是包含工作区目录根目录的目录的基名。dirname例如:

ps -e f
16143 ?        Sl     3:00 bazel(src-johndoe2) -server -Djava.library.path=...

这样可以更轻松地找出哪个服务器进程属于给定工作区。(请注意,借助 ps 的某些其他选项,Bazel 服务器进程可能仅命名为 java。)您可以使用 close 命令停止 Bazel 服务器。

运行 bazel 时,客户端首先检查服务器版本是否合适;如果不是,则会停止服务器,然后启动新的服务器。这样可以确保使用长时间运行的服务器进程不会干扰正确的版本控制。