Skipbox

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, iar cleanup (activat implicit) elimină builderul la finalul jobului.
  • 14 GB de disc. ubuntu-latest dintr-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:

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 save scrie imaginile într-un fișier tar, îl pui în cache cu actions/cache, iar în jobul următor rulezi docker 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 și docker compose build refolosesc layerele ultimului build, fără nicio schimbare în workflow.
  • Imaginile rămân pe disc. docker compose up găsește imaginile descărcate data trecută; docker compose pull aduce 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=cache pă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 și cache-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ă:

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

  1. Conectează-te la Skipbox cu GitHub.
  2. Instalează aplicația GitHub Skipbox și alege repository-urile.
  3. 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

CI/CD mai rapid, cu un cache mereu pregătit

Runnerul tău dedicat, la preț fix

Noi le găzduim. Tu schimbi o linie. 1/12 din costul GitHub la utilizare maximă. Preț fix, deci îl poți rula toată ziua. De 7× mai mult spațiu de cache decât GitHub.

  • Fără card
  • Conectare cu GitHub
  • Anulezi oricând