# Пришвидшіть монорепозиторій pnpm і Turborepo в GitHub Actions (astro: з 528 с до 30 с)

> У монорепозиторії pnpm і Turborepo в GitHub Actions більшість часу забирають pnpm install на новій ВМ і turbo, що виконує завдання, результатів яких на ній немає. Запускайте лише зачеплені пакети, дайте turbo кеш і збережіть сховище pnpm. Або запускайте на машині, яка зберігає і те, і те: CI astro скоротився з 528 с на GitHub до 30 с на Skipbox, за фіксовані $39 на місяць.

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

- CI astro: 528 с на GitHub, 30 с на Skipbox, turbo відтворює 40 завдань збирання і завдання тестів
- Сховище pnpm і `.turbo` від turbo лишаються на вашій машині: жодного віддаленого кешу для налаштування, жодного архіву для завантаження
- 20 000 хвилин на місяць на 4 vCPU: $222 на GitHub, $39 на Skipbox

**GitHub Actions за фіксовану ціну, хвилини без обмежень** Skipbox запускає ваші завдання GitHub Actions на вашій власній виділеній машині: $39 на місяць, скільки б хвилин ви не використали. Шари Docker і кеші залежностей зберігаються між завданнями, тож наступне завдання стартує одразу.

Ранер на 4 vCPU, 20 000 хвилин на місяць: GitHub $222 → Skipbox $39. Ви заощаджуєте $183 щомісяця.

Достатньо змінити один рядок: `runs-on: skipbox`.

[Почати безкоштовний пробний період на 7 дн.](https://app.skipbox.dev/sign-in?ref=g-pnpm-turborepo-monorepo-github-actions-uk)

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

| Крок | На новій ВМ GitHub |
|---|---|
| Checkout | За замовчуванням неглибокий клон; `--affected` потребує історії, тож повний |
| Налаштування Node і pnpm | Завантажуються, якщо версії немає в кеші інструментів |
| `pnpm install` | Сховище відновлюється з архіву кешу (або завантажується з реєстру), потім `node_modules` лінкується для кожного пакета |
| `turbo run build` | Виконується кожне завдання, якщо не відновлено `.turbo/cache` і не відповідає віддалений кеш |
| `turbo run test` | Те саме, на 2 CPU на `ubuntu-latest` приватного репозиторію |

## 1. Запускайте лише те, що змінилося

З [посібника Turborepo про CI](https://turborepo.dev/docs/crafting-your-repository/constructing-ci): `turbo run build --affected` запускає завдання лише в пакетах, змінених відносно базової гілки. У GitHub Actions він читає `GITHUB_BASE_REF` у pull requests і `GITHUB_EVENT_PATH` у push. З неглибоким клоном кожен пакет вважається зміненим, тож завантажте історію:

```yaml
- uses: actions/checkout@v4
  with:
    fetch-depth: 0
    filter: blob:none
```

`turbo query affected --packages web` каже завданню, чи запускатися взагалі, тож завдання для незачепленого застосунку може пропустити встановлення.

## 2. Дайте turbo кеш, що переживає завдання

Turborepo зберігає результати завдань у `.turbo/cache` [на машині](https://turborepo.dev/docs/crafting-your-repository/caching). Машина завдання на хостованому ранері GitHub видаляється, щойно воно закінчується, тож у CI цей кеш щоразу стартує порожнім. Два обхідні шляхи з [посібника Turborepo для GitHub Actions](https://turborepo.dev/docs/guides/ci-vendors/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](https://pnpm.io/continuous-integration) каже прямо: кешування сховища не гарантує швидшого встановлення. У 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, з [наших запусків реальних проєктів](https://skipbox.dev/uk/guides/rust-cache-slow-rust-ci):

| | GitHub (публічний репозиторій, 4 vCPU, 16 ГБ) | Виділена машина Skipbox (4 vCPU) |
|---|---|---|
| Завдання | 528 с | **30 с** ([31 с](https://github.com/skipbox-dev/astro/actions/runs/43351547473), [28 с](https://github.com/skipbox-dev/astro/actions/runs/43351638436)) |
| Завдання збирання | 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 менше.

## Перехід — це один рядок

```yaml
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 з форків) запускається на новій ВМ, яка читає ваші кеші, але не може їх змінити.

Подробиці — у розділі [Як ізольовано завдання](https://docs.skipbox.dev/uk/isolation).

## Спробуйте на монорепозиторії

Пробний період безкоштовний: 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.

Оновлено 2026-11-19 · https://skipbox.dev/uk/guides/pnpm-turborepo-monorepo-github-actions
