Skipbox

Лимит на размера на кеша в GitHub Actions: защо кешът ви се изтрива, възстановява се бавно или се пропуска

GitHub Actions дава на всяко хранилище 10 GB кеш. Щом хранилището го надхвърли, GitHub пак записва новия запис и изтрива най-отдавна четените записи, докато не падне под лимита, а всеки запис, който никоя задача не е чела 7 дни, се изтрива. Клонът чете само собствените си кешове и тези на клона по подразбиране, така че първото изпълнение на нов клон често пропуска. А попадението пак е изтегляне: всяка задача на рънър, хостван от GitHub, започва на нова VM, така че изтегля и разархивира архива отново. Можете да увеличите лимита, по $0,07 за GB на месец над 10 GB, и да настроите ключовете си, но изтеглянето остава.

Skipbox маха изтеглянето. Задачите ви се изпълняват на отделната машина на профила ви, която се пази между задачите, така че кешовете на npm, pnpm, Gradle, Go и Cargo и слоевете на Docker още са на диска ѝ от предишната задача (80 GB в S срещу 14 GB на рънъра на GitHub). Записаното от actions/cache остава до машината, така че възстановяването е локално четене. Сменете един ред, runs-on: skipbox, за фиксирани $39 на месец с неограничени минути.

Правилата на GitHub за кеша

От справочника на GitHub за кеширане на зависимости, таксуването на Actions и changelog-а му за кешове над 10 GB:

Защо кешът се изтрива

Едни 10 GB побират всичко, което хранилището записва. Всеки клон и всеки pull request записва собствени записи. Матрица от три версии на Node на две операционни системи записва шест. Кешът на компилацията type=gha на Docker отива в същите 10 GB. Когато записите за един ден надхвърлят лимита, всяко ново записване изтрива по-стар запис, често този, който ѝ трябва на следващата задача. GitHub нарича това cache thrashing.

За да видите какво го пълни, изброете записите по размер:

gh cache list --sort size_in_bytes --limit 20

Страницата Actions › Caches на хранилището показва същото, с клона и последното използване на всеки запис.

Защо възстановяването е бавно

Попадение в кеша на рънър, хостван от GitHub, е изтегляне на нова VM и после разархивиране. Времето му расте с архива, така че кеш, който е пораснал до няколко GB, може да отнеме колкото инсталирането, което е трябвало да спести. Блокирало изтегляне се прекъсва от таймаута за сегмент на actions/cache, по подразбиране 10 минути (SEGMENT_DOWNLOAD_TIMEOUT_MINS).

Повечето настройки и възстановяват по-малко, отколкото се смята. Входът cache: на setup-node записва кеша за изтегляния на пакетния мениджър, не node_modules: след възстановяването npm ci пак инсталира всеки пакет. Кешът на pip в setup-python е същият: изтеглянията се връщат, средата се инсталира отново.

Защо кешът се пропуска

  • Ключът се е променил. Ключ с hashFiles('**/package-lock.json') пропуска при всяка промяна на lockfile-а. restore-keys дава частично съвпадение и тогава cache-hit е false.
  • Нов клон. Той може да чете кешовете на клона по подразбиране, не на друг клон за функционалност. Ако клонът по подразбиране никога не е пускал работния поток, няма какво да се чете.
  • Изтрит е. Лимитът или 7-те дни са го взели.
  • Никога не е записан. Записите не могат да се променят, така че съществуващ ключ никога не се записва отново и кешираното съдържание остава толкова старо, колкото първото му записване. Pull request от форк може изобщо да няма право да записва.

Предаването на файлове на следващата задача от същото изпълнение е друг инструмент. Кешът е за следващото изпълнение; резултат от компилацията, нужен на по-късна задача от същия работен поток, минава през actions/upload-artifact и actions/download-artifact. Артефактите имат собствено хранилище, отделно от 10-те GB, и също са изтегляне на нова VM.

Колко струва всяко решение на рънърите на GitHub

  • Увеличете лимита. По-малко изтривания, по $0,07 за GB на месец над 10 GB (собственият пример на GitHub: изцяло използвани 200 GB са $13,30 на месец), в профил Pro, Team или Enterprise. Възстановяванията остават изтегляния, а по-големите кешове се изтеглят по-дълго.
  • Записвайте по-малко. Кеширайте ~/.npm или хранилището на pnpm, не node_modules или резултата от компилацията. Записвайте само в клона по подразбиране, с actions/cache/restore във всяка задача и actions/cache/save в една. Това струва вашето време, а по-малкият кеш възстановява по-малко.
  • Оправете ключовете. Използвайте lockfile-а за ключ, добавете restore-keys и пускайте работния поток при push в клона по подразбиране, за да има какво да четат новите клонове.
  • Самостоятелно хостван рънър, който пази диска си. Без изтегляне, без 10 GB. Вие поддържате машината: обновявания на ОС, почистване между задачите без изтриване на кешовете и поправяне, когато се счупи.

Когато решението е машина, която пази диска си

Кешът съществува, защото машината забравя. Рънърът, хостван от GitHub, е нова VM за всяка задача, така че задачата записва състоянието си в хранилището на GitHub и го изтегля обратно следващия път. На машина, която остава, това състояние вече е на диска ѝ: кешът на пакетния мениджър, кешът на инструменти, Docker образите и кешът на компилацията, дори резултатът от компилацията.

Разликата се вижда в CI на реални проекти, от нашите изпълнения на собствените им задачи:

  • astro (Node.js, Turborepo): 528 s в GitHub, 30 s на отделна машина в Skipbox, която пази кеша на turbo, така че затоплените ѝ изпълнения възпроизвеждат 40 задачи на компилацията, вместо да ги изпълняват.
  • helix (Rust): стъпката за toolchain и кеш отне 9–10 s на отделната машина срещу 41–46 s в GitHub.
  • tauri (Rust): 246 s в GitHub, 53 s на отделната машина, с target/, пазен между задачите.

Skipbox пази кеша на машината ви

Всеки план идва с отделна машина за профила ви, пазена между задачите:

  • Кешовете на пакетите остават на диска: ~/.npm, хранилището на pnpm, ~/.cache на всеки инструмент и кешовете на Go, Gradle, Cargo и Maven, с инструментите, инсталирани от setup-*. Няма какво да се възстановява.
  • Образите, слоевете и кешът на компилацията на Docker също остават. docker build използва отново слоевете от предишната компилация (кеш на Docker слоеве).
  • **actions/cache, setup-* и rust-cache не се нуждаят от промяна.** Записаното от тях остава до машината вместо в хранилището на GitHub, с повече място от 10-те GB на хранилище в GitHub, а възстановяването го чете локално.
  • Без изтичане след 7 дни на диска. Нищо не се изтрива, докато дискът не е почти пълен след задача; тогава първо отива най-отдавна използваното.

Поне 7× мястото за кеш в GitHub в S. Задачата избира размера си чрез етикета:

ubuntu-latest в частно хранилище има 2 CPU, 8 GB и 14 GB 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. Инсталирайте приложението Skipbox в GitHub и изберете хранилищата.
  3. Сменете runs-on и направете push.

Оставете стъпките за кеша както са. Второто изпълнение намира кешовете от първото на машината.

Сигурност

  • Машината е само на вашия профил. Задачи на друга компания никога не се изпълняват на нея.
  • След всяка задача идентификационните данни, процесите и контейнерите на рънъра се изтриват. „Чиста VM за всяка задача“ дава вместо това на всяка задача нова машина.
  • Код от хора без права за запис (например pull request-и от форкове) се изпълнява на нова VM, която чете кешовете ви, но не може да ги променя.

Подробностите са в как са изолирани задачите.

Изпробвайте го със задачата, чийто кеш се пропуска

Пробният период е безплатен за 7 дни или 3000 минути на задачи, което настъпи първо, и не изисква карта. Преместете тази задача на runs-on: skipbox, пуснете я два пъти и сложете стъпките за възстановяване и инсталиране от второто изпълнение до тези в GitHub.

Често задавани въпроси

Какъв е лимитът на размера на кеша в GitHub Actions?

10 GB на хранилище по подразбиране, за всички клонове и работни потоци заедно. Над него GitHub пак записва новия запис и изтрива записи по ред на последен достъп, от най-стария, докато хранилището не падне под лимита. Записите, които никоя задача не е чела 7 дни, се изтриват независимо от размера. В профил Pro, Team или Enterprise администраторите могат да увеличат лимита и дните; съхранението над 10 GB се таксува по $0,07 за GB на месец, измерено по пика на всеки час, а щом се достигне бюджет, кешът става само за четене до следващия период на таксуване.

Защо кешът ми в GitHub Actions се изтрива толкова често?

Защото всичко в хранилището дели едни 10 GB: всеки клон, всеки pull request, всяка задача от матрицата и всяка ОС записва собствени записи, а кешът type=gha на Docker отива на същото място. Когато записите за един ден надхвърлят лимита, всяко записване изтрива по-стар запис и следващата задача пропуска този, който ѝ е трябвал. GitHub нарича това cache thrashing. Изброете записите по размер (gh cache list --sort size_in_bytes), за да видите какво го пълни.

Защо възстановяването на кеша отнема колкото инсталирането от нулата?

Защото попадението пак е изтегляне. Всяка задача на рънър, хостван от GitHub, започва на нова VM, така че actions/cache изтегля архива и го разархивира всеки път, и колкото по-голям е кешът, толкова по-дълго отнема. Кешът на setup-node връща кеша за изтегляния на пакетния мениджър, не node_modules, така че npm ci пак инсталира всеки пакет след възстановяването. На рънър, който пази диска си, кешовете вече са там и нищо не се изтегля.

Защо actions/cache пропуска на нов клон?

Изпълнението може да възстановява кешове от собствения си клон и от клона по подразбиране, а изпълнението на pull request – и от базовия му клон. Не може да чете кешовете на съседен клон. Така първото изпълнение на клон за функционалност попада само ако клонът по подразбиране е записал този ключ. Пускайте работния поток при push в клона по подразбиране, за да записва, и добавете restore-keys за частично съвпадение; cache-hit е true само при точно съвпадение на key.

Колко кеш на Actions пази Skipbox?

Повече от 10-те GB на хранилище в GitHub, до машината ви вместо в хранилището на GitHub. На облачна машина записаното от задачите с actions/cache, setup-* и rust-cache остава на собствения диск на машината, до половината от този диск (80 GB в S, 160 GB в M, 320 GB в L); на хост на Skipbox кешът на хоста пази по 20 GB на хранилище. И в двата случая записът се пази 7 дни след последното използване, с правилата за клонове на GitHub. Кешовете на пакетите и слоевете на Docker не минават през него: те остават на самия диск.

Какво изчиства кешовете на машина в Skipbox?

Нищо между задачите: кешовете остават на машината и само когато задача остави диска почти пълен, първо отива най-отдавна използваното. Машината започва чиста при нулиране: когато натиснете Нулиране на машината, когато образът ѝ се обнови (поне веднъж месечно), когато не премине проверката на състоянието след задача и когато задача стигне лимита от 6 часа. Когато планът приключи, машината се изтрива с диска си.

Колко струва да го изпробвам?

Нищо. Пробният период е 7 дни или 3000 минути на задачи, което настъпи първо, без карта. Преместете задачата, чийто кеш се пропуска или възстановява бавно, на runs-on: skipbox, пуснете я два пъти и сравнете стъпките за възстановяване и инсталиране от второто изпълнение с тези в GitHub.

Обновено на 19 ноември 2026 г.

По-бърз CI/CD с винаги топъл кеш

Вашият топъл рънър на фиксирана цена

Ние ги хостваме. Вие променяте един ред. 1/12 от цената на GitHub при пълно натоварване. Цената е фиксирана, затова пускайте задачи по цял ден. 7× повече място за кеш от GitHub.

  • Без карта
  • Вход с GitHub
  • Прекратяване по всяко време