سریع کردن یک monorepo با pnpm و Turborepo در GitHub Actions (astro: از 528 ثانیه به 30 ثانیه)
در یک 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، با قیمت ثابت ماهانه $۳۹ و دقیقههای نامحدود.
جاب 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: turbo run build --affected فقط تسکهای پکیجهایی را اجرا میکند که نسبت به شاخه پایه تغییر کردهاند. در GitHub Actions روی pull requestها GITHUB_BASE_REF و روی pushها GITHUB_EVENT_PATH را میخواند. با shallow clone هر پکیج تغییرکرده حساب میشود، پس تاریخچه را checkout کنید:
- uses: actions/checkout@v4
with:
fetch-depth: 0
filter: blob:none
turbo query affected --packages web به یک جاب میگوید اصلاً اجرا شود یا نه، پس جاب یک اپ دستنخورده میتواند install خود را رد کند.
2. به turbo کشی بدهید که بعد از جاب بماند
Turborepo نتایج تسکها را در .turbo/cache روی ماشین ذخیره میکند. ماشین یک جاب میزبانیشده GitHub وقتی تمام شود حذف میشود، پس در CI آن کش هر بار خالی شروع میشود. دو راه برای دور زدنش، از راهنمای GitHub Actions در Turborepo:
- 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 صریح میگوید کش کردن 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، با ورکفلوی بدون تغییر، از اجراهای ما روی پروژههای واقعی:
| GitHub (مخزن عمومی، 4 vCPU، 16 GB) | ماشین اختصاصی Skipbox (4 vCPU) | |
|---|---|---|
| جاب | 528 ثانیه | 30 ثانیه (31 ثانیه، 28 ثانیه) |
| تسکهای بیلد | 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 $۳۹ است، $۱۸۳ کمتر.
انتقال یک خط است
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
- با GitHub وارد Skipbox شوید.
- اپ Skipbox در GitHub را نصب کنید و مخزنها را انتخاب کنید.
runs-onرا تغییر دهید و push کنید.
گامهای کش را همانطور که هستند نگه دارید؛ آنچه ذخیره میکنند کنار ماشین میماند.
امنیت
- ماشین فقط مال حساب شماست. جاب هیچ شرکت دیگری روی آن اجرا نمیشود.
- بعد از هر جاب، اعتبارنامههای رانر، پروسهها و کانتینرها پاک میشوند، و همینطور اعتبارنامههای git، hookها و فایلهای ردیابینشده در checkout نگهداشتهشده. گزینه «ماشین تازه برای هر جاب» بهجای آن به هر جاب یک ماشین تازه میدهد.
- کد افرادی که دسترسی نوشتن ندارند (مثل pull requestها از forkها) روی یک ماشین مجازی تازه اجرا میشود که کشهای شما را میخواند ولی نمیتواند تغییرشان دهد.
جزئیات در جداسازی جابها است.
روی 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 مقایسه کنید.
بهروزرسانی: ۲۲ آبان ۱۴۰۵