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 request и GITHUB_EVENT_PATH при push. При неглубоком клоне каждый пакет считается изменённым, поэтому делайте checkout с историей:

- 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 ГБ 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.

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

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

Шаги кэширования оставьте как есть; то, что они сохраняют, остаётся рядом с машиной.

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

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

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

Попробуйте на монорепозитории

Пробный период бесплатный и без карты: 7 дней или 3 000 мин работы заданий — что закончится раньше. Перенесите задание сборки на runs-on: skipbox, запустите его дважды и положите строки install и 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 для каждого пакета workspace. Собственная документация pnpm по CI говорит, что кэширование хранилища не гарантирует ускорения установки. Хранилище, которое уже лежит на диске машины, обходится без скачивания; остаётся только связывание.

Работает ли кэш Turborepo в GitHub Actions?

Только если кэш переживает задание. Turborepo хранит результаты задач в .turbo/cache на машине, а машина задания на раннере GitHub исчезает, когда оно заканчивается. Поэтому CI нужен Remote Caching (TURBO_TOKEN и TURBO_TEAM, от Vercel или свой) или шаг actions/cache для .turbo. На выделенной машине Skipbox .turbo в checkout сохраняется между заданиями для проектов на 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 и checkout с его верхнеуровневой .turbo, когда turbo.json от turbo 2 (есть ключ tasks, нет pipeline и нет envMode loose). node_modules удаляется после каждого задания, поэтому install выполняется — из хранилища на диске. turbo воспроизводит задачу, только когда хэш её входных данных совпадает, поэтому коммит перезапускает то, что затрагивает.

Сколько стоит попробовать?

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

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

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

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

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

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