Кэш слоёв Docker в GitHub Actions: почему каждая сборка начинается с нуля и как сохранить слои
Кэш слоёв Docker теряется при каждом запуске GitHub Actions, потому что каждое задание на раннере GitHub начинается на новой ВМ: ни кэша сборки, ни скачанных образов. Builder по умолчанию у docker/setup-buildx-action (docker-container) тоже стартует пустым в каждом задании и удаляется в его конце. Обычное решение — экспортировать кэш через buildx. cache-to: type=gha,mode=max и cache-from: type=gha хранят слои в кэше GitHub Actions — 10 ГБ на репозиторий, общие со всеми остальными кэшами; type=registry хранит их в вашем registry; type=local — в папке, которую вы сохраняете через actions/cache. Каждый вариант превращает пересборку в загрузку и скачивание на каждом запуске.
Skipbox хранит слои там, где идёт сборка. Ваши задания выполняются на выделенной машине вашего аккаунта, которая хранит образы, слои и кэш сборки Docker между заданиями, на диске 80 ГБ на S против 14 ГБ у раннера GitHub. docker build и docker compose build переиспользуют слои прошлой сборки, а образы, которые скачал compose, уже на диске. setup-buildx-action работает как есть, и его builder тоже находит эти слои. Поменяйте одну строку, runs-on: skipbox, за фиксированные $39 в месяц без лимита минут.
Почему каждая сборка начинается с нуля
- Новая ВМ на каждое задание. Справочник GitHub по раннерам (на английском): каждый раннер GitHub — это новая виртуальная машина, которую размещает GitHub. Ничего из того, что собрало или скачало прошлое задание, на ней нет.
- Пустой builder. docker/setup-buildx-action по умолчанию создаёт и запускает builder с драйвером
docker-container, а егоcleanup(включён по умолчанию) удаляет builder в конце задания. - 14 ГБ диска. У
ubuntu-latestв приватном репозитории 2 CPU, 8 ГБ и 14 ГБ SSD. Большой образ, его кэш сборки и архив кэша, который нужно распаковать, могут не поместиться («no space left on device»).
Бэкенды кэша buildx и чего стоит каждый
Из документации Docker по бэкендам кэша и управлению кэшем в GitHub Actions:
| Бэкенд | Куда уходят слои | Чем платит каждый запуск | Ограничения |
|---|---|---|---|
type=gha | Кэш GitHub Actions | Загружает новые слои, скачивает нужные | 10 ГБ на репозиторий вместе со всеми остальными кэшами, вытесняются начиная со старых; scope по умолчанию buildkit перезаписывается каждой сборкой; API кэша GitHub ограничивает частоту |
type=registry | Отдельный образ кэша в вашем registry | Скачивает кэш из registry, загружает новый | Вход в registry с правом push; хранилище и трафик registry |
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
Cache mounts не выживают. 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 ГБ, а загрузка занимает своё время.- Собирать образы сервисов через buildx с бэкендом кэша из таблицы выше — базовые образы всё равно придётся скачивать.
Когда решение — машина, которая хранит кэш Docker
Каждый бэкенд выше существует, потому что builder забывает. Демон Docker, который остаётся между заданиями, уже хранит слои прошлой сборки, её cache mounts и каждый скачанный образ на собственном диске. Нечего экспортировать, нечего импортировать и не с кем делить 10 ГБ.
Skipbox хранит кэш Docker на вашей машине
Каждый тариф — это выделенная машина вашего аккаунта, которая сохраняется между заданиями:
docker buildиdocker compose buildпереиспользуют слои прошлой сборки без изменений в workflow.- Образы остаются на диске.
docker compose upнаходит образы, скачанные в прошлый раз;docker compose pullскачивает только изменившиеся слои. - Cache mounts остаются вместе с кэшем сборки Docker, поэтому
RUN --mount=type=cacheсохраняет кэш менеджера пакетов без дополнительного шага. - docker/setup-buildx-action работает как есть. Его builder стартует со слоёв, которые оставила на машине прошлая сборка вашего репозитория, и
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 App Skipbox и выберите репозитории.
- Измените
runs-onи сделайте push.
Первое задание собирает каждый слой. Второе находит их на машине.
Безопасность
- Машина принадлежит только вашему аккаунту. Задания других компаний на ней не выполняются.
- После каждого задания стираются учётные данные раннера, процессы и контейнеры, а также
~/.docker/config.json, поэтому вход в registry не переходит в следующее задание. Режим «Чистая ВМ для каждого задания» вместо этого даёт каждому заданию новую машину. - Код от людей без прав на запись (например, pull request из форков) выполняется на новой одноразовой машине и никогда — на вашей.
Подробности — в разделе «Как изолированы задания».
Попробуйте на своей сборке Docker
Пробный период бесплатный и без карты: 7 дней или 3 000 мин работы заданий — что закончится раньше. Перенесите сборку Docker на runs-on: skipbox, запустите её дважды и положите шаг сборки второго запуска рядом с GitHub.
Вопросы и ответы
Почему кэш слоёв Docker теряется при каждом запуске GitHub Actions?
Потому что каждое задание на раннере GitHub начинается на новой ВМ, без кэша сборки и без образов прошлого запуска. docker/setup-buildx-action добавляет своё: по умолчанию он создаёт builder 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 хранят слои в кэше GitHub Actions (10 ГБ на репозиторий, общие со всеми остальными кэшами). type=registry хранит их отдельным образом в вашем registry, а type=local — в папке, которую вы сохраняете через actions/cache. С type=gha дайте каждому образу свой scope, потому что scope по умолчанию перезаписывается каждой сборкой. На машине, которая хранит свой диск, docker build переиспользует слои без всякого экспортёра.
Почему buildx с cache-to type=gha всё равно медленный?
Потому что слои всё равно путешествуют. С mode=max каждый запуск загружает каждый новый слой каждой стадии, а следующий запуск скачивает нужные ему слои. Кэш делит 10 ГБ GitHub на репозиторий со всем остальным, поэтому вытесняется, а API кэша GitHub ограничивает частоту для сборки, которая делает слишком много запросов. Builder, у которого слои уже на диске, пропускает оба направления.
Как сделать, чтобы docker compose не скачивал одни и те же образы в каждом задании?
На раннере GitHub — никак, можно только перенести скачивание: docker save образов в tar-файл, кэширование его через actions/cache и docker load в следующем задании. Это идёт в те же 10 ГБ и каждый запуск — скачивание плюс загрузка. На машине, которая хранит свой диск, образы, скачанные compose в прошлый раз, уже на месте, а docker compose pull скачивает только изменившиеся слои.
Нужно ли менять workflow, чтобы кэш Docker сохранялся в Skipbox?
Только runs-on: машина вашего аккаунта хранит образы, слои и кэш сборки Docker между заданиями. docker build и docker compose build переиспользуют их, а docker/setup-buildx-action работает как есть: его builder стартует со слоёв, которые оставила на машине прошлая сборка вашего репозитория. cache-from и cache-to можно убрать.
Сколько стоит попробовать?
Ничего. Пробный период — 7 дней или 3 000 мин работы заданий, что закончится раньше, без карты. Перенесите сборку Docker на runs-on: skipbox, запустите её дважды и сравните шаг сборки второго запуска с GitHub.
Обновлено 19 ноября 2026 г.