عمليات البناء المصفوفية لبيئات متعددة

مرحبًا بكم في ميزة قوية في GitHub Actions: بناءات المصفوفة! تخيلوا أنكم بحاجة إلى اختبار شيفرتكم عبر العديد من البيئات المختلفة، مثل أنظمة التشغيل المتنوعة أو إصدارات لغات البرمجة.

بدلًا من إنشاء مسار عمل منفصل لكل تركيبة، تتيح لكم بناءات المصفوفة تعريف مجموعة من المتغيرات، ثم تشغّل GitHub Actions مهامكم تلقائيًا لكل تركيبة ممكنة من تلك المتغيرات.

تُعدّ بناءات المصفوفة مفيدة للغاية من أجل:

• الاختبار عبر الأنظمة الأساسية: ضمان عمل تطبيقكم على Windows وmacOS وLinux.
• التوافق مع إصدارات متعددة: الاختبار باستخدام إصدارات مختلفة من Node.js أو Python أو قاعدة البيانات لديكم.
• التنفيذ المتوازي: تشغيل جميع هذه الاختبارات في الوقت نفسه، مما يوفر قدرًا كبيرًا من الوقت.

تساعدكم هذه الميزة على تحقيق تغطية اختبار أوسع بكفاءة.

تعرّفون المصفوفة داخل القسم strategy من المهمة. وداخل strategy.matrix، تسردون متغيرًا واحدًا أو أكثر، ويكون لكل منها مصفوفة من القيم.

بعد ذلك، تنشئ GitHub Actions مهمة لكل تركيبة. دعونا نرَ شكل ذلك:

في المقطع السابق، عرّفنا متغيرًا باسم node-version بثلاث قيم: 14 و16 و18.

سيؤدي تعريف المهمة الواحد هذا إلى تشغيل ثلاث مهام منفصلة، تعمل كل منها على ubuntu-latest ولكن باستخدام إصدار مختلف من Node.js. وهذا يضمن عمل مشروعكم عبر هذه الإصدارات.

لستم مقيدين بمتغير واحد فقط! يمكنكم دمج عدة متغيرات في المصفوفة. فمثلًا، قد ترغبون في اختبار أنظمة تشغيل مختلفة باستخدام إصدارات مختلفة من Node.js.

ما عليكم سوى إضافة المزيد من أزواج المفتاح والقيمة ضمن strategy.matrix. وسيكون العدد الإجمالي للمهام حاصل ضرب عدد القيم لكل متغير.

إليكم طريقة إعداد مصفوفة للاختبار على كل من Ubuntu وWindows باستخدام إصداري Node.js‏ 16 و18.

سيؤدي ذلك إلى إنشاء 2 (نظاما التشغيل) * 2 (إصدارات Node.js) = 4 مهام منفصلة.

قد تحتاجون أحيانًا إلى تركيبات محددة لا يغطيها حاصل الضرب الديكارتي الافتراضي، أو قد ترغبون في إضافة متغيرات أخرى إلى بناءات معينة. استخدموا include لإضافة إدخالات جديدة إلى المصفوفة.

فمثلًا، قد ترغبون في تشغيل اختبار إضافي على Ubuntu باستخدام Node.js‏ 14 فقط، أو تمرير متغير بيئة محدد إلى تركيبة معينة من نظام التشغيل والإصدار.

ماذا لو كانت لديكم تركيبة معروفة بفشلها أو غير ذات صلة بمشروعكم؟ تتيح لكم الكلمة المفتاحية exclude إزالة إعدادات محددة من المصفوفة.

يساعدكم ذلك على تجنب تشغيل مهام غير ضرورية والتركيز على حالات الاختبار ذات الصلة.

يمكنكم، ضمن خطوات مهمتكم، الوصول إلى قيم متغيرات المصفوفة الحالية باستخدام الصيغة ${{ matrix.variable_name }}. ويُعدّ ذلك ضروريًا لإعداد الأدوات أو تشغيل الأوامر الخاصة بكل تركيبة من تركيبات المصفوفة.

فمثلًا، يضبط ${{ matrix.os }} نظام التشغيل لبيئة التشغيل ديناميكيًا، بينما يضبط ${{ matrix.node-version }} إجراء إعداد Node.js.

تُعدّ بناءات المصفوفة مفيدة من أجل:

• تطوير المكتبات: الاختبار باستخدام إصدارات متعددة من أحد التبعيات.
• المشروعات متعددة اللغات: بناء المكونات المكتوبة بلغات أو باستخدام مُصرّفات مختلفة واختبارها.
• التوافق مع المتصفحات: اختبار تطبيقات الويب عبر متصفحات مختلفة عند استخدام أداة تدعم ذلك.

تعمل هذه الميزة على تبسيط سيناريوهات الاختبار المعقدة وتحويلها إلى مسارات عمل موجزة يسهل صيانتها.

لنفترض أن لديكم مسار عمل في GitHub Actions يستخدم استراتيجية المصفوفة. وقد عُرّفت المصفوفة كما يلي:

strategy:
  matrix:
    os: [ubuntu-latest, macos-latest]
    python-version: [3.8, 3.9]
    exclude:
      - os: macos-latest
        python-version: 3.8

كم مهمة ستنشئها إعدادات المصفوفة هذه؟

أحسنتم! لقد تعلمتم كيفية استخدام بناءات المصفوفة في GitHub Actions.

• تتيح لكم تشغيل المهام لمجموعات متعددة من المتغيرات (أنظمة التشغيل وإصدارات اللغات وغير ذلك).
• تُعرّف باستخدام strategy.matrix داخل المهمة.
• تضيف include تركيبات محددة، بينما تزيلها exclude.
• يمكن الوصول إلى المتغيرات عبر ${{ matrix.variable_name }}.

تُعدّ بناءات المصفوفة أساسية لإجراء اختبارات شاملة وفعالة عبر بيئات متنوعة. واصلوا التدريب لإتقانها!