本页介绍了如何在本地环境中 执行。
本页面假定您的 build 和/或测试可以成功构建 并且设置为利用远程缓存 远程缓存是否得到了有效利用。
有关如何查看缓存命中率以及如何与执行 运行日志,请参阅 调试远程执行的远程缓存命中。 该指南中介绍的所有内容也适用于使用本地 执行。但是,本地执行也带来了一些额外的挑战。
检查您的缓存命中率
成功的远程缓存命中将显示在状态行中,类似于 远程缓存命中率 执行。
在 Bazel 运行的标准输出中,你会看到类似如下内容: 以下:
INFO: 7 processes: 3 remote cache hit, 4 linux-sandbox.
这意味着,在 7 次尝试的操作中,有 3 次收到了远程缓存命中,有 4 次
操作无缓存命中,是使用 linux-sandbox
在本地执行
策略此摘要中不包含本地缓存命中。如果您获得的
0 个进程(或小于预期的数字),运行 bazel clean
,后跟
构建/测试命令
缓存命中问题排查
如果您没有获得预期的缓存命中率,请执行以下操作:
确保与远程端点成功通信
为了确保您的 build 成功与远程缓存通信,请遵循 执行本部分中的步骤
检查输出中是否有警告
使用远程执行时,无法与远程端点通信 。另一方面,如果存在可缓存的本地构建, 不能缓存。检查 Bazel 调用的输出有无警告,例如 以:
WARNING: Error reading from the remote cache:
或
WARNING: Error writing to the remote cache:
出现此类警告后,系统会提供详细说明相关连接的错误消息 应该可以帮助您调试的问题:例如,输入错误的端点名称或 凭据设置不正确。查找并解决任何此类错误。如果错误 消息没有提供足够的信息,请尝试将
--verbose_failures
。请按照对远程应用的缓存命中进行问题排查 执行到 确保您的缓存写入 Bazel 调用能够获取缓存命中 同一台机器和多台机器的工作负载。
确保缓存读取 Bazel 调用可以获取缓存命中。
a. 由于缓存读取 Bazel 调用的命令行集 请格外小心,确保已正确设置 与远程缓存进行通信确保已设置
--remote_cache
标志 输出中没有任何警告b. 确保读取缓存读取的 Bazel 调用构建的目标与 运行缓存写入的 Bazel 调用
c. 按照与确保跨域缓存 机器, 以确保从缓存写入 Bazel 调用缓存到 执行缓存读取操作 Bazel 调用