Skipbox

Кэш слоёв 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:

Какой бы бэкенд вы ни выбрали, упорядочьте 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

Задание выбирает размер меткой:

Минуты не ограничены. При 20 000 минут в месяц на 4 vCPU GitHub выставляет $222; Skipbox S стоит $39 — на $183 меньше.

Переход — это одна строка

  1. Войдите в Skipbox через GitHub.
  2. Установите GitHub App Skipbox и выберите репозитории.
  3. Измените 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 г.

Более быстрый CI/CD с всегда «тёплым» кэшем

Ваш «тёплый» раннер по фиксированной цене

Хостинг наш. Вы меняете одну строку. 1/12 стоимости GitHub при полной загрузке. Цена фиксированная — гоняйте CI хоть весь день. В 7× больше места под кэш, чем у GitHub.

  • Без карты
  • Вход через GitHub
  • Отмена в любой момент