# سریع کردن یک monorepo با pnpm و Turborepo در GitHub Actions (astro: از 528 ثانیه به 30 ثانیه)

> در یک monorepo با pnpm و Turborepo روی GitHub Actions، بیشتر زمان صرف pnpm install روی یک ماشین مجازی تازه و اجرای تسک‌هایی توسط turbo می‌شود که نتیجه‌شان روی آن ماشین نیست. فقط پکیج‌های تأثیرپذیرفته را اجرا کنید، به turbo یک کش بدهید و store در pnpm را نگه دارید. یا روی ماشینی اجرا کنید که هر دو را نگه می‌دارد: CI در astro از 528 ثانیه روی GitHub به 30 ثانیه روی Skipbox رسید، با قیمت ثابت ماهانه $۳۹.

در یک monorepo با pnpm و Turborepo روی GitHub Actions، بیشتر یک جاب کند دو گام است: `pnpm install` روی یک ماشین مجازی تازه، و `turbo run build test` که تسک‌هایی را اجرا می‌کند که ماشین مجازی نتیجه‌شان را ندارد. به این ترتیب درستشان کنید. فقط پکیج‌هایی را اجرا کنید که یک تغییر لمسشان می‌کند (`turbo run build --affected`، با checkoutی که تاریخچه دارد). به turbo کشی بدهید که بعد از جاب بماند، چون نتایجش در `.turbo/cache` روی ماشینی است که GitHub بعد از هر جاب حذف می‌کند: Remote Caching، یا `.turbo` که با `actions/cache` بازگردانده شود. و store در pnpm را نگه دارید. روی رانرهای GitHub هر کدام از این کش‌ها در هر جاب یک دانلود است. روی ماشینی که دیسکش را نگه می‌دارد خیلی ساده آنجا هستند: جاب CI در astro روی GitHub‏ 528 ثانیه طول کشید و روی ماشین اختصاصی Skipbox‏ 30 ثانیه، که همه 40 تسک بیلد را از کش نگه‌داشته‌شده turbo بازپخش کرد.

Skipbox جاب‌های شما را روی ماشین اختصاصی حسابتان اجرا می‌کند، که store در pnpm، ابزارها و `.turbo` در checkout را بین جاب‌ها نگه می‌دارد، بدون کش راه دور و بدون کلید کش. یک خط را تغییر دهید، `runs-on: skipbox`، با قیمت ثابت ماهانه $۳۹ و دقیقه‌های نامحدود.

- CI در astro: روی GitHub‏ 528 ثانیه، روی Skipbox‏ 30 ثانیه، با بازپخش 40 تسک بیلد و تسک تست توسط turbo
- store در pnpm و `.turbo` در turbo روی ماشین شما می‌مانند: نه کش راه دوری برای راه‌اندازی، نه آرشیوی برای دانلود
- 20,000 دقیقه در ماه روی 4 vCPU: روی GitHub‏ $۲۲۲، روی Skipbox‏ $۳۹

**GitHub Actions با قیمت ثابت و دقیقه‌های نامحدود** Skipbox جاب‌های GitHub Actions شما را روی ماشین اختصاصی خودتان اجرا می‌کند: ماهانه $۳۹، هر چند دقیقه که اجرا کنید. لایه‌های Docker و کش وابستگی‌ها بین جاب‌ها می‌مانند، پس جاب بعدی فوراً شروع می‌شود.

رانری با چهار vCPU، ماهانه بیست هزار دقیقه: GitHub $۲۲۲ → Skipbox $۳۹. هر ماه $۱۸۳ صرفه‌جویی می‌کنید.

انتقال فقط یک خط است: `runs-on: skipbox`.

[شروع دوره آزمایشی رایگان ۷ روزه](https://app.skipbox.dev/sign-in?ref=g-pnpm-turborepo-monorepo-github-actions-fa)

## جاب monorepo زمانش را کجا صرف می‌کند

| گام | روی یک ماشین مجازی تازه GitHub |
|---|---|
| Checkout | به‌طور پیش‌فرض shallow clone؛ `--affected` تاریخچه لازم دارد، پس clone کامل |
| راه‌اندازی Node و pnpm | دانلود می‌شوند، مگر کش ابزارها آن نسخه را داشته باشد |
| `pnpm install` | store از آرشیو کش بازگردانده می‌شود (یا از registry دانلود می‌شود)، بعد `node_modules` برای هر پکیج لینک می‌شود |
| `turbo run build` | همه تسک‌ها اجرا می‌شوند، مگر `.turbo/cache` بازگردانده شده باشد یا یک کش راه دور جواب دهد |
| `turbo run test` | همان، روی 2 CPU در `ubuntu-latest` یک مخزن خصوصی |

## 1. فقط آنچه تغییر کرده را اجرا کنید

از [راهنمای CI در Turborepo](https://turborepo.dev/docs/crafting-your-repository/constructing-ci): `turbo run build --affected` فقط تسک‌های پکیج‌هایی را اجرا می‌کند که نسبت به شاخه پایه تغییر کرده‌اند. در GitHub Actions روی pull requestها `GITHUB_BASE_REF` و روی pushها `GITHUB_EVENT_PATH` را می‌خواند. با shallow clone هر پکیج تغییرکرده حساب می‌شود، پس تاریخچه را checkout کنید:

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

`turbo query affected --packages web` به یک جاب می‌گوید اصلاً اجرا شود یا نه، پس جاب یک اپ دست‌نخورده می‌تواند install خود را رد کند.

## 2. به turbo کشی بدهید که بعد از جاب بماند

Turborepo نتایج تسک‌ها را در `.turbo/cache` [روی ماشین](https://turborepo.dev/docs/crafting-your-repository/caching) ذخیره می‌کند. ماشین یک جاب میزبانی‌شده GitHub وقتی تمام شود حذف می‌شود، پس در CI آن کش هر بار خالی شروع می‌شود. دو راه برای دور زدنش، از [راهنمای GitHub Actions در Turborepo](https://turborepo.dev/docs/guides/ci-vendors/github-actions):

- **Remote Caching.** `TURBO_TOKEN` و `TURBO_TEAM` را تنظیم کنید (Remote Cache در Vercel، یا یک سرور خودمیزبان). هر hit یک دانلود از آن است.
- **`actions/cache` روی `.turbo`.** کلید را `${{ runner.os }}-turbo-${{ github.sha }}` بگذارید با `restore-keys: ${{ runner.os }}-turbo-`. در هر اجرا یک ورودی تازه ذخیره می‌کند، داخل ۱۰ GB‏ GitHub برای هر مخزن، همراه با هر چیز دیگری که مخزن کش می‌کند.

## 3. store در pnpm را نگه دارید

`actions/setup-node` با `cache: pnpm`، یا `actions/cache` روی `pnpm store path`، store را با کلیدی بر اساس `pnpm-lock.yaml` بازمی‌گرداند. `node_modules` را بازنمی‌گرداند، پس pnpm باز هم هر پکیج را لینک می‌کند. [مستندات CI در pnpm](https://pnpm.io/continuous-integration) صریح می‌گوید کش کردن store تضمین نمی‌کند نصب سریع‌تر شود. در CI، ‏pnpm خودش به `--frozen-lockfile` می‌رود.

## 4. از هسته‌ها استفاده کنید

turbo تسک‌های مستقل را موازی اجرا می‌کند و هر ابزار بیلد یا تست workerهای خودش را راه می‌اندازد، پس یک monorepo از هر هسته‌ای که بگیرد استفاده می‌کند. `ubuntu-latest` یک مخزن خصوصی 2 هسته دارد.

## هر راه حل روی رانرهای GitHub چه هزینه‌ای دارد

- **Remote Caching** یک سرویس دیگر و یک توکن دیگر است، و هر cache hit از شبکه عبور می‌کند.
- **`actions/cache` برای `.turbo`** در هر اجرا یک ورودی می‌نویسد و برای همان ۱۰ GB با store در pnpm، لایه‌های Docker و کش‌های هر شاخه رقابت می‌کند؛ ورودی‌هایی که ۷ روز استفاده نشوند حذف می‌شوند.
- **رانر بزرگ‌تر** یعنی larger runner در GitHub Team یا Enterprise Cloud، که دقیقه‌ای حساب می‌شود.

## وقتی راه حل ماشینی است که دیسکش را نگه می‌دارد

CI خود astro، با ورک‌فلوی بدون تغییر، از [اجراهای ما روی پروژه‌های واقعی](https://skipbox.dev/fa/guides/rust-cache-slow-rust-ci):

| | GitHub (مخزن عمومی، 4 vCPU، 16 GB) | ماشین اختصاصی 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 و store در pnpm را از جاب قبلی نگه داشته بود، پس turbo نتیجه هر تسک را بدون هیچ دانلودی پیدا کرد. turbo فقط وقتی یک تسک را بازپخش می‌کند که hash ورودی‌هایش یکسان باشد، پس یک commit واقعی پکیج‌هایی را که لمس می‌کند دوباره اجرا می‌کند و بقیه را بازپخش می‌کند.

## Skipbox وضعیت monorepo را نگه می‌دارد

هر طرح با ماشین اختصاصی حساب شما می‌آید که بین جاب‌ها نگه داشته می‌شود:

- **store در pnpm می‌ماند** در `~/.local/share/pnpm/store`، همراه با کش npm و `~/.cache` هر ابزار. `pnpm install` به‌جای دانلود از دیسک لینک می‌کند.
- **کش turbo می‌ماند.** `.turbo` سطح بالای checkout وقتی `turbo.json` مال turbo 2 باشد بین جاب‌ها نگه داشته می‌شود: کلید `tasks`، بدون `pipeline` و بدون `"envMode": "loose"`. نه `TURBO_TOKEN`، نه گام کش.
- **`node_modules` بعد از هر جاب حذف می‌شود**، پس یک matrix از نسخه‌های Node که یک checkout را شریک‌اند هرگز addon بومی‌ای را که برای Node دیگری بیلد شده بارگذاری نمی‌کند.
- **ابزارها می‌مانند:** نسخه‌های Node که `setup-node` نصب کرده، خود pnpm، ایمیج‌ها و لایه‌های Docker.

روی S دست‌کم ۷ برابر فضای کش GitHub. هر جاب اندازه‌اش را با لیبل انتخاب می‌کند:

| لیبل | ماشین | طرح |
|---|---|---|
| `skipbox` | ۴ vCPU · ۱۶ GB | S، ماهانه $۳۹ |
| `skipbox-8x16` | ۸ vCPU · ۱۶ GB | M، ماهانه $۷۹ |
| `skipbox-16x32` | ۱۶ vCPU · ۳۲ GB | L، ماهانه $۱۴۹ |

دقیقه‌ها نامحدودند. با 20,000 دقیقه در ماه روی 4 vCPU، ‏GitHub‏ $۲۲۲ می‌گیرد؛ Skipbox S‏ $۳۹ است، $۱۸۳ کمتر.

## انتقال یک خط است

```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. با GitHub وارد Skipbox شوید.
2. اپ Skipbox در GitHub را نصب کنید و مخزن‌ها را انتخاب کنید.
3. `runs-on` را تغییر دهید و push کنید.

گام‌های کش را همان‌طور که هستند نگه دارید؛ آنچه ذخیره می‌کنند کنار ماشین می‌ماند.

## امنیت

- ماشین فقط مال حساب شماست. جاب هیچ شرکت دیگری روی آن اجرا نمی‌شود.
- بعد از هر جاب، اعتبارنامه‌های رانر، پروسه‌ها و کانتینرها پاک می‌شوند، و همین‌طور اعتبارنامه‌های git، hookها و فایل‌های ردیابی‌نشده در checkout نگه‌داشته‌شده. گزینه «ماشین تازه برای هر جاب» به‌جای آن به هر جاب یک ماشین تازه می‌دهد.
- کد افرادی که دسترسی نوشتن ندارند (مثل pull requestها از forkها) روی یک ماشین مجازی تازه اجرا می‌شود که کش‌های شما را می‌خواند ولی نمی‌تواند تغییرشان دهد.

جزئیات در [جداسازی جاب‌ها](https://docs.skipbox.dev/fa/isolation) است.

## روی monorepo امتحانش کنید

دوره آزمایشی به مدت ۷ روز یا ۳٬۰۰۰ دقیقه جاب رایگان است، هر کدام زودتر برسد، و کارت نمی‌خواهد. جاب بیلد را به `runs-on: skipbox` ببرید، دو بار اجرایش کنید و خطوط install و turbo اجرای دوم (`cached` در برابر `executing`) را کنار خطوط GitHub بگذارید.

## پرسش‌های متداول

### چطور یک monorepo بزرگ pnpm/Turborepo را در GitHub Actions سریع کنم؟

سه کار، به ترتیب. فقط آنچه تغییر کرده را اجرا کنید: turbo run build --affected، با checkoutی که تاریخچه دارد (fetch-depth: 0 و filter: blob:none). به turbo کشی بدهید که بعد از جاب بماند: Remote Cache در Turborepo، یا .turbo که با actions/cache بازگردانده شود. و store در pnpm را نگه دارید: cache: pnpm در setup-node یا actions/cache روی مسیر store. روی ماشین‌های مجازی تازه GitHub هر کدام از این‌ها در هر جاب یک دانلود است؛ روی ماشینی که دیسکش را نگه می‌دارد از قبل آنجا هستند. CI در astro روی GitHub‏ 528 ثانیه طول کشید و روی ماشین اختصاصی Skipbox که کش turbo و store در pnpm را نگه می‌دارد 30 ثانیه.

### چرا pnpm install در GitHub Actions حتی با store کش‌شده کند است؟

چون store بازگردانده‌شده هنوز آرشیوی است که روی یک ماشین مجازی تازه دانلود و باز می‌شود، و بعد pnpm برای هر پکیج workspace پوشه node_modules را لینک می‌کند. مستندات CI خود pnpm می‌گوید کش کردن store تضمین نمی‌کند نصب سریع‌تر شود. storeی که از قبل روی دیسک ماشین باشد دانلود را رد می‌کند؛ فقط لینک کردن می‌ماند.

### کش 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 برای پیدا کردن پایه مقایسه، روی pull requestها GITHUB_BASE_REF و روی pushها GITHUB_EVENT_PATH را می‌خواند. به تاریخچه نیاز دارد: با shallow clone هر پکیج تغییرکرده حساب می‌شود. روی actions/checkout مقدار fetch-depth: 0 و filter: blob:none را تنظیم کنید.

### Skipbox برای یک monorepo با Turborepo چه چیزی را نگه می‌دارد؟

store در pnpm، کش npm و کش هر ابزار، ابزارهایی که setup-node نصب می‌کند، لایه‌های Docker، و checkout همراه با .turbo سطح بالای آن وقتی turbo.json مال turbo 2 باشد (کلید tasks، بدون pipeline، بدون envMode loose). node_modules بعد از هر جاب حذف می‌شود، پس install اجرا می‌شود، از store روی دیسک. turbo فقط وقتی یک تسک را بازپخش می‌کند که hash ورودی‌هایش یکسان باشد، پس یک commit آنچه را که لمس می‌کند دوباره اجرا می‌کند.

### امتحان کردنش چقدر هزینه دارد؟

هیچ. دوره آزمایشی ۷ روز یا ۳٬۰۰۰ دقیقه جاب است، هر کدام زودتر برسد، بدون کارت. جاب بیلد monorepo را به runs-on: skipbox ببرید، دو بار اجرایش کنید و گام‌های install و turbo اجرای دوم را با GitHub مقایسه کنید.

به‌روزرسانی: 2026-11-13 · https://skipbox.dev/fa/guides/pnpm-turborepo-monorepo-github-actions
