gh-actions-archive-cache

Preload action archives for GitHub-hosted custom images and self-hosted runners.

View repository

For GitHub-hosted larger runners, prepare a Custom Runner Image with frequently used action archives already preloaded. For self-hosted setups, include the cache in a container or VM disk image, or keep it on persistent runner storage so each runner can reuse the archives across its jobs. This also fits runner platforms such as Actions Runner Controller, which can use a custom runner container image.

gh-actions-archive-cache is a cross-platform GitHub CLI extension that downloads selected action versions or imports pinned repositories from an Actions lockfile. It resolves references to commits, supports the runner's ZIP and tar.gz formats, and checks existing archives before reusing them.

Use it with your runner platform

Make the cache available to the runner and configure its cache path before the runner starts. Refresh prepared images and persistent caches as action versions change. Archives are keyed by commit, and the runner fetches an archive when a workflow references a commit that isn't preloaded.

Prepare, configure and maintain

Populate a cache from selected action versions or a lockfile, configure a runner to use it, and preview cleanup of older archives before deleting anything. Set up the cache during image preparation or provision it on persistent runner storage before jobs start, so action archives are ready when each job begins.

Getting started

Follow the installation guidance and runner-image examples. Keep credentials out of runner images and make sure the runner account can read the cache.

GitHub - jessehouwing/gh-actions-archive-cache: Cross-platform GitHub CLI extension for prepopulating and maintaining runner action archive caches
Cross-platform GitHub CLI extension for prepopulating and maintaining runner action archive caches - jessehouwing/gh-actions-archive-cache