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

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

Кеш шарів 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: нова ВМ на кожне завдання, тож ні шарів, ні образів і порожній збирач 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-uk)

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

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

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

З [бекендів кешу](https://docs.docker.com/build/cache/backends/) Docker і [керування кешем із GitHub Actions](https://docs.docker.com/build/ci/github-actions/cache/):

| Бекенд | Куди йдуть шари | Що платить кожен запуск | Обмеження |
|---|---|---|---|
| `type=gha` | Кеш Actions від GitHub | Вивантажує нові шари, завантажує потрібні | 10 ГБ на репозиторій з усіма іншими кешами, витісняються від найстаріших; scope за замовчуванням `buildkit` перезаписує кожне збирання; API кешу GitHub обмежує частоту |
| `type=registry` | Окремий образ кешу у вашому реєстрі | Стягує кеш із реєстру, надсилає новий | Вхід у реєстр із правом push; сховище й трафік реєстру |
| `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
```

**Монтування кешу не зберігаються.** `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 ГБ, а сам 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.
- **Диск:** нічого не видаляється, доки диск після завдання майже не заповниться. Тоді першими йдуть «висячі» образи, потім кеш збирання, яким найдовше не користувалися.

```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-застосунок Skipbox і виберіть репозиторії.
3. Змініть `runs-on` і зробіть push.

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

## Безпека

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

Подробиці — у розділі [Як ізольовано завдання](https://docs.skipbox.dev/uk/isolation).

## Спробуйте на своєму збиранні 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.

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