Limita de mărime a cache-ului în GitHub Actions: de ce cache-ul tău e eliminat, se restaurează lent sau ratează
GitHub Actions îi dă fiecărui repository 10 GB de cache. După ce repository-ul trece de această limită, GitHub tot salvează intrarea nouă și șterge intrările citite cel mai demult până ajunge din nou sub limită, iar orice intrare pe care niciun job nu a citit-o de 7 zile e ștearsă. Un branch își citește doar propriile cache-uri și pe cele ale branchului implicit, așa că prima rulare a unui branch nou ratează des. Iar o potrivire tot e o descărcare: fiecare job de pe un runner găzduit de GitHub pornește pe un VM nou, așa că descarcă și dezarhivează din nou arhiva. Poți ridica limita, cu $0,07 pe GB pe lună peste 10 GB, și îți poți regla cheile, dar descărcarea rămâne.
Skipbox elimină descărcarea. Joburile tale rulează pe mașina dedicată a contului tău, păstrată între joburi, așa că cache-urile npm, pnpm, Gradle, Go și Cargo și layerele Docker sunt încă pe discul ei de la jobul anterior (80 GB pe S, față de 14 GB pe runnerul GitHub). Ce salvează actions/cache rămâne lângă mașină, așa că o restaurare e o citire locală. Schimbi o singură linie, runs-on: skipbox, la un preț fix de $39 pe lună, cu minute nelimitate.
Regulile GitHub pentru cache
Din referința GitHub despre dependency caching, din facturarea Actions și din changelogul despre cache-urile de peste 10 GB:
| Regula | Ce face GitHub |
|---|---|
| Mărimea | Implicit 10 GB per repository, împărțiți de toate branchurile și workflow-urile |
| Peste mărime | Salvează intrarea nouă, apoi șterge intrări după ultimul acces, cele mai vechi primele, până când repository-ul e sub limită. Eliminarea rulează în fiecare oră |
| Intrările nefolosite | Șterge orice intrare necitită de peste 7 zile |
| O limită mai mare | Pe un cont Pro, Team sau Enterprise, administratorii pot ridica mărimea și zilele. Peste 10 GB, $0,07 pe GB pe lună, după vârful fiecărei ore. Un buget atins face cache-ul doar pentru citire până la următorul ciclu de facturare |
| Branchurile | O rulare restaurează cache-uri din branchul ei și din branchul implicit; rularea unui pull request și din branchul lui de bază. Niciodată dintr-un branch vecin sau copil |
| Pull request-urile | Cache-urile unui pull request sunt legate de merge ref-ul lui: doar rulările repetate ale acelui pull request le citesc |
| Intrările | Nu pot fi modificate. O cheie care există deja nu e salvată din nou |
| Potrivirile | cache-hit e true doar pentru o potrivire exactă a key; o potrivire prin restore-keys e false |
| Ritmul | Până la 200 de încărcări și 1.500 de descărcări pe minut per repository |
De ce e eliminat cache-ul
Aceiași 10 GB țin tot ce salvează repository-ul. Fiecare branch și fiecare pull request își salvează propriile intrări. O matrice cu trei versiuni de Node pe două sisteme de operare salvează șase. Cache-ul de build Docker type=gha ajunge în aceiași 10 GB. Când salvările unei zile depășesc limita, fiecare salvare nouă șterge o intrare mai veche, de multe ori chiar pe cea de care are nevoie jobul următor. GitHub numește asta cache thrashing.
Ca să vezi ce îl umple, listează intrările după mărime:
gh cache list --sort size_in_bytes --limit 20
Pagina Actions › Caches a repository-ului arată același lucru, cu branchul și ultima folosire a fiecărei intrări.
De ce e lentă restaurarea
O potrivire de cache pe un runner găzduit de GitHub e o descărcare pe un VM nou, urmată de o dezarhivare. Durata ei crește odată cu arhiva, așa că un cache care a crescut la câțiva GB poate dura cât instalarea pe care trebuia s-o evite. O descărcare blocată e întreruptă de timeoutul de segment al actions/cache, implicit 10 minute (SEGMENT_DOWNLOAD_TIMEOUT_MINS).
Cele mai multe configurări restaurează și mai puțin decât crede lumea. Inputul cache: din setup-node salvează cache-ul de descărcări al managerului de pachete, nu node_modules: după restaurare, npm ci tot instalează fiecare pachet. Cache-ul pip din setup-python e la fel: descărcările revin, mediul se instalează din nou.
De ce ratează cache-ul
- Cheia s-a schimbat. O cheie cu
hashFiles('**/package-lock.json')ratează la fiecare schimbare a lockfile-ului.restore-keysdă o potrivire parțială, iarcache-hitarată atuncifalse. - Un branch nou. Poate citi cache-urile branchului implicit, nu pe ale altui branch de funcționalitate. Dacă branchul implicit nu a rulat niciodată workflow-ul, nu are ce citi.
- A fost eliminat. L-a luat limita sau cele 7 zile.
- Nu s-a salvat niciodată. Intrările nu pot fi modificate, așa că o cheie care există nu mai e salvată niciodată, iar conținutul din cache rămâne la fel de vechi ca prima salvare. Un pull request dintr-un fork poate să nu aibă voie să salveze deloc.
Transmiterea fișierelor către jobul următor din aceeași rulare e o altă unealtă. Cache-ul e pentru rularea următoare; rezultatul buildului de care are nevoie un job ulterior din același workflow trece prin actions/upload-artifact și actions/download-artifact. Artefactele au propria stocare, separată de cei 10 GB, și sunt tot o descărcare pe un VM nou.
Cât costă fiecare soluție pe runnerele GitHub
- Ridică limita. Mai puține eliminări, cu $0,07 pe GB pe lună peste 10 GB (exemplul GitHub: 200 GB folosiți integral costă $13,30 pe lună), pe un cont Pro, Team sau Enterprise. Restaurările rămân descărcări, iar cache-urile mai mari se descarcă mai greu.
- Salvează mai puțin. Pune în cache
~/.npmsau store-ul pnpm, nunode_modulessau rezultatul buildului. Salvează doar pe branchul implicit, cuactions/cache/restoreîn fiecare job șiactions/cache/saveîntr-unul singur. Te costă timp, iar un cache mai mic restaurează mai puțin. - Repară cheile. Leagă cheia de lockfile, adaugă
restore-keysși rulează workflow-ul la push-urile pe branchul implicit, ca branchurile noi să aibă ce citi. - Un runner self-hosted care își păstrează discul. Nicio descărcare, nicio limită de 10 GB. Tu rulezi mașina: actualizările sistemului de operare, curățenia între joburi fără să ștergi cache-urile și repararea ei când se strică.
Când soluția e o mașină care își păstrează discul
Cache-ul există pentru că mașina uită. Un runner găzduit de GitHub e un VM nou pentru fiecare job, așa că jobul își salvează starea în stocarea GitHub și o aduce înapoi data viitoare. Pe o mașină care rămâne, acea stare e deja pe disc: cache-ul managerului de pachete, cache-ul de instrumente, imaginile și cache-ul de build Docker, chiar și rezultatul buildului.
Diferența se vede în CI-ul unor proiecte reale, din rulările noastre ale propriilor lor joburi:
- astro (Node.js, Turborepo): 528 s pe GitHub, 30 s pe o mașină dedicată Skipbox, care păstrează cache-ul turbo, așa că rulările următoare reiau 40 de taskuri de build în loc să le ruleze.
- helix (Rust): pasul de toolchain și cache a durat 9-10 s pe mașina dedicată, față de 41-46 s pe GitHub.
- tauri (Rust): 246 s pe GitHub, 53 s pe mașina dedicată, cu
target/păstrat între joburi.
Skipbox păstrează cache-ul pe mașina ta
Fiecare plan vine cu mașina dedicată a contului tău, păstrată între joburi:
- Cache-urile de pachete rămân pe disc:
~/.npm, store-ul pnpm,~/.cacheal fiecărui instrument și cache-urile Go, Gradle, Cargo și Maven, împreună cu instrumentele instalate desetup-*. Nimic de restaurat. - Rămân și imaginile, layerele și cache-ul de build Docker.
docker buildrefolosește layerele ultimului build (cache-ul de layere Docker). - **actions/cache, setup-* și rust-cache nu au nevoie de nicio schimbare.** Ce salvează ele rămâne lângă mașină în loc de stocarea GitHub, cu mai mult spațiu decât cei 10 GB per repository de la GitHub, iar o restaurare îl citește local.
- Nicio expirare de 7 zile pe disc. Nu se șterge nimic până când discul e aproape plin după un job; atunci pleacă mai întâi ce a fost folosit cel mai demult.
Cel puțin de 7× spațiul de cache de la GitHub, pe S. Un job își alege mărimea prin etichetă:
| Etichetă | Mașină | Disc | Plan |
|---|---|---|---|
skipbox | 4 vCPU · 16 GB | 80 GB | S, $39 pe lună |
skipbox-8x16 | 8 vCPU · 16 GB | 160 GB | M, $79 pe lună |
skipbox-16x32 | 16 vCPU · 32 GB | 320 GB | L, $149 pe lună |
ubuntu-latest dintr-un repository privat are 2 CPU, 8 GB și 14 GB de SSD. Pe Skipbox minutele sunt nelimitate. La 20.000 de minute pe lună pe 4 vCPU, GitHub facturează $222; Skipbox S costă $39, cu $183 mai puțin.
Mutarea înseamnă o singură linie
jobs:
test:
runs-on: skipbox # was ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- run: npm ci && npm test
- Conectează-te la Skipbox cu GitHub.
- Instalează aplicația GitHub Skipbox și alege repository-urile.
- Schimbă
runs-onși fă push.
Păstrează-ți pașii de cache așa cum sunt. A doua rulare găsește pe mașină cache-urile primei rulări.
Securitate
- Mașina este doar a contului tău. Niciun job al altei companii nu rulează pe ea.
- După fiecare job, credențialele runnerului, procesele și containerele sunt șterse. „Curățare la fiecare job” îi dă în schimb fiecărui job o mașină nouă.
- Codul de la persoane fără acces de scriere (cum ar fi pull request-urile din forkuri) rulează pe un VM nou, care îți citește cache-urile, dar nu le poate modifica.
Detaliile sunt în cum sunt izolate joburile.
Încearcă pe jobul al cărui cache ratează
Perioada de probă este gratuită timp de 7 zile sau 3.000 de minute de job, oricare se termină mai întâi, și nu cere card. Mută acel job pe runs-on: skipbox, rulează-l de două ori și pune pașii de restaurare și instalare de la a doua rulare lângă cei de pe GitHub.
Întrebări frecvente
Care este limita de mărime a cache-ului în GitHub Actions?
Implicit 10 GB per repository, pentru toate branchurile și workflow-urile împreună. Peste ea, GitHub tot salvează intrarea nouă și șterge intrări în ordinea ultimului acces, cele mai vechi primele, până când repository-ul e din nou sub limită. Intrările pe care niciun job nu le-a citit de 7 zile sunt șterse indiferent de mărime. Pe un cont Pro, Team sau Enterprise, administratorii pot ridica limita și numărul de zile; stocarea peste 10 GB se facturează cu $0,07 pe GB pe lună, după vârful fiecărei ore, iar când se atinge un buget cache-ul devine doar pentru citire până la următorul ciclu de facturare.
De ce îmi este eliminat atât de des cache-ul GitHub Actions?
Pentru că tot repository-ul împarte aceiași 10 GB: fiecare branch, fiecare pull request, fiecare job din matrice și fiecare sistem de operare își salvează propriile intrări, iar cache-ul Docker type=gha ajunge în același loc. Când salvările unei zile depășesc limita, fiecare salvare șterge o intrare mai veche, iar jobul următor o ratează pe cea de care avea nevoie. GitHub numește asta cache thrashing. Listează intrările după mărime (gh cache list --sort size_in_bytes) ca să vezi ce îl umple.
De ce restaurarea cache-ului durează cât o instalare de la zero?
Pentru că o potrivire tot e o descărcare. Fiecare job de pe un runner găzduit de GitHub pornește pe un VM nou, așa că actions/cache descarcă arhiva și o dezarhivează de fiecare dată, iar cu cât e mai mare cache-ul, cu atât durează mai mult. Cache-ul din setup-node aduce înapoi cache-ul de descărcări al managerului de pachete, nu node_modules, așa că npm ci tot instalează fiecare pachet după restaurare. Pe un runner care își păstrează discul, cache-urile sunt deja acolo și nu se descarcă nimic.
De ce ratează actions/cache pe un branch nou?
O rulare poate restaura cache-uri din propriul branch și din branchul implicit, iar rularea unui pull request și din branchul lui de bază. Nu poate citi cache-urile unui branch vecin. Așa că prima rulare a unui branch de funcționalitate are potrivire doar dacă branchul implicit a salvat acea cheie. Rulează workflow-ul la push-urile pe branchul implicit, ca să salveze, și adaugă restore-keys pentru o potrivire parțială; cache-hit e true doar pentru o potrivire exactă a key.
Cât cache Actions păstrează Skipbox?
Mai mult decât cei 10 GB per repository de la GitHub, lângă mașina ta în loc de stocarea GitHub. Pe o mașină în cloud, ce salvează joburile cu actions/cache, setup-* și rust-cache rămâne pe discul mașinii, până la jumătate din acel disc (80 GB pe S, 160 GB pe M, 320 GB pe L); pe un host Skipbox, cache-ul hostului păstrează 20 GB per repository. În ambele cazuri, o intrare e păstrată 7 zile de la ultima folosire, cu regulile GitHub pentru branchuri. Cache-urile de pachete și layerele Docker nu trec prin el: rămân direct pe disc.
Ce golește cache-urile de pe o mașină Skipbox?
Nimic între joburi: cache-urile rămân pe mașină și doar când un job lasă discul aproape plin pleacă mai întâi ce a fost folosit cel mai demult. Mașina pornește curată la o resetare: când apeși Resetează mașina, când i se actualizează imaginea (cel puțin o dată pe lună), când nu trece verificarea stării după un job și când un job atinge limita de 6 ore. Când se încheie planul, mașina e ștearsă împreună cu discul.
Cât costă să încerc?
Nimic. Perioada de probă durează 7 zile sau 3.000 de minute de job, oricare se termină mai întâi, fără card. Mută jobul al cărui cache ratează sau se restaurează lent pe runs-on: skipbox, rulează-l de două ori și compară pașii de restaurare și instalare de la a doua rulare cu cei de pe GitHub.
Actualizat pe 16 noiembrie 2026