Cache-ul de layere Docker în GitHub Actions: de ce fiecare build pornește la rece și cum păstrezi layerele
Cache-ul de layere Docker se pierde la fiecare rulare GitHub Actions pentru că fiecare job de pe un runner găzduit de GitHub pornește pe un VM nou: niciun cache de build, nicio imagine descărcată. Builderul implicit al docker/setup-buildx-action (docker-container) pornește și el gol în fiecare job și e eliminat la finalul lui. Soluția obișnuită e să exporți cache-ul cu buildx. cache-to: type=gha,mode=max și cache-from: type=gha țin layerele în cache-ul Actions al GitHub, 10 GB per repository, împărțiți cu toate celelalte cache-uri; type=registry le ține în registry-ul tău; type=local, într-un director pe care îl salvezi cu actions/cache. Fiecare transformă o reconstruire într-o încărcare și o descărcare la fiecare rulare.
Skipbox păstrează layerele acolo unde rulează buildul. Joburile tale rulează pe mașina dedicată a contului tău, care păstrează imaginile, layerele și cache-ul de build Docker între joburi, pe un disc de 80 GB pe S, față de 14 GB pe runnerul GitHub. docker build și docker compose build refolosesc layerele ultimului build, iar imaginile descărcate de compose sunt deja pe disc. setup-buildx-action funcționează așa cum este, iar builderul lui găsește și el aceste layere. Schimbi o singură linie, runs-on: skipbox, la un preț fix de $39 pe lună, cu minute nelimitate.
De ce fiecare build pornește la rece
- Un VM nou la fiecare job. Referința GitHub despre runnere spune că fiecare runner găzduit de GitHub este o mașină virtuală (VM) nouă, găzduită de GitHub. Nimic din ce a construit sau a descărcat jobul anterior nu e pe ea.
- Un builder gol. docker/setup-buildx-action creează și pornește implicit un builder cu driverul
docker-container, iarcleanup(activat implicit) elimină builderul la finalul jobului. - 14 GB de disc.
ubuntu-latestdintr-un repository privat are 2 CPU, 8 GB și 14 GB de SSD. O imagine mare, cache-ul ei de build și o arhivă de cache de dezarhivat pot rămâne fără spațiu („no space left on device”).
Backendurile de cache din buildx și cât costă fiecare
Din documentația Docker despre backendurile de cache și despre gestionarea cache-ului cu GitHub Actions:
| Backend | Unde ajung layerele | Ce plătește fiecare rulare | Limite |
|---|---|---|---|
type=gha | Cache-ul Actions al GitHub | Încarcă layerele noi, le descarcă pe cele de care are nevoie | 10 GB per repository împreună cu toate celelalte cache-uri, eliminate începând cu cele mai vechi; scope-ul implicit buildkit e suprascris de fiecare build; API-ul de cache al GitHub limitează ritmul |
type=registry | O imagine de cache separată în registry-ul tău | Descarcă cache-ul din registry, îl încarcă pe cel nou | O autentificare la registry cu drept de push; stocarea și traficul registry-ului |
type=inline | În imaginea însăși | Descarcă imaginea ca să-i citească cache-ul | Doar mode=min: layerele etapelor intermediare nu sunt păstrate |
type=local + actions/cache | Un director salvat cu actions/cache | Descarcă și dezarhivează tot directorul, apoi îl încarcă | Crește la fiecare rulare dacă nu folosești reset=true (Buildx 0.35.0 și mai nou); intră în cei 10 GB |
Oricare backend ai alege, ordonează Dockerfile-ul astfel încât layerele care se schimbă cel mai rar să fie primele: copiază lockfile-ul și instalează dependențele înainte să copiezi sursele. Altfel, fiecare commit invalidează layerul de instalare, iar niciun cache nu îl aduce înapoi.
mode=min, implicit, păstrează doar layerele imaginii finale. mode=max păstrează layerele fiecărei etape, așa că un build multi-stage are mai multe potriviri și încarcă mai mult.
O configurare tipică type=gha, cu propriul scope pentru fiecare imagine:
- uses: docker/setup-buildx-action@v4
- uses: docker/build-push-action@v7
with:
context: .
tags: app:ci
load: true
cache-from: type=gha,scope=app
cache-to: type=gha,scope=app,mode=max
Cache mount-urile nu supraviețuiesc. RUN --mount=type=cache (cache-ul unui manager de pachete în interiorul buildului) nu e păstrat implicit în cache-ul GitHub Actions; documentația Docker trimite la buildkit-cache-dance ca să îl muți în și din actions/cache, încă o descărcare și o încărcare la fiecare rulare.
docker compose descarcă toate imaginile, la fiecare job
Testele de integrare care pornesc Postgres, Redis și câteva servicii cu docker compose up descarcă fiecare imagine la fiecare job, pentru că VM-ul e nou. Pe runnerele găzduite de GitHub, opțiunile doar mută descărcarea:
docker savescrie imaginile într-un fișier tar, îl pui în cache cu actions/cache, iar în jobul următor rulezidocker load. Intră în cei 10 GB, iar încărcarea are propria durată.- Construiești imaginile serviciilor cu buildx și unul dintre backendurile de mai sus, ceea ce tot lasă de descărcat imaginile de bază.
Când soluția e o mașină care păstrează cache-ul Docker
Fiecare backend de mai sus există pentru că builderul uită. Un daemon Docker care rămâne între joburi are deja pe propriul disc layerele ultimului build, cache mount-urile lui și fiecare imagine descărcată. Nu ai nimic de exportat, nimic de importat și niciun 10 GB de împărțit.
Skipbox păstrează cache-ul Docker pe mașina ta
Fiecare plan vine cu mașina dedicată a contului tău, păstrată între joburi:
docker buildșidocker compose buildrefolosesc layerele ultimului build, fără nicio schimbare în workflow.- Imaginile rămân pe disc.
docker compose upgăsește imaginile descărcate data trecută;docker compose pulladuce doar layerele care s-au schimbat. - Cache mount-urile rămân împreună cu cache-ul de build Docker, așa că
RUN --mount=type=cachepăstrează cache-ul managerului de pachete fără niciun pas în plus. - docker/setup-buildx-action funcționează așa cum este. Builderul lui pornește de la layerele pe care ultimul build al repository-ului tău le-a lăsat pe mașină, și poți renunța la
cache-fromșicache-to. În propria noastră rulare a CI-ului unui proiect public, pe o mașină cu 4 vCPU (19 noiembrie 2026, câte o rulare), pasul care construiește imaginea a durat 177 s la prima rulare și 4 s la reluare, cu 31 de pași CACHED. - Discul: nu se șterge nimic până când discul e aproape plin după un job. Atunci pleacă mai întâi imaginile neetichetate, apoi cache-ul de build folosit cel mai demult.
jobs:
build:
runs-on: skipbox # was ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: docker/setup-buildx-action@v4
- uses: docker/build-push-action@v7
with:
context: .
tags: app:ci
load: true
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ă |
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
- Conectează-te la Skipbox cu GitHub.
- Instalează aplicația GitHub Skipbox și alege repository-urile.
- Schimbă
runs-onși fă push.
Primul job construiește fiecare layer. Al doilea le găsește pe mașină.
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, la fel și
~/.docker/config.json, așa că o autentificare la registry nu trece la jobul următor. „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 o mașină nouă, de unică folosință, niciodată pe a ta.
Detaliile sunt în cum sunt izolate joburile.
Încearcă pe buildul tău Docker
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ă buildul Docker pe runs-on: skipbox, rulează-l de două ori și pune pasul de build de la a doua rulare lângă cel de pe GitHub.
Întrebări frecvente
De ce se pierde cache-ul de layere Docker la fiecare rulare GitHub Actions?
Pentru că fiecare job de pe un runner găzduit de GitHub pornește pe un VM nou, fără cache de build și fără imaginile rulării anterioare. docker/setup-buildx-action adaugă la asta: implicit creează un builder docker-container care pornește gol și e eliminat la finalul jobului. Așa că fiecare layer se reconstruiește, dacă nu exporți cache-ul cu cache-to și nu îl imporți cu cache-from sau nu rulezi pe o mașină care păstrează cache-ul de build Docker.
Cum pun în cache layerele Docker în GitHub Actions?
Pe runnerele găzduite de GitHub, cu exportatoarele de cache din buildx: cache-from: type=gha și cache-to: type=gha,mode=max în docker/build-push-action stochează layerele în cache-ul Actions al GitHub (10 GB per repository, împărțiți cu toate celelalte cache-uri). type=registry le stochează ca imagine separată în registry-ul tău, iar type=local într-un director pe care îl salvezi cu actions/cache. Dă-i fiecărei imagini propriul scope cu type=gha, pentru că scope-ul implicit e suprascris de fiecare build. Pe o mașină care își păstrează discul, docker build refolosește layerele fără niciun exportator.
De ce buildx cu cache-to type=gha e tot lent?
Pentru că layerele tot călătoresc. Cu mode=max, fiecare rulare încarcă fiecare layer nou din fiecare etapă, iar o rulare ulterioară descarcă layerele de care are nevoie. Cache-ul împarte cei 10 GB per repository de la GitHub cu tot restul, așa că e eliminat, iar API-ul de cache al GitHub limitează un build care face prea multe cereri. Un builder care are deja layerele pe disc sare peste ambele direcții.
Cum opresc docker compose să descarce aceleași imagini la fiecare job?
Pe un runner găzduit de GitHub nu poți, doar muți descărcarea: docker save scrie imaginile într-un fișier tar, îl pui în cache cu actions/cache, iar în jobul următor rulezi docker load. Asta intră în aceiași 10 GB și înseamnă o descărcare și o încărcare la fiecare rulare. Pe o mașină care își păstrează discul, imaginile descărcate data trecută de compose sunt deja acolo, iar docker compose pull aduce doar layerele care s-au schimbat.
Trebuie să îmi schimb workflow-ul ca să păstrez cache-ul Docker pe Skipbox?
Doar runs-on: mașina ta dedicată păstrează imaginile, layerele și cache-ul de build Docker între joburi. docker build și docker compose build le refolosesc, iar docker/setup-buildx-action funcționează așa cum este: builderul lui pornește de la layerele pe care ultimul build al repository-ului tău le-a lăsat pe mașină. Poți renunța la cache-from și cache-to.
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ă buildul Docker pe runs-on: skipbox, rulează-l de două ori și compară pasul de build de la a doua rulare cu cel de pe GitHub.
Actualizat pe 19 noiembrie 2026