Expand description
Store inspection and garbage collection.
The store holds six trees: cas/v1 for content-addressed objects,
action-results/v1 for the results that reference them, task-manifests/v1
for the prediction index, checkouts/v1 for the checkouts that have built
each identity, build-receipts/v1 for exact completed build closures, and
sessions/v1 for per-build event streams. Only the first two are collected
for size; manifests and receipts are small, checkout records expire with
their checkout claims, and session streams are bounded by age and count
because they are history rather than cache content.
Structs§
Functions§
- checkout_
is_ live - Whether the checkout a record names is still on disk.
- claim_
sweep - Atomically stamp a due sweep before its callers perform coordinated GC.
- export_
checkout - Export the complete local cache closure of this checkout’s most recent build.
- export_
group - Export the union of every completed build recorded under one CI group.
- gc
- Evict objects until the store fits within
max_bytes. - gc_
dry_ run - Describe the collection
gcwould perform without changing the store. - import_
archive - Validate a cache export in isolation, then publish its objects and actions.
- largest
- Return the largest blobs and action-result records in descending order.
- projects
- Attribute cache and target bytes to each recorded workspace.
- record_
build_ receipt - Record an exact completed build for checkout and grouped exports.
- record_
checkout - Record that
workspace_rootbuiltidentity. - remove_
project - Remove checkout claims belonging to exactly one workspace.
- stats
- Summarize what the store currently holds.
- sweep_
if_ due - Sweep the store if
intervalhas passed since the last attempt. - verify
- Verify every addressable CAS object and action-result record.