تسريع مستودع أحادي بـ pnpm وTurborepo في GitHub Actions (astro: من 528 ثانية إلى 30 ثانية)
في مستودع أحادي بـ pnpm وTurborepo على GitHub Actions، معظم المهمة البطيئة خطوتان: pnpm install على جهاز افتراضي جديد، وturbo run build test يشغّل مهامًا لا يملك الجهاز الافتراضي نتائجها. أصلحهما بهذا الترتيب. شغّل فقط الحزم التي يمسّها التغيير (turbo run build --affected، مع نسخة مسحوبة فيها السجل). وامنح turbo ذاكرة تخزين مؤقت تعيش بعد المهمة، لأن نتائجه تعيش في .turbo/cache على جهاز يحذفه GitHub بعد كل مهمة: Remote Caching، أو .turbo مستعادًا بـ actions/cache. واحتفظ بمخزن pnpm. وعلى مشغّلات GitHub كل واحدة من ذاكرات التخزين المؤقت هذه تنزيل في كل مهمة. أما على جهاز يحتفظ بقرصه فهي ببساطة موجودة: استغرقت مهمة CI في astro 528 ثانية على GitHub و30 ثانية على جهاز Skipbox مخصّص، أعاد مهام البناء الـ 40 كلها من ذاكرة turbo المحفوظة.
يشغّل Skipbox مهامك على جهاز يستضيفه لحسابك وحده، يحتفظ بمخزن pnpm والأدوات و.turbo الخاص بنسخة الكود المسحوبة بين المهام، دون ذاكرة تخزين مؤقت بعيدة ودون مفاتيح تخزين مؤقت. غيّر سطرًا واحدًا، runs-on: skipbox، بسعر ثابت قدره $39 شهريًا مع دقائق غير محدودة.
أين تقضي مهمة المستودع الأحادي وقتها
| الخطوة | على جهاز GitHub افتراضي جديد |
|---|---|
| سحب الكود | نسخ سطحي افتراضيًا؛ و--affected يحتاج إلى السجل، فنسخ كامل |
| إعداد Node وpnpm | يُنزَّلان، ما لم يكن الإصدار في ذاكرة الأدوات |
pnpm install | المخزن مستعاد من أرشيف ذاكرة التخزين المؤقت (أو مُنزَّل من السجل)، ثم node_modules مربوط لكل حزمة |
turbo run build | كل مهمة تعمل، ما لم يُستعَد .turbo/cache أو تُجِب ذاكرة تخزين مؤقت بعيدة |
turbo run test | الشيء نفسه، على 2 CPU في ubuntu-latest على مستودع خاص |
1. شغّل ما تغيّر فقط
من دليل CI في Turborepo: turbo run build --affected لا يشغّل المهام إلا في الحزم التي تغيّرت مقارنةً بالفرع الأساسي. وفي GitHub Actions يقرأ GITHUB_BASE_REF في طلبات السحب وGITHUB_EVENT_PATH عند الدفع. ومع نسخ سطحي تُعدّ كل حزمة متغيرة، فاسحب السجل:
- uses: actions/checkout@v4
with:
fetch-depth: 0
filter: blob:none
وturbo query affected --packages web يخبر المهمة هل تعمل أصلًا، فتتخطى مهمة لتطبيق لم يُمسّ تثبيتها.
2. امنح turbo ذاكرة تخزين مؤقت تعيش بعد المهمة
يخزّن Turborepo نتائج المهام في .turbo/cache على الجهاز. وجهاز المهمة المستضافة على GitHub يُحذف حين تنتهي، فتبدأ تلك الذاكرة فارغة في كل مرة في CI. وهناك طريقتان للالتفاف على ذلك، من دليل GitHub Actions في Turborepo:
- 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 يربط كل حزمة. وتقولها وثائق CI في pnpm بوضوح: تخزين المخزن مؤقتًا لا يضمن تثبيتًا أسرع. وفي CI ينتقل pnpm إلى --frozen-lockfile من تلقاء نفسه.
4. استخدم الأنوية
يشغّل turbo المهام المستقلة بالتوازي، وكل أداة بناء أو اختبار تبدأ عمّالها الخاصين، فيستخدم المستودع الأحادي كل نواة يحصل عليها. وفي ubuntu-latest على مستودع خاص نواتان.
ما يكلّفه كل حل على مشغّلات GitHub
- Remote Caching خدمة أخرى ورمز وصول آخر، وكل إصابة تعبر الشبكة.
actions/cacheلـ.turboيكتب إدخالًا في كل تشغيل وينافس على الـ 10 GB نفسها مع مخزن pnpm وطبقات Docker وذاكرة كل فرع المؤقتة؛ والإدخالات غير المستخدمة 7 أيام تذهب.- مشغّل أكبر هو مشغّل أكبر على GitHub Team أو Enterprise Cloud، بالفوترة بالدقيقة.
حين يكون الحل جهازًا يحتفظ بقرصه
CI الخاص بـ astro نفسه، دون تغيير في سير عمله، من تشغيلنا لمشاريع حقيقية:
| GitHub (مستودع عام، 4 vCPU، 16 GB) | جهاز Skipbox مخصّص (4 vCPU) | |
|---|---|---|
| المهمة | 528 ثانية | 30 ثانية (31 ثانية، 28 ثانية) |
| مهام البناء | 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.
الانتقال سطر واحد
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
- سجّل الدخول إلى Skipbox باستخدام GitHub.
- ثبّت تطبيق Skipbox على GitHub واختر المستودعات.
- غيّر
runs-onثم ادفع التغيير.
أبقِ خطوات التخزين المؤقت كما هي؛ فما تحفظه يبقى بجوار الجهاز.
الأمان
- الجهاز لحسابك وحده، ولا تعمل عليه مهام أي شركة أخرى.
- بعد كل مهمة، تُمسح بيانات اعتماد المشغّل وعملياته وحاوياته، وكذلك بيانات اعتماد git والـ hooks والملفات غير المتتبَّعة في نسخة الكود المحفوظة. ويمنح خيار «مهمة نظيفة في كل مرة» كل مهمة جهازًا جديدًا بدلًا من ذلك.
- الكود الوارد من أشخاص ليس لديهم صلاحية الكتابة (مثل طلبات السحب من النسخ المتفرعة) يعمل على جهاز افتراضي جديد يقرأ ذاكرتك المؤقتة لكنه لا يستطيع تغييرها.
التفاصيل في كيف تُعزل المهام.
جرّبه على المستودع الأحادي
الفترة التجريبية مجانية لمدة 7 أيام أو 3,000 دقيقة من وقت المهام، أيهما يأتي أولًا، ولا تتطلب بطاقة. انقل مهمة البناء إلى 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 على مسار المخزن. وعلى الأجهزة الافتراضية الجديدة في GitHub كل واحد منها تنزيل في كل مهمة؛ وعلى جهاز يحتفظ بقرصه تكون موجودة أصلًا. استغرق CI في astro 528 ثانية على GitHub و30 ثانية على جهاز Skipbox مخصّص يحتفظ بذاكرة turbo المؤقتة ومخزن pnpm.
لماذا يبطؤ pnpm install في GitHub Actions حتى مع تخزين المخزن مؤقتًا؟
لأن المخزن المستعاد ما زال أرشيفًا يُنزَّل ويُفك على جهاز افتراضي جديد، ثم يربط pnpm node_modules لكل حزمة في مساحة العمل. وتقول وثائق CI في pnpm نفسها إن تخزين المخزن مؤقتًا لا يضمن تثبيتًا أسرع. أما المخزن الموجود أصلًا على قرص الجهاز فيتخطى التنزيل؛ ولا يبقى إلا الربط.
هل تعمل ذاكرة 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 في طلبات السحب، وGITHUB_EVENT_PATH عند الدفع، ليجد الأساس الذي يقارن به. ويحتاج إلى السجل: مع نسخ سطحي تُعدّ كل حزمة متغيرة. اضبط 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 أيام أو 3,000 دقيقة من وقت المهام، أيهما يأتي أولًا، دون بطاقة. انقل مهمة البناء في المستودع الأحادي إلى runs-on: skipbox، وشغّلها مرتين، وقارن خطوتي التثبيت وturbo في التشغيل الثاني بما في GitHub.
آخر تحديث: 19 نوفمبر 2026