# Ліміт розміру кешу GitHub Actions: чому кеш витісняється, повільно відновлюється або не влучає

> Кеш GitHub Actions вміщує 10 ГБ на репозиторій, понад ліміт видаляє записи, які читали найдавніше, і прибирає будь-який запис, яким не користувалися 7 дн. Навіть влучання — це завантаження на нову ВМ. Скільки коштує кожне виправлення і чому ранер, що зберігає свій диск, робить більшу частину кешу непотрібною, за фіксовані $39 на місяць.

GitHub Actions дає кожному репозиторію 10 ГБ кешу. Щойно репозиторій перевищує цей обсяг, GitHub однаково зберігає новий запис і видаляє записи, які читали найдавніше, доки не повернеться в ліміт, а ще видаляє будь-який запис, який жодне завдання не читало 7 дн. Гілка читає лише власні кеші й кеші гілки за замовчуванням, тож перший запуск нової гілки часто не влучає. А влучання — це однаково завантаження: кожне завдання на хостованому ранері GitHub стартує на новій ВМ, тож знову завантажує й розпаковує архів. Ліміт можна підняти, по 0,07 USD за ГБ на місяць понад 10 ГБ, і налаштувати ключі, але завантаження лишається.

Skipbox прибирає завантаження. Ваші завдання працюють на виділеній машині вашого облікового запису, яка лишається між завданнями, тож кеші npm, pnpm, Gradle, Go і Cargo та шари Docker досі на її диску з попереднього завдання (80 ГБ на S проти 14 ГБ на ранері GitHub). Те, що зберігає actions/cache, лишається поряд із машиною, тож відновлення — це локальне читання. Змініть один рядок, `runs-on: skipbox`, за фіксовані $39 на місяць із хвилинами без обмежень.

- GitHub: 10 ГБ на репозиторій, записи, якими не користувалися 7 дн., видаляються, кожне влучання завантажується знову
- Skipbox: кеші пакетів і шари Docker лишаються на диску вашої машини, і місця для кешу щонайменше в 7× більше, ніж у GitHub
- 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-github-actions-cache-size-limit-uk)

## Правила кешу GitHub

З [довідника GitHub про кешування залежностей](https://docs.github.com/en/actions/reference/workflows-and-actions/dependency-caching), [Actions billing](https://docs.github.com/en/billing/concepts/product-billing/github-actions) і запису в changelog про [кеші понад 10 ГБ](https://github.blog/changelog/2025-11-20-github-actions-cache-size-can-now-exceed-10-gb-per-repository/):

| Правило | Що робить GitHub |
|---|---|
| Розмір | За замовчуванням 10 ГБ на репозиторій, спільні для всіх гілок і workflow |
| Понад розмір | Зберігає новий запис, потім видаляє записи за часом останнього доступу, починаючи з найстаріших, доки репозиторій не вміститься в ліміт. Витіснення працює щогодини |
| Невикористані записи | Видаляє будь-який запис, який не читали понад 7 дн. |
| Більший ліміт | В обліковому записі Pro, Team або Enterprise адміністратори можуть підняти розмір і кількість днів. Понад 10 ГБ — 0,07 USD за ГБ на місяць, за піковим значенням кожної години. Коли досягнуто бюджету, кеш стає доступним лише для читання до наступного розрахункового періоду |
| Гілки | Запуск відновлює кеші своєї гілки й гілки за замовчуванням; запуск pull request — ще й базової гілки. Ніколи — сусідньої чи дочірньої гілки |
| Pull requests | Кеші pull request прив’язані до його merge ref: їх читають лише перезапуски цього pull request |
| Записи | Їх не можна змінити. Ключ, який уже існує, повторно не зберігається |
| Влучання | `cache-hit` дорівнює `true` лише за точного збігу `key`; збіг за `restore-keys` — це `false` |
| Частота | До 200 вивантажень і 1 500 завантажень на хвилину на репозиторій |

## Чому кеш витісняється

Одні 10 ГБ вміщують усе, що зберігає репозиторій. Кожна гілка і кожен pull request зберігають власні записи. Матриця з трьох версій Node на двох операційних системах зберігає шість. Кеш збирання Docker `type=gha` потрапляє в ті самі 10 ГБ. Коли збереження за день перевищують ліміт, кожне нове збереження видаляє старіший запис, часто саме той, що потрібен наступному завданню. GitHub називає це cache thrashing.

Щоб побачити, що його заповнює, виведіть записи за розміром:

```bash
gh cache list --sort size_in_bytes --limit 20
```

Сторінка Actions › Caches репозиторію показує те саме, з гілкою й останнім використанням кожного запису.

## Чому відновлення повільне

Влучання в кеш на хостованому ранері GitHub — це завантаження на нову ВМ, а потім розпакування. Його час росте разом з архівом, тож кеш, що виріс до кількох ГБ, може відновлюватися стільки ж, скільки встановлення, яке він мав пропустити. Завантаження, що зависло, обриває тайм-аут сегмента actions/cache, за замовчуванням 10 хвилин (`SEGMENT_DOWNLOAD_TIMEOUT_MINS`).

Більшість налаштувань ще й відновлюють менше, ніж здається. Параметр `cache:` у [setup-node](https://github.com/actions/setup-node) зберігає кеш завантажень менеджера пакетів, а не `node_modules`: після відновлення `npm ci` однаково встановлює кожен пакет. Кеш pip у setup-python такий самий: завантаження повертаються, середовище встановлюється знову.

## Чому кеш не влучає

- **Ключ змінився.** Ключ із `hashFiles('**/package-lock.json')` не влучає за кожної зміни lock-файлу. `restore-keys` дає частковий збіг, і тоді `cache-hit` дорівнює `false`.
- **Нова гілка.** Вона може читати кеші гілки за замовчуванням, але не іншої гілки функції. Якщо гілка за замовчуванням ніколи не запускала workflow, читати нічого.
- **Витіснено.** Його забрав ліміт або 7 дн.
- **Його так і не збережено.** Записи не можна змінити, тож наявний ключ ніколи не зберігається повторно, і вміст кешу лишається таким давнім, як його перше збереження. Pull request з форку може взагалі не мати права зберігати.

**Передати файли наступному завданню того самого запуску** — це інший інструмент. Кеш — для наступного запуску; результати збирання, потрібні пізнішому завданню того самого workflow, передаються через `actions/upload-artifact` і `actions/download-artifact`. Артефакти мають власне сховище, окремо від 10 ГБ, і теж завантажуються на нову ВМ.

## Скільки коштує кожне виправлення на ранерах GitHub

- **Підняти ліміт.** Менше витіснень, по 0,07 USD за ГБ на місяць понад 10 ГБ (власний приклад GitHub: 200 ГБ, використаних повністю, — це 13,30 USD на місяць), в обліковому записі Pro, Team або Enterprise. Відновлення лишаються завантаженнями, а більші кеші довше завантажуються.
- **Зберігати менше.** Кешуйте `~/.npm` або сховище pnpm, а не `node_modules` чи результати збирання. Зберігайте лише в гілці за замовчуванням, з `actions/cache/restore` у кожному завданні й `actions/cache/save` в одному. Це коштує вашого часу, а менший кеш відновлює менше.
- **Виправити ключі.** Прив’яжіть ключ до lock-файлу, додайте `restore-keys` і запускайте workflow на push у гілку за замовчуванням, щоб новим гілкам було що читати.
- **Self-hosted ранер, що зберігає диск.** Жодного завантаження, жодних 10 ГБ. Машину обслуговуєте ви: оновлення ОС, очищення між завданнями без видалення кешів і ремонт, коли вона ламається.

## Коли рішення — машина, що зберігає свій диск

Кеш існує, бо машина забуває. Хостований ранер GitHub — це нова ВМ для кожного завдання, тож завдання зберігає свій стан у сховищі GitHub і наступного разу забирає його назад. На машині, що лишається, цей стан уже на диску: кеш менеджера пакетів, кеш інструментів, образи Docker і кеш збирання, навіть результати збирання.

Різниця видна на CI реальних проєктів, з [наших запусків їхніх власних завдань](https://skipbox.dev/uk/guides/rust-cache-slow-rust-ci):

- **astro (Node.js, Turborepo):** 528 с на GitHub, 30 с на виділеній машині Skipbox, яка зберігає кеш turbo, тож його «теплі» запуски відтворюють 40 завдань збирання замість того, щоб виконувати їх.
- **helix (Rust):** крок із набором інструментів і кешем займав 9-10 с на виділеній машині проти 41-46 с на GitHub.
- **tauri (Rust):** 246 с на GitHub, 53 с на виділеній машині, з `target/`, збереженим між завданнями.

## Skipbox тримає кеш на вашій машині

Кожен тариф дає виділену машину вашого облікового запису, яка лишається між завданнями:

- **Кеші пакетів лишаються на диску:** `~/.npm`, сховище pnpm, `~/.cache` кожного інструмента, кеші Go, Gradle, Cargo і Maven разом з інструментами, які встановили `setup-*`. Нічого відновлювати не треба.
- **Образи Docker, шари й кеш збирання теж лишаються.** `docker build` перевикористовує шари попереднього збирання ([кеш шарів Docker](https://skipbox.dev/uk/guides/docker-layer-cache-github-actions)).
- **actions/cache, setup-* і rust-cache не потребують змін.** Те, що вони зберігають, лишається поряд із машиною, а не в сховищі GitHub, з більшим місцем, ніж 10 ГБ на репозиторій у GitHub, і відновлення читає його локально.
- **На диску немає строку в 7 дн.** Нічого не видаляється, доки диск після завдання майже не заповниться; тоді першим іде те, чим найдовше не користувалися.

Щонайменше в 7× більше місця для кешу, ніж у GitHub, уже на S. Завдання вибирає розмір міткою:

| Мітка | Машина | Диск | Тариф |
|---|---|---|---|
| `skipbox` | 4 vCPU · 16 ГБ | 80 ГБ | S, $39 на місяць |
| `skipbox-8x16` | 8 vCPU · 16 ГБ | 160 ГБ | M, $79 на місяць |
| `skipbox-16x32` | 16 vCPU · 32 ГБ | 320 ГБ | L, $149 на місяць |

`ubuntu-latest` приватного репозиторію має 2 CPU, 8 ГБ і 14 ГБ SSD. На Skipbox хвилини без обмежень. На 20 000 хвилинах на місяць на 4 vCPU GitHub виставляє $222; Skipbox S коштує $39, на $183 менше.

## Перехід — це один рядок

```yaml
jobs:
  test:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci && npm test
```

1. Увійдіть у Skipbox через GitHub.
2. Встановіть GitHub-застосунок Skipbox і виберіть репозиторії.
3. Змініть `runs-on` і зробіть push.

Кроки кешу лишіть як є. Другий запуск знайде кеші першого на машині.

## Безпека

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

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

## Спробуйте на завданні, кеш якого не влучає

Пробний період безкоштовний: 7 днів або 3 000 хв роботи завдань, залежно від того, що закінчиться раніше, і без картки. Перенесіть це завдання на `runs-on: skipbox`, запустіть двічі й порівняйте кроки відновлення та встановлення другого запуску з GitHub.

## Запитання й відповіді

### Який ліміт розміру кешу GitHub Actions?

За замовчуванням 10 ГБ на репозиторій, на всі гілки й workflow разом. Понад ліміт GitHub однаково зберігає новий запис і видаляє записи за часом останнього доступу, починаючи з найстаріших, доки репозиторій знову не вміститься в ліміт. Записи, які жодне завдання не читало 7 дн., видаляються незалежно від розміру. В обліковому записі Pro, Team або Enterprise адміністратори можуть підняти ліміт і кількість днів; сховище понад 10 ГБ оплачується по 0,07 USD за ГБ на місяць за піковим значенням кожної години, а коли досягнуто бюджету, кеш стає доступним лише для читання до наступного розрахункового періоду.

### Чому кеш GitHub Actions так часто витісняється?

Бо все в репозиторії ділить одні 10 ГБ: кожна гілка, кожен pull request, кожне завдання матриці й кожна ОС зберігають власні записи, а кеш Docker type=gha потрапляє туди ж. Коли збереження за день перевищують ліміт, кожне збереження видаляє старіший запис, і наступне завдання не знаходить потрібного. GitHub називає це cache thrashing. Щоб побачити, що його заповнює, виведіть записи за розміром (gh cache list --sort size_in_bytes).

### Чому відновлення кешу триває стільки ж, скільки встановлення з нуля?

Бо влучання — це однаково завантаження. Кожне завдання на хостованому ранері GitHub стартує на новій ВМ, тож actions/cache щоразу завантажує й розпаковує архів, і що більший кеш, то довше. Кеш setup-node повертає кеш завантажень менеджера пакетів, а не node_modules, тож npm ci після відновлення однаково встановлює кожен пакет. На ранері, що зберігає свій диск, кеші вже на місці й нічого не завантажується.

### Чому actions/cache не влучає в новій гілці?

Запуск може відновлювати кеші своєї гілки й гілки за замовчуванням, а запуск pull request — ще й базової гілки. Кеші сусідньої гілки він прочитати не може. Тож перший запуск гілки функції влучає, лише якщо гілка за замовчуванням зберегла цей ключ. Запускайте workflow на push у гілку за замовчуванням, щоб вона зберігала кеш, і додайте restore-keys для часткового збігу; cache-hit дорівнює true лише за точного збігу key.

### Скільки кешу Actions зберігає Skipbox?

Більше, ніж 10 ГБ на репозиторій у GitHub, і поряд із вашою машиною, а не в сховищі GitHub. На хмарній машині те, що завдання зберігають через actions/cache, setup-* і rust-cache, лишається на власному диску машини, до половини цього диска (80 ГБ на S, 160 ГБ на M, 320 ГБ на L); на хості Skipbox кеш хоста зберігає 20 ГБ на репозиторій. Так чи так, запис зберігається 7 дн. після останнього використання, з правилами гілок GitHub. Кеші пакетів і шари Docker через нього не проходять: вони лишаються просто на диску.

### Що очищує кеші на машині Skipbox?

Між завданнями — нічого: кеші лишаються на машині, і лише коли завдання лишає диск майже заповненим, першим іде те, чим найдовше не користувалися. Машина починає з чистого аркуша після скидання: коли ви натискаєте «Скинути машину», коли оновлюється її образ (щонайменше раз на місяць), коли вона не проходить перевірку стану після завдання і коли завдання досягає ліміту в 6 год. Коли тариф закінчується, машину видаляють разом із диском.

### Скільки коштує спробувати?

Нічого. Пробний період триває 7 днів або 3 000 хв роботи завдань, залежно від того, що закінчиться раніше, без картки. Перенесіть завдання, кеш якого не влучає або повільно відновлюється, на runs-on: skipbox, запустіть двічі й порівняйте кроки відновлення та встановлення другого запуску з GitHub.

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