針對本機執行作業進行偵錯遠端快取命中

本頁說明如何在本機執行情境中調查快取遺漏情形。

本頁面假設您有在本機成功建構的建構作業和/或測試，且已設定為使用遠端快取，且您想確保遠端快取能有效使用。

參閱提示，瞭解如何檢查快取命中率，以及如何比較執行作業 針對 Remote Execution 的遠端快取命中進行偵錯。 該指南介紹的所有事項也適用於透過本機進行遠端快取的情形 不過，本機執行會帶來一些額外的挑戰。

檢查快取命中率

成功的遠端快取命中會顯示在狀態行中，類似於搭配遠端執行作業的快取命中率。

在 Bazel 執行的標準輸出內容中，您會看到 包括：

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

這表示在 7 項嘗試動作中，3 項嘗試獲得了遠端快取命中和 4 項遠端快取 動作沒有快取命中，且使用 linux-sandbox 在本機執行 策略。這份摘要中不包含本機快取命中次數。如果您收到 0 個程序 (或比預期低的數字)，請執行 bazel clean，接著執行建構/測試指令。

排解快取命中問題

如果未達到預期的快取命中率，請採取下列做法：

確保與遠端端點成功通訊

如要確保建構作業能順利與遠端快取服務通訊，請按照本節中的步驟操作。

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 叫用