!link! | Debug-action-cache
Technically, debug-action-cache is not a standalone binary. It is a inside the actions/cache and actions/toolkit packages. When you enable it, the cache library outputs verbose logs showing:
The most effective way to debug action caches is by comparing execution logs between two builds 2.2.3 .
If your build is not achieving the expected cache hit rate, it is usually due to one of these reasons: debug-action-cache
To debug effectively, you need to instrument your pipeline. Here is the step-by-step methodology for debug-action-cache .
If you suspect cache issues, use the following systematic approach to isolate and fix the root cause. Step 1: Enable Verbose Logging Technically, debug-action-cache is not a standalone binary
Then download a specific cache by ID. This is advanced debug-action-cache territory – useful for auditing large caches or recovering manual backups.
The "paper" or primary documentation for this feature describes a method for investigating why two seemingly identical build actions produce different cache hashes. In Bazel, this is often handled via the --experimental_remote_cache_eviction_retries or specifically by generating to compare inputs. Key Functions If your build is not achieving the expected
When you run a debug-action-cache routine, your main goal is to find out why a pipeline is downloading files from scratch instead of pulling them instantly from the cache storage. 🔍 Common Root Causes of Cache Failures