Кеш шарів 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:
| Бекенд | Куди йдуть шари | Що платить кожен запуск | Обмеження |
|---|---|---|---|
type=gha | Кеш Actions від GitHub | Вивантажує нові шари, завантажує потрібні | 10 ГБ на репозиторій з усіма іншими кешами, витісняються від найстаріших; scope за замовчуванням buildkit перезаписує кожне збирання; API кешу GitHub обмежує частоту |
type=registry | Окремий образ кешу у вашому реєстрі | Стягує кеш із реєстру, надсилає новий | Вхід у реєстр із правом push; сховище й трафік реєстру |
type=inline | Усередині самого образу | Стягує образ, щоб прочитати його кеш | Лише mode=min: шари проміжних етапів не зберігаються |
type=local + actions/cache | Директорія, збережена через actions/cache | Завантажує й розпаковує всю директорію, потім вивантажує її | Росте з кожним запуском, якщо не reset=true (Buildx 0.35.0 і новіші); рахується в 10 ГБ |
Хоч який бекенд ви оберете, упорядкуйте 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
Завдання вибирає розмір міткою:
| Мітка | Машина | Диск | Тариф |
|---|---|---|---|
skipbox | 4 vCPU · 16 ГБ | 80 ГБ | S, $39 на місяць |
skipbox-8x16 | 8 vCPU · 16 ГБ | 160 ГБ | M, $79 на місяць |
skipbox-16x32 | 16 vCPU · 32 ГБ | 320 ГБ | L, $149 на місяць |
Хвилини без обмежень. На 20 000 хвилинах на місяць на 4 vCPU GitHub виставляє $222; Skipbox S коштує $39, на $183 менше.
Перехід — це один рядок
- Увійдіть у Skipbox через GitHub.
- Встановіть GitHub-застосунок Skipbox і виберіть репозиторії.
- Змініть
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 р.