Skipbox

Кеш шарів Docker у GitHub Actions: чому кожне збирання стартує холодним і як зберегти шари

Кеш шарів Docker губиться на кожному запуску GitHub Actions, бо кожне завдання на хостованому ранері GitHub стартує на новій ВМ: ні кешу збирання, ні стягнутих образів. Збирач за замовчуванням у docker/setup-buildx-action (docker-container) теж стартує порожнім у кожному завданні й видаляється наприкінці. Звичне рішення — експортувати кеш через buildx. cache-to: type=gha,mode=max і cache-from: type=gha тримають шари в кеші Actions від GitHub, 10 ГБ на репозиторій, спільних з усіма іншими кешами; type=registry — у вашому реєстрі; type=local — у директорії, яку ви зберігаєте через actions/cache. Кожне з них перетворює перезбирання на вивантаження й завантаження на кожному запуску.

Skipbox тримає шари там, де працює збирання. Ваші завдання працюють на виділеній машині вашого облікового запису, яка зберігає образи Docker, шари й кеш збирання між завданнями, на диску 80 ГБ на S проти 14 ГБ на ранері GitHub. docker build і docker compose build перевикористовують шари попереднього збирання, а образи, які стягнув compose, уже на диску. setup-buildx-action працює як є, і його збирач теж знаходить ці шари. Змініть один рядок, runs-on: skipbox, за фіксовані $39 на місяць із хвилинами без обмежень.

Чому кожне збирання стартує холодним

  • Нова ВМ на кожне завдання. Довідник ранерів GitHub: кожен хостований ранер GitHub — це нова віртуальна машина (ВМ), яку хостить GitHub. На ній немає нічого, що зібрало чи стягнуло попереднє завдання.
  • Порожній збирач. docker/setup-buildx-action за замовчуванням створює й запускає збирач із драйвером docker-container, а його cleanup (увімкнений за замовчуванням) видаляє збирач наприкінці завдання.
  • 14 ГБ диска. ubuntu-latest приватного репозиторію має 2 CPU, 8 ГБ і 14 ГБ SSD. Великий образ, його кеш збирання й архів кешу для розпакування можуть вичерпати місце («no space left on device»).

Бекенди кешу buildx і скільки коштує кожен

З бекендів кешу Docker і керування кешем із GitHub Actions:

Хоч який бекенд ви оберете, упорядкуйте Dockerfile так, щоб шари, що змінюються найрідше, йшли першими: скопіюйте lock-файл і встановіть залежності, перш ніж копіювати вихідний код. Інакше кожен коміт робить недійсним шар встановлення, і жоден кеш його не поверне.

mode=min, за замовчуванням, зберігає лише шари кінцевого образу. mode=max зберігає шари кожного етапу, тож багатоетапне збирання влучає частіше — і вивантажує більше.

Типове налаштування type=gha з власним scope для кожного образу:

- 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

Монтування кешу не зберігаються. RUN --mount=type=cache (кеш менеджера пакетів усередині збирання) за замовчуванням не зберігається в кеші GitHub Actions; документація Docker радить buildkit-cache-dance, щоб переносити його в actions/cache і назад, — ще одне завантаження й вивантаження на кожен запуск.

docker compose стягує кожен образ у кожному завданні

Інтеграційні тести, що піднімають Postgres, Redis і кілька сервісів через docker compose up, стягують кожен образ у кожному завданні, бо ВМ нова. На хостованих ранерах GitHub варіанти лише переносять завантаження:

  • docker save образів у tar-файл, кешування через actions/cache і docker load у наступному завданні. Це рахується в 10 ГБ, а сам load теж займає час.
  • Збирати образи сервісів через buildx з одним із бекендів кешу вище, і тоді однаково лишаються базові образи, які треба стягнути.

Коли рішення — машина, що зберігає кеш Docker

Кожен бекенд вище існує, бо збирач забуває. Демон Docker, що лишається між завданнями, уже має шари попереднього збирання, його монтування кешу й кожен стягнутий образ на власному диску. Нічого не треба експортувати, нічого імпортувати і нема з ким ділити 10 ГБ.

Skipbox тримає кеш Docker на вашій машині

Кожен тариф дає виділену машину вашого облікового запису, яка лишається між завданнями:

  • docker build і docker compose build перевикористовують шари попереднього збирання, без жодних змін у workflow.
  • Образи лишаються на диску. docker compose up знаходить образи, які стягнув минулого разу; docker compose pull завантажує лише змінені шари.
  • Монтування кешу лишаються разом із кешем збирання Docker, тож RUN --mount=type=cache зберігає кеш менеджера пакетів без додаткового кроку.
  • docker/setup-buildx-action працює як є. Його збирач стартує з шарів, які залишило на машині попереднє збирання вашого репозиторію, і cache-from та cache-to можна прибрати. У нашому власному запуску CI одного публічного проєкту на машині з 4 vCPU (19 листопада 2026 року, по одному запуску) крок збирання образу тривав 177 с у першому запуску і 4 с у повторному, 31 крок — CACHED.
  • Диск: нічого не видаляється, доки диск після завдання майже не заповниться. Тоді першими йдуть «висячі» образи, потім кеш збирання, яким найдовше не користувалися.
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

Завдання вибирає розмір міткою:

Хвилини без обмежень. На 20 000 хвилинах на місяць на 4 vCPU GitHub виставляє $222; Skipbox S коштує $39, на $183 менше.

Перехід — це один рядок

  1. Увійдіть у Skipbox через GitHub.
  2. Встановіть GitHub-застосунок Skipbox і виберіть репозиторії.
  3. Змініть runs-on і зробіть push.

Перше завдання збирає кожен шар. Друге знаходить їх на машині.

Безпека

  • Машина належить лише вашому обліковому запису. Завдання жодної іншої компанії на ній не працюють.
  • Після кожного завдання стираються облікові дані ранера, процеси й контейнери, а також ~/.docker/config.json, тож вхід у реєстр не переходить у наступне завдання. «Чиста ВМ для кожного завдання» натомість дає кожному завданню нову машину.
  • Код від людей без права запису (наприклад, pull requests з форків) запускається на новій одноразовій машині, ніколи не на вашій.

Подробиці — у розділі Як ізольовано завдання.

Спробуйте на своєму збиранні Docker

Пробний період безкоштовний: 7 днів або 3 000 хв роботи завдань, залежно від того, що закінчиться раніше, і без картки. Перенесіть збирання Docker на runs-on: skipbox, запустіть двічі й порівняйте крок збирання другого запуску з GitHub.

Запитання й відповіді

Чому кеш шарів Docker губиться на кожному запуску GitHub Actions?

Бо кожне завдання на хостованому ранері GitHub стартує на новій ВМ, без кешу збирання й без образів з попереднього запуску. docker/setup-buildx-action додає своє: за замовчуванням він створює збирач docker-container, який стартує порожнім і видаляється наприкінці завдання. Тож кожен шар перезбирається, якщо не експортувати кеш через cache-to й не імпортувати через cache-from або не працювати на машині, що зберігає кеш збирання Docker.

Як кешувати шари Docker у GitHub Actions?

На хостованих ранерах GitHub — експортерами кешу buildx: cache-from: type=gha і cache-to: type=gha,mode=max у docker/build-push-action зберігають шари в кеші Actions від GitHub (10 ГБ на репозиторій, спільні з усіма іншими кешами). type=registry зберігає їх окремим образом у вашому реєстрі, а type=local — у директорії, яку ви зберігаєте через actions/cache. З type=gha дайте кожному образу власний scope, бо scope за замовчуванням перезаписує кожне збирання. На машині, що зберігає свій диск, docker build перевикористовує шари без жодного експортера.

Чому buildx із cache-to type=gha досі повільний?

Бо шари однаково подорожують. З mode=max кожен запуск вивантажує кожен новий шар кожного етапу, а наступний запуск завантажує потрібні шари. Кеш ділить 10 ГБ на репозиторій від GitHub з усім іншим, тож його витісняють, а API кешу GitHub обмежує частоту для збирання, яке робить забагато запитів. Збирач, у якого шари вже на диску, пропускає обидва напрямки.

Як зробити, щоб docker compose не стягував ті самі образи в кожному завданні?

На хостованому ранері GitHub цього не уникнути, лише перенести завантаження: docker save образів у tar-файл, кешувати його через actions/cache і docker load у наступному завданні. Це рахується в тих самих 10 ГБ і щоразу означає завантаження й load. На машині, що зберігає свій диск, образи, які compose стягнув минулого разу, вже на місці, а docker compose pull завантажує лише змінені шари.

Чи треба змінювати workflow, щоб зберігати кеш Docker на Skipbox?

Лише runs-on: машина вашого облікового запису зберігає образи Docker, шари й кеш збирання між завданнями. docker build і docker compose build перевикористовують їх, а docker/setup-buildx-action працює як є: його збирач стартує з шарів, які залишило на машині попереднє збирання вашого репозиторію. cache-from та cache-to можна прибрати.

Скільки коштує спробувати?

Нічого. Пробний період триває 7 днів або 3 000 хв роботи завдань, залежно від того, що закінчиться раніше, без картки. Перенесіть збирання Docker на runs-on: skipbox, запустіть двічі й порівняйте крок збирання другого запуску з GitHub.

Оновлено 19 листопада 2026 р.

Швидший CI/CD із завжди прогрітим кешем

Ваш прогрітий ранер за фіксовану ціну

Хостинг наш. Ви змінюєте один рядок. 1/12 вартості GitHub за повного навантаження. Ціна фіксована, тож запускайте хоч цілий день. Місця для кешу в 7× більше, ніж у GitHub.

  • Без картки
  • Вхід через GitHub
  • Скасування будь-коли