Пришвидшіть монорепозиторій pnpm і Turborepo в GitHub Actions (astro: з 528 с до 30 с)
У монорепозиторії pnpm і Turborepo в GitHub Actions більшість повільного завдання — це два кроки: pnpm install на новій ВМ і turbo run build test, що виконує завдання, результатів яких на ВМ немає. Виправляйте їх у такому порядку. Запускайте лише пакети, яких торкається зміна (turbo run build --affected, з checkout, що має історію). Дайте turbo кеш, що переживає завдання, бо його результати живуть у .turbo/cache на машині, яку GitHub видаляє після кожного завдання: Remote Caching або .turbo, відновлений через actions/cache. І збережіть сховище pnpm. На ранерах GitHub кожен із цих кешів — завантаження в кожному завданні. На машині, що зберігає свій диск, вони просто є: завдання CI astro займало 528 с на GitHub і 30 с на виділеній машині Skipbox, яка відтворила всі 40 завдань збирання зі збереженого кешу turbo.
Skipbox запускає ваші завдання на виділеній машині вашого облікового запису, яка зберігає сховище pnpm, інструменти й .turbo в checkout між завданнями, без віддаленого кешу і без ключів кешу. Змініть один рядок, runs-on: skipbox, за фіксовані $39 на місяць із хвилинами без обмежень.
На що завдання монорепозиторію витрачає час
| Крок | На новій ВМ 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 requests і 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 або self-hosted сервер). Кожне влучання — це завантаження з нього. actions/cacheна.turbo. Ключ —${{ runner.os }}-turbo-${{ github.sha }}зrestore-keys: ${{ runner.os }}-turbo-. Він зберігає новий запис на кожному запуску, у межах 10 ГБ на репозиторій від 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 ГБ зі сховищем pnpm, шарами Docker і кешами кожної гілки; записи, якими не користувалися 7 дн., видаляються.- Більший ранер — це більший ранер у GitHub Team або Enterprise Cloud з похвилинною оплатою.
Коли рішення — машина, що зберігає свій диск
Власний CI astro, з незміненим workflow, з наших запусків реальних проєктів:
| GitHub (публічний репозиторій, 4 vCPU, 16 ГБ) | Виділена машина Skipbox (4 vCPU) | |
|---|---|---|
| Завдання | 528 с | 30 с (31 с, 28 с) |
| Завдання збирання | 40 виконано | 40 відтворено з кешу turbo |
| Завдання тестів | виконується | відтворено з кешу turbo |
Виділена машина зберегла .turbo в checkout і сховище pnpm з попереднього завдання, тож turbo знайшов результат кожного завдання, не завантажуючи нічого. turbo відтворює завдання, лише коли хеш його вхідних даних той самий, тож справжній коміт перезапускає пакети, яких торкається, і відтворює решту.
Skipbox зберігає стан монорепозиторію
Кожен тариф дає виділену машину вашого облікового запису, яка лишається між завданнями:
- Сховище pnpm лишається в
~/.local/share/pnpm/store, разом із кешем npm і~/.cacheкожного інструмента.pnpm installлінкує з диска замість завантаження. - Кеш turbo лишається.
.turboверхнього рівня в checkout зберігається між завданнями, колиturbo.jsonналежить turbo 2: ключtasks, безpipelineі без"envMode": "loose". ЖодногоTURBO_TOKEN, жодного кроку кешу. node_modulesвидаляється після кожного завдання, тож матриця версій Node зі спільним checkout ніколи не завантажує нативний аддон, зібраний для іншої Node.- Інструменти лишаються: версії Node, які встановив
setup-node, сам pnpm, образи й шари Docker.
Щонайменше в 7× більше місця для кешу, ніж у GitHub, уже на S. Завдання вибирає розмір міткою:
| Мітка | Машина | Тариф |
|---|---|---|
skipbox | 4 vCPU · 16 ГБ | S, $39 на місяць |
skipbox-8x16 | 8 vCPU · 16 ГБ | M, $79 на місяць |
skipbox-16x32 | 16 vCPU · 32 ГБ | 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.
- Встановіть GitHub-застосунок Skipbox і виберіть репозиторії.
- Змініть
runs-onі зробіть push.
Кроки кешу лишіть як є; те, що вони зберігають, лишається поряд із машиною.
Безпека
- Машина належить лише вашому обліковому запису. Завдання жодної іншої компанії на ній не працюють.
- Після кожного завдання стираються облікові дані ранера, процеси й контейнери, а також облікові дані git, хуки й невідстежувані файли в збереженому checkout. «Чиста ВМ для кожного завдання» натомість дає кожному завданню нову машину.
- Код від людей без права запису (наприклад, pull requests з форків) запускається на новій ВМ, яка читає ваші кеші, але не може їх змінити.
Подробиці — у розділі Як ізольовано завдання.
Спробуйте на монорепозиторії
Пробний період безкоштовний: 7 днів або 3 000 хв роботи завдань, залежно від того, що закінчиться раніше, і без картки. Перенесіть завдання збирання на runs-on: skipbox, запустіть двічі й порівняйте рядки встановлення і turbo другого запуску (cached проти executing) з GitHub.
Запитання й відповіді
Як пришвидшити великий монорепозиторій pnpm/Turborepo в GitHub Actions?
Три речі, по черзі. Запускайте лише те, що змінилося: turbo run build --affected, з checkout, що має історію (fetch-depth: 0 і filter: blob:none). Дайте turbo кеш, що переживає завдання: Remote Cache від Turborepo або .turbo, відновлений через actions/cache. І збережіть сховище pnpm: cache: pnpm у setup-node або actions/cache на шляху сховища. На нових ВМ GitHub кожне з цього — завантаження в кожному завданні; на машині, що зберігає свій диск, усе вже на місці. CI astro займав 528 с на GitHub і 30 с на виділеній машині Skipbox, яка зберігає кеш turbo і сховище pnpm.
Чому pnpm install повільний у GitHub Actions навіть із закешованим сховищем?
Бо відновлене сховище — це однаково архів, завантажений і розпакований на новій ВМ, а потім pnpm лінкує node_modules для кожного пакета робочого простору. Власна документація pnpm про CI каже, що кешування сховища не гарантує швидшого встановлення. Сховище, яке вже лежить на диску машини, пропускає завантаження; лишається тільки лінкування.
Чи працює кеш Turborepo в GitHub Actions?
Лише якщо кеш переживає завдання. Turborepo тримає результати завдань у .turbo/cache на машині, а машина завдання на хостованому ранері GitHub зникає, щойно воно закінчується. Тож CI потрібен Remote Caching (TURBO_TOKEN і TURBO_TEAM, від Vercel або self-hosted) чи крок actions/cache для .turbo. На виділеній машині Skipbox .turbo в checkout лишається між завданнями для проєктів turbo 2, тож turbo відтворює незмінені завдання без жодного віддаленого кешу.
Чи працює turbo --affected у GitHub Actions?
Так. Turborepo читає GITHUB_BASE_REF у pull requests і GITHUB_EVENT_PATH у push, щоб знайти базу для порівняння. Йому потрібна історія: з неглибоким клоном кожен пакет вважається зміненим. Задайте fetch-depth: 0 і filter: blob:none в actions/checkout.
Що Skipbox зберігає для монорепозиторію Turborepo?
Сховище pnpm, кеші npm і кожного інструмента, інструменти, які встановлює setup-node, шари Docker і checkout з його .turbo верхнього рівня, коли turbo.json належить turbo 2 (ключ tasks, без pipeline, не envMode loose). node_modules видаляється після кожного завдання, тож встановлення виконується — зі сховища на диску. turbo відтворює завдання, лише коли хеш його вхідних даних той самий, тож коміт перезапускає те, що він зачіпає.
Скільки коштує спробувати?
Нічого. Пробний період триває 7 днів або 3 000 хв роботи завдань, залежно від того, що закінчиться раніше, без картки. Перенесіть завдання збирання монорепозиторію на runs-on: skipbox, запустіть двічі й порівняйте кроки встановлення і turbo другого запуску з GitHub.
Оновлено 19 листопада 2026 р.