调试远程缓存命中以在本地执行

本页介绍了如何在本地环境中 执行。

本页面假定您的 build 和/或测试可以成功构建 并且设置为利用远程缓存 远程缓存是否得到了有效利用。

有关如何查看缓存命中率以及如何与执行 运行日志，请参阅 调试远程执行的远程缓存命中。 该指南中介绍的所有内容也适用于使用本地 执行。但是，本地执行也带来了一些额外的挑战。

检查您的缓存命中率

成功的远程缓存命中将显示在状态行中，类似于 远程缓存命中率 执行。

在 Bazel 运行的标准输出中，你会看到类似如下内容： 以下：

   INFO: 7 processes: 3 remote cache hit, 4 linux-sandbox.

这意味着，在 7 次尝试的操作中，有 3 次收到了远程缓存命中，有 4 次 操作无缓存命中，是使用 linux-sandbox 在本地执行 策略此摘要中不包含本地缓存命中。如果您获得的 0 个进程（或小于预期的数字），运行 bazel clean，后跟 构建/测试命令

缓存命中问题排查

如果您没有获得预期的缓存命中率，请执行以下操作：

确保与远程端点成功通信

为了确保您的 build 成功与远程缓存通信，请遵循 执行本部分中的步骤

1. 检查输出中是否有警告

   使用远程执行时，无法与远程端点通信 。另一方面，如果存在可缓存的本地构建， 不能缓存。检查 Bazel 调用的输出有无警告，例如 以：

      WARNING: Error reading from the remote cache:
   

   或

      WARNING: Error writing to the remote cache:
   

   出现此类警告后，系统会提供详细说明相关连接的错误消息 应该可以帮助您调试的问题：例如，输入错误的端点名称或 凭据设置不正确。查找并解决任何此类错误。如果错误 消息没有提供足够的信息，请尝试将 --verbose_failures。

2. 请按照对远程应用的缓存命中进行问题排查 执行到 确保您的缓存写入 Bazel 调用能够获取缓存命中 同一台机器和多台机器的工作负载。

3. 确保缓存读取 Bazel 调用可以获取缓存命中。

   a. 由于缓存读取 Bazel 调用的命令行集 请格外小心，确保已正确设置 与远程缓存进行通信确保已设置 --remote_cache 标志 输出中没有任何警告

   b. 确保读取缓存读取的 Bazel 调用构建的目标与 运行缓存写入的 Bazel 调用

   c. 按照与确保跨域缓存 机器， 以确保从缓存写入 Bazel 调用缓存到 执行缓存读取操作 Bazel 调用