Skipbox

Пришвидшіть монорепозиторій 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 на місяць із хвилинами без обмежень.

На що завдання монорепозиторію витрачає час

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, з наших запусків реальних проєктів:

Виділена машина зберегла .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. Завдання вибирає розмір міткою:

Хвилини без обмежень. На 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
  1. Увійдіть у Skipbox через GitHub.
  2. Встановіть GitHub-застосунок Skipbox і виберіть репозиторії.
  3. Змініть 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 р.

Швидший CI/CD із завжди прогрітим кешем

Ваш прогрітий ранер за фіксовану ціну

Хостинг наш. Ви змінюєте один рядок. 1/12 вартості GitHub за повного навантаження. Ціна фіксована, тож запускайте хоч цілий день. Місця для кешу в 7× більше, ніж у GitHub.

  • Без картки
  • Вхід через GitHub
  • Скасування будь-коли