# Кэш слоёв Docker в GitHub Actions: почему каждая сборка начинается с нуля и как сохранить слои

> Каждое задание GitHub Actions начинается на новой ВМ без кэша сборки Docker и без скачанных образов, а builder по умолчанию у setup-buildx-action стартует пустым. cache-to и cache-from у buildx (gha, registry, local) возвращают слои в виде скачиваний, в пределах 10 ГБ GitHub. Раннеру, который хранит кэш сборки Docker на своём диске, ничего из этого не нужно, за фиксированные $39 в месяц.

Кэш слоёв 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: новая ВМ на каждое задание, поэтому ни слоёв, ни образов, и пустой builder buildx в каждом запуске
- Skipbox: кэш сборки и образы Docker остаются на диске вашей машины, поэтому неизменённые слои не пересобираются и не скачиваются
- 20 000 минут в месяц на 4 vCPU: $222 на GitHub, $39 в Skipbox

**GitHub Actions по фиксированной цене, минуты без ограничений** Skipbox выполняет задания GitHub Actions на вашей собственной выделенной машине: $39 в месяц, сколько бы минут вы ни использовали. Слои Docker и кэши зависимостей сохраняются между заданиями, поэтому следующее задание запускается сразу.

Раннер на 4 vCPU, 20 000 минут в месяц: GitHub $222 → Skipbox $39. Вы экономите $183 каждый месяц.

Достаточно изменить одну строку: `runs-on: skipbox`.

[Попробовать бесплатно 7 дн.](https://app.skipbox.dev/sign-in?ref=g-docker-layer-cache-github-actions-ru)

## Почему каждая сборка начинается с нуля

- **Новая ВМ на каждое задание.** [Справочник GitHub по раннерам](https://docs.github.com/en/actions/reference/runners/github-hosted-runners) (на английском): каждый раннер GitHub — это новая виртуальная машина, которую размещает GitHub. Ничего из того, что собрало или скачало прошлое задание, на ней нет.
- **Пустой builder.** [docker/setup-buildx-action](https://github.com/docker/setup-buildx-action) по умолчанию создаёт и запускает builder с драйвером `docker-container`, а его `cleanup` (включён по умолчанию) удаляет builder в конце задания.
- **14 ГБ диска.** У `ubuntu-latest` в приватном репозитории 2 CPU, 8 ГБ и 14 ГБ SSD. Большой образ, его кэш сборки и архив кэша, который нужно распаковать, могут не поместиться («no space left on device»).

## Бэкенды кэша buildx и чего стоит каждый

Из документации Docker по [бэкендам кэша](https://docs.docker.com/build/cache/backends/) и [управлению кэшем в GitHub Actions](https://docs.docker.com/build/ci/github-actions/cache/):

| Бэкенд | Куда уходят слои | Чем платит каждый запуск | Ограничения |
|---|---|---|---|
| `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`](https://docs.docker.com/build/cache/backends/local/) (Buildx 0.35.0 и новее); идёт в 10 ГБ |

Какой бы бэкенд вы ни выбрали, [упорядочьте Dockerfile](https://docs.docker.com/build/cache/optimize/) так, чтобы первыми шли слои, которые меняются реже всего: скопируйте lock-файл и поставьте зависимости до того, как копировать исходники. Иначе каждый коммит инвалидирует слой установки, и никакой кэш его не вернёт.

`mode=min`, режим по умолчанию, хранит только слои итогового образа. `mode=max` хранит слои всех стадий, поэтому многостадийная сборка попадает чаще — и загружает больше.

Типичная настройка `type=gha`, со своим scope для каждого образа:

```yaml
- 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](https://github.com/reproducible-containers/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.
- **Диск:** ничего не удаляется, пока после задания диск почти не заполнится. Тогда первыми уходят висячие образы, затем кэш сборки, который использовали давнее всего.

```yaml
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 меньше.

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

1. Войдите в Skipbox через GitHub.
2. Установите GitHub App Skipbox и выберите репозитории.
3. Измените `runs-on` и сделайте push.

Первое задание собирает каждый слой. Второе находит их на машине.

## Безопасность

- Машина принадлежит только вашему аккаунту. Задания других компаний на ней не выполняются.
- После каждого задания стираются учётные данные раннера, процессы и контейнеры, а также `~/.docker/config.json`, поэтому вход в registry не переходит в следующее задание. Режим «Чистая ВМ для каждого задания» вместо этого даёт каждому заданию новую машину.
- Код от людей без прав на запись (например, pull request из форков) выполняется на новой одноразовой машине и никогда — на вашей.

Подробности — в разделе [«Как изолированы задания»](https://docs.skipbox.dev/ru/isolation).

## Попробуйте на своей сборке 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.

Обновлено 2026-11-19 · https://skipbox.dev/ru/guides/docker-layer-cache-github-actions
