# Ускорете монорепо с pnpm и Turborepo в GitHub Actions (astro: от 528 s до 30 s)

> В монорепо с pnpm и Turborepo в GitHub Actions по-голямата част от времето е pnpm install на нова VM и turbo, който изпълнява задачи, чиито резултати не са на нея. Изпълнявайте само засегнатите пакети, дайте на turbo кеш и пазете хранилището на pnpm. Или изпълнявайте на машина, която пази и двете: CI на astro падна от 528 s в GitHub до 30 s в Skipbox, за фиксирани $39 на месец.

В монорепо с 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 на месец с неограничени минути.

- CI на astro: 528 s в GitHub, 30 s в 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-bg)

## Къде задачата в монорепо харчи времето си

| Стъпка | На нова 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](https://turborepo.dev/docs/crafting-your-repository/constructing-ci): `turbo run build --affected` изпълнява задачи само в пакетите, променени спрямо базовия клон. В GitHub Actions той чете `GITHUB_BASE_REF` при pull request-и и `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 или самостоятелно хостван сървър). Всяко попадение е изтегляне от него.
- **`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](https://pnpm.io/continuous-integration) го казва направо: кеширането на хранилището не гарантира по-бързо инсталиране. В 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, с непроменен работен поток, от [нашите изпълнения на реални проекти](https://skipbox.dev/bg/guides/rust-cache-slow-rust-ci):

| | GitHub (публично хранилище, 4 vCPU, 16 GB) | Отделна машина в Skipbox (4 vCPU) |
|---|---|---|
| Задача | 528 s | **30 s** ([31 s](https://github.com/skipbox-dev/astro/actions/runs/43351547473), [28 s](https://github.com/skipbox-dev/astro/actions/runs/43351638436)) |
| Задачи на компилацията | 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 по-малко.

## Преминаването е един ред

```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. Инсталирайте приложението Skipbox в GitHub и изберете хранилищата.
3. Сменете `runs-on` и направете push.

Оставете стъпките за кеша както са; записаното от тях остава до машината.

## Сигурност

- Машината е само на вашия профил. Задачи на друга компания никога не се изпълняват на нея.
- След всяка задача идентификационните данни, процесите и контейнерите на рънъра се изтриват, както и идентификационните данни на git, hook-овете и непроследените файлове в пазеното работно копие. „Чиста VM за всяка задача“ дава вместо това на всяка задача нова машина.
- Код от хора без права за запис (например pull request-и от форкове) се изпълнява на нова VM, която чете кешовете ви, но не може да ги променя.

Подробностите са в [как са изолирани задачите](https://docs.skipbox.dev/bg/isolation).

## Изпробвайте го с монорепото

Пробният период е безплатен за 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.

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