# اختبارات Cypress وPlaywright المتقطعة على GitHub Actions: حين يكون المشغّل هو السبب

> اختبارات E2E التي تنجح محليًا وتتقطع على GitHub Actions كثيرًا ما تكون محرومة من الموارد: يتشارك Cypress والمتصفح وتطبيقك وقاعدة بياناته 2 CPU و8 GB في مستودع خاص. وتقول وثائق Cypress إن الحرمان من الموارد يظهر في صورة إخفاقات متقطعة أو بطيئة أو عشوائية. كيف تتأكد منه، وما تصلحه في الاختبارات، ولماذا يكلّف التقسيم دقائق، ومشغّل بـ 8 vCPU و16 GB بسعر ثابت قدره $79 شهريًا.

اختبارات النهاية إلى النهاية التي تنجح على حاسوبك المحمول وتتقطع على GitHub Actions كثيرًا ما تكون محرومة من الموارد، لا معطوبة. على `ubuntu-latest` في مستودع خاص، يتشارك Cypress أو Playwright، ومتصفح، وخادم تطبيقك، وقاعدة بياناته 2 CPU و8 GB، فتُعرض الصفحات متأخرة، أو يتجاوز أمر مهلته (4 ثوانٍ افتراضيًا في Cypress)، أو ينهار المتصفح في منتصف التشغيل. وتقول وثائق Cypress نفسها إن الحرمان من الموارد يظهر في صورة إخفاقات متقطعة أو بطيئة أو تبدو عشوائية، وإن تطبيقها النموذجي يعمل براحة على 4 vCPU و16 GB، أي ضعف المشغّل الخاص. تأكد من ذلك بمراقبة المعالج والذاكرة أثناء تشغيل فاشل، وأصلح الانتظارات الثابتة والبيانات المشتركة في الاختبارات، وامنح المهمة الجهاز الذي تحتاجه.

يمنحها Skipbox ذلك الجهاز بسعر ثابت: 8 vCPU و16 GB على `runs-on: skipbox-8x16` مقابل $79 شهريًا، على جهاز يستضيفه Skipbox لحسابك وحده تبقى فيه المتصفحات والحزم مثبّتة بين التشغيلات. والدقائق غير محدودة، فلا تضيف إعادات المحاولة والأجزاء شيئًا إلى الفاتورة.

- تطبيق Cypress النموذجي يعمل براحة على 4 vCPU و16 GB؛ وفي `ubuntu-latest` الخاص 2 و8
- 8 vCPU و16 GB مقابل $79 شهريًا، بدقائق غير محدودة
- المتصفحات والحزم تبقى على جهازك، فلا يعيد الجزء أو إعادة المحاولة تثبيتها

**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-flaky-e2e-tests-github-actions-ar)

## ما الذي تتشارك الاختبارات المشغّل معه

مهمة E2E تشغّل أكثر من الاختبارات. يعدّد [دليل الأداء في Cypress](https://docs.cypress.io/app/guides/test-performance): ‏Cypress نفسه، والمتصفح، وخادم تطبيقك، وأي خدمات خلفية يعتمد عليها تطبيقك. وعلى `ubuntu-latest` في مستودع خاص تتشارك 2 CPU و8 GB ‏([GitHub-hosted runners](https://docs.github.com/en/actions/reference/runners/github-hosted-runners)). أما المستودع العام فيحصل على 4 CPU و16 GB، وهو الحجم الذي يسمّيه Cypress مريحًا لتطبيقه النموذجي.

علامات الجهاز المحروم من الموارد، من الدليل نفسه:

- تبطؤ الاختبارات كلما تقدّم التشغيل
- ينهار المتصفح في منتصف التشغيل دون فشل اختبار واضح
- يبقى المعالج أو الذاكرة قرب 100% أثناء التشغيل

يبدأ Playwright متصفحًا واحدًا لكل عامل، و[الافتراضي نصف الأنوية](https://playwright.dev/docs/api/class-testconfig#test-config-workers). وتوصي [وثائق CI الخاصة به](https://playwright.dev/docs/ci#workers) بـ `workers: 1` في CI لتقديم الاستقرار وقابلية إعادة الإنتاج، فيحصل كل اختبار على الجهاز كله، ولا تقترح الاختبارات المتوازية إلا على نظام CI قوي مستضاف ذاتيًا.

## تأكد منه قبل أن تغيّر أي شيء

- **Cypress:** شغّل بـ `DEBUG=cypress:server:util:process_profiler npx cypress run`. يطبع المعالج والذاكرة كل 10 ثوانٍ؛ والمعالج الذي يتجاوز 100% باستمرار يعني أن الجهاز مُشبَع.
- **Playwright:** أعد تشغيل المجموعة الفاشلة مع `--workers=1`. إن توقف التقطع، فالجهاز كان الحد، لا الاختبارات. وأبقِ الأثر عند إعادة المحاولة (`trace: 'on-first-retry'`) لترى ما كانت الصفحة تفعله حين فشلت.
- **في الحالتين:** أضف خطوة قبل الاختبارات، `nproc && free -h`، وخطوة في الخلفية تسجّل `top -b -n 1 | head -15` كل 15 ثانية.

الأعطال التي تختفي على جهاز أكبر كانت من المشغّل، والجهاز الأكبر ينهيها. أما الاختبار الذي يظل يفشل في المكان نفسه فمشكلته فيه هو، والقسم التالي يصلحها.

## أصلح ما يخص الاختبارات

- **لا انتظارات ثابتة.** `cy.wait(2000)` و`page.waitForTimeout()` تنجح على حاسوب محمول سريع وتفشل على مشغّل بطيء. انتظر العنصر أو المسار أو الاستجابة بدلًا من ذلك.
- **سجّل الاعتراضات قبل الطلب.** ‏`cy.intercept` المضبوط بعد النقرة يتسابق مع الطلب.
- **اعزل البيانات.** الاختبارات التي تتشارك مستخدمًا أو سجلًا تفشل حين تعمل بترتيب آخر أو بالتوازي.
- **فعّل إعادات المحاولة في CI.** يصنّف Playwright الاختبار الذي يفشل ثم ينجح متقطعًا في تقريره؛ وإعداد `retries` في Cypress يعيد تشغيل الاختبار الفاشل في `cypress run`. إعادات المحاولة تُريك الاختبارات المتقطعة. لكنها لا تصلحها.

## ما يكلّفه التقسيم

يوزّع التقسيم المجموعة على عدة مهام، كل منها على جهازها. يأخذ [Playwright](https://playwright.dev/docs/test-sharding) ‏`--shard=1/4` ويدمج تقارير blob في مهمة أخيرة؛ و[وضع التوازي في Cypress](https://docs.cypress.io/app/continuous-integration/github-actions) يتطلب التسجيل في Cypress Cloud، الذي يوازن ملفات الاختبار بين الأجهزة.

كل جزء جهاز GitHub افتراضي جديد: يثبّت الحزم، ويُنزّل المتصفح (وتنصح Playwright بعدم تخزين المتصفحات مؤقتًا، لأن الاستعادة تستغرق تقريبًا ما يستغرقه التنزيل)، ويبني تطبيقك ويشغّله. وأربعة أجزاء تدفع ذلك أربع مرات، والفوترة بالدقيقة تحتسب كل واحد. يساعد التقسيم حين كان الجهاز هو الحد، لكنه يضاعف الإعداد معه.

## ما تكلّفه مجموعة بطيئة ومتقطعة

اختبارات E2E هي الفحص الأخير قبل الدمج، فينتظرها الفريق كله، ويضيف كل تقطع إعادة تشغيل فوق ذلك. ومع الفوترة بالدقيقة، تُحتسب كل واحدة من تلك الدقائق:

| الدقائق شهريًا (4 vCPU) | GitHub | Skipbox S | توفيرك كل شهر |
|---|---|---|---|
| 10,000 | $102 | $39 | **$63** |
| 20,000 | $222 | $39 | **$183** |
| 30,000 | $342 | $39 | **$303** |

وعلى 8 vCPU، تبلغ 20,000 دقيقة $422 على GitHub و$79 على Skipbox M. وأرقام GitHub بعد الاستخدام المضمّن في GitHub Team. وتُدخل دقائقك في [الحاسبة على الصفحة الرئيسية](https://skipbox.dev/?ref=g-flaky-e2e-tests-github-actions-ar#cost).

## امنح المجموعة الجهاز

تأتي كل خطة مع جهاز خاص بحسابك، محفوظ بين المهام، بسعر ثابت:

| التسمية | الجهاز | الخطة |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S، $39 شهريًا |
| `skipbox-8x16` | 8 vCPU · 16 GB | M، $79 شهريًا |
| `skipbox-16x32` | 16 vCPU · 32 GB | L، $149 شهريًا |

- **معالج وذاكرة للمنظومة كلها.** في `skipbox-8x16` الأنوية والذاكرة التي يسمّيها Cypress لتطبيقه النموذجي وأنوية أكثر، فيكفّ المتصفح والتطبيق وقاعدة بياناته عن التنافس. ومع 8 vCPU، يكون الافتراضي في Playwright ‏4 عمّال.
- **المتصفحات والحزم تبقى.** متصفحات Playwright في `~/.cache/ms-playwright`، وملف Cypress التنفيذي في `~/.cache/Cypress`، وذاكرة npm المؤقتة، وصور Docker لخدماتك على القرص حين تبدأ المهمة التالية.
- **دقائق غير محدودة.** إعادات المحاولة وإعادات التشغيل والأجزاء لا تغيّر الفاتورة. وvCPU خططك تحدد عدد الأجزاء التي تعمل في وقت واحد؛ والأجزاء الزائدة عن ذلك تنتظر دورها.

## الانتقال سطر واحد

```yaml
jobs:
  e2e:
    runs-on: skipbox-8x16 # was ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v6
        with:
          node-version: lts/*
      - run: npm ci
      - run: npx playwright install --with-deps
      - run: npx playwright test
```

تعمل `skipbox-8x16` على الخطة M؛ والفترة التجريبية تشغّل `runs-on: skipbox` ‏(4 vCPU، 16 GB).

1. سجّل الدخول إلى Skipbox باستخدام GitHub.
2. ثبّت تطبيق Skipbox على GitHub واختر المستودعات.
3. غيّر `runs-on` ثم ادفع التغيير.

## الأمان

- الجهاز لحسابك وحده، ولا تعمل عليه مهام أي شركة أخرى.
- بعد كل مهمة، تُمسح بيانات اعتماد المشغّل وعملياته وحاوياته. وتبقى المتصفحات وذاكرة التخزين المؤقت. ويمنح خيار «مهمة نظيفة في كل مرة» كل مهمة جهازًا جديدًا بدلًا من ذلك.
- الكود الوارد من أشخاص ليس لديهم صلاحية الكتابة (مثل طلبات السحب من النسخ المتفرعة) يعمل على جهاز افتراضي جديد يقرأ ذاكرتك المؤقتة لكنه لا يستطيع تغييرها.

التفاصيل في [كيف تُعزل المهام](https://docs.skipbox.dev/ar/isolation).

## جرّبه على المجموعة المتقطعة

الفترة التجريبية مجانية لمدة 7 أيام أو 3,000 دقيقة من وقت المهام، أيهما يأتي أولًا، دون بطاقة. انقل مهمة E2E إلى `runs-on: skipbox`، وشغّلها بضع مرات، وعُدّ حالات التقطع وأوقات الخطوات مقارنةً بما في GitHub.

## الأسئلة الشائعة

### لماذا تتقطع اختبارات Cypress لديّ على GitHub Actions بينما تنجح محليًا؟

كثيرًا لأن المشغّل أصغر من حاسوبك المحمول. في ubuntu-latest على مستودع خاص 2 CPU و8 GB، ويعمل عليه Cypress ومتصفحه وخادم تطبيقك وقاعدة بياناته جميعًا. وحين تتنافس، تُعرض الصفحات متأخرة، أو يتجاوز أمر مهلته الافتراضية البالغة 4 ثوانٍ، أو ينهار المتصفح. ويقول دليل الأداء في Cypress نفسه إن الحرمان من الموارد يظهر في صورة إخفاقات متقطعة أو بطيئة أو تبدو عشوائية، وإن تطبيقه النموذجي يعمل براحة على 4 vCPU و16 GB. تأكد من ذلك بـ DEBUG=cypress:server:util:process_profiler، وأصلح الانتظارات الثابتة، ثم امنح المهمة معالجًا وذاكرة أكثر.

### هل يمكن أن يكون معالج المشغّل أو ذاكرته سبب تقطع اختبارات Playwright في CI؟

نعم. كل عامل في Playwright يقود متصفحه الخاص، والافتراضي نصف أنوية الجهاز. وتوصي وثائق CI في Playwright بعامل واحد في CI من أجل الاستقرار، لأن كل اختبار يحصل حينها على الجهاز كله. فإن نجحت الاختبارات مع --workers=1 وتقطعت مع أكثر، فالجهاز هو الحد: أبقِ عاملًا واحدًا على 2 CPU، أو انتقل إلى جهاز بأنوية وذاكرة أكثر وارفع عدد العمّال هناك.

### كيف أفرّق بين مشغّل محروم من الموارد واختبار متقطع؟

راقب الجهاز أثناء تشغيل فاشل. يطبع Cypress المعالج والذاكرة كل 10 ثوانٍ مع DEBUG=cypress:server:util:process_profiler؛ ولـ Playwright، شغّل free -h وtop في خطوة في الخلفية، أو أعد التشغيل مع --workers=1. المشغّل المحروم يُظهر المعالج قرب 100% أو الذاكرة قرب الحد، وإخفاقات تتنقل بين الاختبارات وتزداد سوءًا كلما تقدّم التشغيل. أما الاختبار المتقطع فيفشل في المكان نفسه على جهاز سريع أيضًا.

### هل يحل تقسيم اختبارات E2E التقطع أو التكلفة؟

لا هذا ولا ذاك بمفرده. يمنح التقسيم كل جزء من المجموعة جهازه الخاص، وهذا يساعد حين كان الجهاز هو الحد، لكن كل جزء يثبّت الحزم، ويُنزّل المتصفحات، ويشغّل تطبيقك من جديد، والفوترة بالدقيقة تحتسب كل جزء. ووضع التوازي في Cypress يتطلب أيضًا التسجيل في Cypress Cloud. وعلى Skipbox تبقى المتصفحات والحزم على جهازك والدقائق غير محدودة، فلا تكلّف الأجزاء وإعادات المحاولة شيئًا إضافيًا.

### ما حجم المشغّل الذي ينبغي أن تستخدمه اختبارات E2E؟

ابدأ مما تعمل الاختبارات بجانبه: المتصفح، وخادم التطبيق وخدماته. تطبيق Cypress النموذجي يعمل براحة على 4 vCPU و16 GB. وعلى Skipbox، يمنح runs-on: skipbox-8x16 ‏8 vCPU و16 GB مقابل $79 شهريًا، وskipbox-16x32 ‏16 vCPU و32 GB.

### هل يمكنني تجربته مجانًا؟

نعم. الفترة التجريبية 7 أيام أو 3,000 دقيقة من وقت المهام، أيهما يأتي أولًا، دون بطاقة، على 4 vCPU و16 GB. انقل مهمة E2E إلى runs-on: skipbox، وشغّلها بضع مرات، وقارن الإخفاقات وأوقات الخطوات بما في GitHub.

آخر تحديث: 2026-11-19 · https://skipbox.dev/ar/guides/flaky-e2e-tests-github-actions
