Skipbox

Лимит размера кэша GitHub Actions: почему кэш вытесняется, медленно восстанавливается или промахивается

GitHub Actions даёт каждому репозиторию 10 ГБ кэша. Когда репозиторий выходит за этот объём, GitHub всё равно сохраняет новую запись и удаляет записи, которые читали давнее всего, пока не уложится в лимит, а ещё удаляет любую запись, которую ни одно задание не читало 7 дн. Ветка читает только свои кэши и кэши ветки по умолчанию, поэтому первый запуск новой ветки часто промахивается. А попадание — это всё равно скачивание: каждое задание на раннере GitHub начинается на новой ВМ, поэтому снова скачивает и распаковывает архив. Лимит можно поднять — по $0,07 за ГБ в месяц сверх 10 ГБ — и настроить ключи, но скачивание остаётся.

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

Правила кэша GitHub

Из справочника GitHub по кэшированию зависимостей, оплаты Actions и его changelog о кэшах больше 10 ГБ (всё на английском):

Почему кэш вытесняется

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

Чтобы увидеть, что его заполняет, выведите записи по размеру:

gh cache list --sort size_in_bytes --limit 20

Страница Actions › Caches репозитория показывает то же самое, с веткой и последним использованием каждой записи.

Почему восстановление медленное

Попадание кэша на раннере GitHub — это скачивание на новую ВМ, а затем распаковка. Его время растёт с архивом, поэтому кэш, разросшийся до нескольких ГБ, может занимать столько же, сколько установка, которую он должен был пропустить. Зависшее скачивание обрывается по таймауту сегмента actions/cache — по умолчанию 10 минут (SEGMENT_DOWNLOAD_TIMEOUT_MINS).

Большинство настроек к тому же восстанавливают меньше, чем думают. Параметр cache: у setup-node сохраняет кэш скачиваний менеджера пакетов, а не node_modules: после восстановления npm ci всё равно ставит каждый пакет. С кэшем pip у setup-python то же самое: скачанное возвращается, окружение ставится заново.

Почему кэш промахивается

  • Изменился ключ. Ключ с hashFiles('**/package-lock.json') промахивается при каждом изменении lock-файла. restore-keys дают частичное совпадение, и тогда cache-hit равен false.
  • Новая ветка. Она может читать кэши ветки по умолчанию, но не другой feature-ветки. Если на ветке по умолчанию workflow ни разу не запускался, читать нечего.
  • Вытеснен. Его забрал лимит или 7 дн.
  • Так и не сохранился. Записи не изменяются, поэтому существующий ключ больше не сохраняется, и содержимое кэша остаётся таким же старым, как при первом сохранении. Pull request из форка может вообще не иметь права сохранять.

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

Чего стоит каждое исправление на раннерах GitHub

  • Поднять лимит. Меньше вытеснений, по $0,07 за ГБ в месяц сверх 10 ГБ (собственный пример GitHub: полностью занятые 200 ГБ — $13,30 в месяц), на аккаунте 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 реальных проектов, из наших запусков их собственных заданий:

  • 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).
  • **actions/cache, setup-* и rust-cache менять не нужно.** То, что они сохраняют, остаётся рядом с машиной, а не в хранилище GitHub, места больше, чем 10 ГБ GitHub на репозиторий, а восстановление читает его локально.
  • На диске нет срока в 7 дн. Ничего не удаляется, пока после задания диск почти не заполнится; тогда первым уходит то, что использовали давнее всего.

На S места под кэш минимум в 7× больше, чем у GitHub. Задание выбирает размер меткой:

У ubuntu-latest в приватном репозитории 2 CPU, 8 ГБ и 14 ГБ SSD. В Skipbox минуты не ограничены. При 20 000 минут в месяц на 4 vCPU GitHub выставляет $222; Skipbox S стоит $39 — на $183 меньше.

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

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 App Skipbox и выберите репозитории.
  3. Измените runs-on и сделайте push.

Шаги кэша оставьте как есть. Второй запуск найдёт кэши первого на машине.

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

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

Подробности — в разделе «Как изолированы задания».

Попробуйте на задании, у которого кэш промахивается

Пробный период бесплатный и без карты: 7 дней или 3 000 мин работы заданий — что закончится раньше. Перенесите это задание на runs-on: skipbox, запустите его дважды и положите шаги восстановления и установки второго запуска рядом с GitHub.

Вопросы и ответы

Какой лимит размера кэша в GitHub Actions?

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

Почему кэш 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 — ещё и своей базовой ветки. Кэши соседней ветки он читать не может. Поэтому первый запуск feature-ветки попадает, только если ветка по умолчанию сохранила этот ключ. Запускайте 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.

Обновлено 19 ноября 2026 г.

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

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

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

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