actions/cache-apt-pkgs-action
1
0
Fork 0
mirror of https://github.com/awalsh128/cache-apt-pkgs-action.git synced 2026-11-13 13:26:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

Explain cache scoping across branches in README (#227)

Browse source 
The cache key doesn't include the branch, but GitHub only lets a run
restore caches from its own branch or its base branch. Document this and
how to share one cache across branches by populating it on the default
branch.

Refs #186

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Andrew Walsh 2026-11-05 16:05:10 -08:00 committed by GitHub
parent 0e7f5cdc6b
commit 75f34b28cb
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 5 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
README.md
View file

@ -50,7 +50,11 @@ Please note that the `latest` symbol has been deprecated and will no longer be u
### Cache scopes
The cache is scoped to the packages given and the branch. The default branch cache is available to other branches.
The cache key is built from the `packages`, `version` and `add-repository` inputs, plus the runner's CPU architecture. The branch name is not part of the key.
GitHub still limits which caches a workflow run can restore (see [Restrictions for accessing a cache](https://docs.github.com/en/actions/using-workflows/caching-dependencies-to-speed-up-workflows#restrictions-for-accessing-a-cache)). A run can restore caches created on its own branch, or on the base branch (e.g. the default branch, or the base branch of a pull request). It can't restore caches created on sibling branches, even when the key is the same.
If you see a separate cache for every branch or pull request, it is likely because the default branch has never saved one. Run the workflow on the default branch (e.g. on `push` to `master`) so the cache is created there. After that, every branch and pull request with the same inputs will restore it instead of installing the packages again.
### Example workflow