Ускорете монорепо с pnpm и Turborepo в GitHub Actions (astro: от 528 s до 30 s)
В монорепо с pnpm и Turborepo в GitHub Actions по-голямата част от бавната задача са две стъпки: pnpm install на нова VM и turbo run build test, който изпълнява задачи, чиито резултати VM няма. Оправете ги в този ред. Изпълнявайте само пакетите, които промяната засяга (turbo run build --affected, с работно копие, което има история). Дайте на turbo кеш, който надживява задачата, защото резултатите му живеят в .turbo/cache на машина, която GitHub изтрива след всяка задача: Remote Caching или .turbo, възстановен с actions/cache. И пазете хранилището на pnpm. На рънърите на GitHub всеки от тези кешове е изтегляне при всяка задача. На машина, която пази диска си, те просто са там: задачата в CI на astro отне 528 s в GitHub и 30 s на отделна машина в Skipbox, която възпроизведе всичките 40 задачи на компилацията от пазения кеш на turbo.
Skipbox изпълнява задачите ви на отделната машина на профила ви, която пази хранилището на pnpm, инструментите и .turbo на работното копие между задачите, без отдалечен кеш и без ключове за кеша. Сменете един ред, runs-on: skipbox, за фиксирани $39 на месец с неограничени минути.
Къде задачата в монорепо харчи времето си
| Стъпка | На нова VM в GitHub |
|---|---|
| Checkout | Плитко клониране по подразбиране; --affected се нуждае от история, така че пълно |
| Настройване на Node и pnpm | Изтеглят се, освен ако кешът на инструменти няма версията |
pnpm install | Хранилището се възстановява от архива на кеша (или се изтегля от регистъра), после node_modules се свързва за всеки пакет |
turbo run build | Всяка задача се изпълнява, освен ако .turbo/cache не е възстановен или отдалечен кеш не отговори |
turbo run test | Същото, на 2 CPU на ubuntu-latest в частно хранилище |
1. Изпълнявайте само промененото
От ръководството на Turborepo за CI: turbo run build --affected изпълнява задачи само в пакетите, променени спрямо базовия клон. В GitHub Actions той чете GITHUB_BASE_REF при pull request-и и GITHUB_EVENT_PATH при push-ове. При плитко клониране всеки пакет се брои за променен, така че изтеглете историята:
- uses: actions/checkout@v4
with:
fetch-depth: 0
filter: blob:none
turbo query affected --packages web казва на задачата дали изобщо да върви, така че задача за незасегнато приложение може да прескочи инсталирането си.
2. Дайте на turbo кеш, който надживява задачата
Turborepo съхранява резултатите от задачите в .turbo/cache на машината. Машината на задача, хоствана от GitHub, се изтрива, когато тя приключи, така че в CI този кеш всеки път започва празен. Два начина да се заобиколи, от ръководството на Turborepo за GitHub Actions:
- Remote Caching. Задайте
TURBO_TOKENиTURBO_TEAM(Vercel Remote Cache или самостоятелно хостван сървър). Всяко попадение е изтегляне от него. actions/cacheза.turbo. Ключ${{ runner.os }}-turbo-${{ github.sha }}сrestore-keys: ${{ runner.os }}-turbo-. Записва нов запис при всяко изпълнение, в рамките на 10-те GB на хранилище в GitHub заедно с всичко друго, което хранилището кешира.
3. Пазете хранилището на pnpm
actions/setup-node с cache: pnpm или actions/cache за pnpm store path възстановява хранилището с ключ по pnpm-lock.yaml. Не възстановява node_modules, така че pnpm пак свързва всеки пакет. Документацията на pnpm за CI го казва направо: кеширането на хранилището не гарантира по-бързо инсталиране. В CI pnpm сам превключва на --frozen-lockfile.
4. Използвайте ядрата
turbo изпълнява независимите задачи паралелно и всеки инструмент за компилация или тестове стартира собствени процеси, така че монорепото използва всяко ядро, което получи. ubuntu-latest в частно хранилище има 2.
Колко струва всяко решение на рънърите на GitHub
- Remote Caching е още една услуга и още един токен, а всяко попадение в кеша минава през мрежата.
actions/cacheза.turboзаписва запис при всяко изпълнение и се бори за същите 10 GB с хранилището на pnpm, слоевете на Docker и кешовете на всеки клон; записите, неизползвани 7 дни, изчезват.- По-голям рънър е по-голям рънър в GitHub Team или Enterprise Cloud, таксуван на минута.
Когато решението е машина, която пази диска си
Собственият CI на astro, с непроменен работен поток, от нашите изпълнения на реални проекти:
| GitHub (публично хранилище, 4 vCPU, 16 GB) | Отделна машина в Skipbox (4 vCPU) | |
|---|---|---|
| Задача | 528 s | 30 s (31 s, 28 s) |
| Задачи на компилацията | 40 изпълнени | 40 възпроизведени от кеша на turbo |
| Задача с тестовете | изпълнява се | възпроизведена от кеша на turbo |
Отделната машина е пазила .turbo на работното копие и хранилището на pnpm от предишната задача, така че turbo е намерил резултата на всяка задача, без нищо за изтегляне. turbo възпроизвежда задача само когато хешът на входовете ѝ е същият, така че реален commit изпълнява отново пакетите, които засяга, и възпроизвежда останалите.
Skipbox пази състоянието на монорепото
Всеки план идва с отделна машина за профила ви, пазена между задачите:
- Хранилището на pnpm остава в
~/.local/share/pnpm/store, с кеша на npm и~/.cacheна всеки инструмент.pnpm installсвързва от диска, вместо да изтегля. - Кешът на turbo остава.
.turboот най-горно ниво на работното копие се пази между задачите, когатоturbo.jsonе на turbo 2: ключtasks, безpipelineи без"envMode": "loose". БезTURBO_TOKEN, без стъпка за кеша. node_modulesсе изтрива след всяка задача, така че матрица по версии на Node, която дели едно работно копие, никога не зарежда native addon, компилиран за друга версия на Node.- Инструментите остават: версиите на Node, инсталирани от
setup-node, самият pnpm, образите и слоевете на Docker.
Поне 7× мястото за кеш в GitHub в S. Задачата избира размера си чрез етикета:
| Етикет | Машина | План |
|---|---|---|
skipbox | 4 vCPU · 16 GB | S, $39 на месец |
skipbox-8x16 | 8 vCPU · 16 GB | M, $79 на месец |
skipbox-16x32 | 16 vCPU · 32 GB | L, $149 на месец |
Минутите са неограничени. При 20 000 минути на месец на 4 vCPU GitHub таксува $222; Skipbox S е $39, с $183 по-малко.
Преминаването е един ред
jobs:
build:
runs-on: skipbox # was ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
filter: blob:none
- uses: pnpm/action-setup@v3
- uses: actions/setup-node@v4
with:
node-version: 22
cache: pnpm
- run: pnpm install
- run: pnpm turbo run build test --affected
- Влезте в Skipbox с GitHub.
- Инсталирайте приложението Skipbox в GitHub и изберете хранилищата.
- Сменете
runs-onи направете push.
Оставете стъпките за кеша както са; записаното от тях остава до машината.
Сигурност
- Машината е само на вашия профил. Задачи на друга компания никога не се изпълняват на нея.
- След всяка задача идентификационните данни, процесите и контейнерите на рънъра се изтриват, както и идентификационните данни на git, hook-овете и непроследените файлове в пазеното работно копие. „Чиста VM за всяка задача“ дава вместо това на всяка задача нова машина.
- Код от хора без права за запис (например pull request-и от форкове) се изпълнява на нова VM, която чете кешовете ви, но не може да ги променя.
Подробностите са в как са изолирани задачите.
Изпробвайте го с монорепото
Пробният период е безплатен за 7 дни или 3000 минути на задачи, което настъпи първо, и не изисква карта. Преместете задачата за компилация на runs-on: skipbox, пуснете я два пъти и сложете редовете за инсталиране и turbo от второто изпълнение (cached срещу executing) до тези в GitHub.
Често задавани въпроси
Как да ускоря голямо монорепо с pnpm/Turborepo в GitHub Actions?
Три неща, подред. Изпълнявайте само промененото: turbo run build --affected, с работно копие, което има история (fetch-depth: 0 и filter: blob:none). Дайте на turbo кеш, който надживява задачата: Remote Cache на Turborepo или .turbo, възстановен с actions/cache. И пазете хранилището на pnpm: cache: pnpm на setup-node или actions/cache за пътя на хранилището. На новите VM на GitHub всяко от тях е изтегляне при всяка задача; на машина, която пази диска си, те вече са там. CI на astro отне 528 s в GitHub и 30 s на отделна машина в Skipbox, която пази кеша на turbo и хранилището на pnpm.
Защо pnpm install е бавен в GitHub Actions дори с кеширано хранилище?
Защото възстановеното хранилище пак е архив, изтеглен и разархивиран на нова VM, а после pnpm свързва node_modules за всеки пакет от работното пространство. Собствената документация на pnpm за CI казва, че кеширането на хранилището не гарантира по-бързо инсталиране. Хранилище, което вече е на диска на машината, прескача изтеглянето; остава само свързването.
Работи ли кешът на Turborepo в GitHub Actions?
Само ако кешът надживее задачата. Turborepo пази резултатите от задачите в .turbo/cache на машината, а машината на задача, хоствана от GitHub, изчезва, когато тя приключи. Така CI се нуждае от Remote Caching (TURBO_TOKEN и TURBO_TEAM, на Vercel или самостоятелно хостван) или от стъпка с actions/cache за .turbo. На отделна машина в Skipbox .turbo на работното копие остава между задачите за проекти с turbo 2, така че turbo възпроизвежда непроменените задачи без отдалечен кеш.
Работи ли turbo --affected в GitHub Actions?
Да. Turborepo чете GITHUB_BASE_REF при pull request-и и GITHUB_EVENT_PATH при push-ове, за да намери базата за сравнение. Нуждае се от историята: при плитко клониране всеки пакет се брои за променен. Задайте fetch-depth: 0 и filter: blob:none в actions/checkout.
Какво пази Skipbox за монорепо с Turborepo?
Хранилището на pnpm, кешовете на npm и на всеки инструмент, инструментите, инсталирани от setup-node, слоевете на Docker и работното копие с .turbo от най-горно ниво, когато turbo.json е на turbo 2 (ключ tasks, без pipeline, без envMode loose). node_modules се изтрива след всяка задача, така че инсталирането върви, от хранилището на диска. turbo възпроизвежда задача само когато хешът на входовете ѝ е същият, така че commit изпълнява отново това, което засяга.
Колко струва да го изпробвам?
Нищо. Пробният период е 7 дни или 3000 минути на задачи, което настъпи първо, без карта. Преместете задачата за компилация на монорепото на runs-on: skipbox, пуснете я два пъти и сравнете стъпките за инсталиране и turbo от второто изпълнение с тези в GitHub.
Обновено на 19 ноември 2026 г.