إنشاء CI بسيطة باستخدام GitHub Actions للمشاريع البرمجية
تساعد التكاملات المستمرة على اكتشاف الخطأ قبل وصوله إلى الفرع الرئيسي. بدلاً من الاعتماد على أن كل مطور شغل الاختبارات بالطريقة نفسها، يعرّف المشروع خطوات آلية تعمل عند كل Push أو Pull Request. سننشئ workflow لمشروع Python يثبت الحزم ويشغل الاختبارات، ثم نوضح كيف تثبت إصدار Python وتخزن الأسرار من دون وضعها في الملف.
الفكرة الأساسية
يتكون workflow من trigger وjobs وsteps. يحدد trigger الحدث الذي يبدأ العملية، ويحدد job البيئة، بينما تنفذ steps أوامر الإعداد والاختبار. يجب أن تكون الخطوات قابلة للإعادة، ولهذا نثبت الإصدارات أو نستخدم ملف requirements. نجاح CI لا يعني أن البرنامج خال من كل خطأ، لكنه يضمن مرور مجموعة محددة من الفحوص في بيئة معروفة.
مثال برمجي عملي
name: Python checks
on:
push:
branches: ["main"]
pull_request:
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.12"
- run: pip install -r requirements.txt
- run: pytest -qشرح المثال
يعمل workflow عند الدفع إلى main وعند فتح Pull Request. checkout يجلب الملفات، وsetup-python يثبت الإصدار المطلوب، ثم تنفذ الخطوتان التاليتان تثبيت الاعتمادات والاختبارات. في مشروع حقيقي يمكن إضافة lint وcoverage وبناء صورة Docker. إذا احتاجت خطوة إلى مفتاح، استخدم Secrets في إعدادات المستودع ولا تكتبه في YAML أو سجل التنفيذ.
أنشئ المجلد .github/workflows وأضف ملفاً بامتداد yml، ثم ادفعه إلى فرع تجريبي. افتح صفحة Actions واقرأ السجل عند الفشل. ابدأ بأمر واحد يعمل محلياً، وبعد تثبيته أضف الفحوص تدريجياً. اجعل الاختبارات سريعة بما يكفي لتعمل مع كل Pull Request، وانقل الاختبارات الثقيلة إلى مهمة منفصلة عند الحاجة.
طريقة التفكير قبل التنفيذ
قبل كتابة الكود، حدد المشكلة في جملة واحدة، ثم اكتب المدخلات والمخرجات والحالات التي قد تفشل. هذا الترتيب يمنعك من القفز إلى مكتبة أو إطار قبل فهم ما يحتاجه التطبيق فعلاً. قسّم الحل إلى أجزاء صغيرة، واجعل لكل جزء مسؤولية يمكن شرحها واختبارها. لا تعني البساطة حذف كل التفاصيل، بل وضع التفاصيل في المكان الذي يحتاجها.
من المفيد أيضاً أن تكتب مثالاً يدوياً للنتيجة المتوقعة. عندما ترى البيانات أمامك، ستلاحظ حقولاً ناقصة أو حالات لم تكن في بالك. احتفظ بهذه الملاحظات بجانب المشروع، وحدّثها إذا تغير التصميم. التوثيق القصير في البداية يوفر وقتاً كبيراً عندما يعود الفريق إلى الكود بعد أسابيع.
اختبار الفكرة في حالات مختلفة
ابدأ بالمسار الطبيعي، ثم جرّب قيمة فارغة، ومدخلاً كبيراً، وبيانات غير مرتبة، وفشلاً في الاتصال أو التخزين. لا يكفي أن يعمل المثال مرة واحدة على جهازك؛ المطلوب أن تعرف كيف يتصرف عندما لا تسير الأمور كما تتوقع. اجعل الاختبارات قابلة للإعادة، ولا تعتمد على وقت متغير أو خدمة خارجية إذا كان ذلك غير ضروري.
- تحقق من البيانات قبل تمريرها إلى الجزء الذي يعالجها.
- استخدم رسائل خطأ تشرح المشكلة من دون كشف أسرار النظام.
- اختبر المسار الناجح والمسارات التي تعيد نتيجة فارغة.
- سجّل القرار الذي اتخذته عندما توجد أكثر من طريقة للحل.
ملاحظات على جودة المشروع
تظهر قابلية الصيانة في أسماء واضحة، ودوال قصيرة، وحدود مفهومة بين طبقات التطبيق. لا تضع الإعدادات الخاصة بجهازك داخل الكود، ولا تخزن مفاتيح الوصول في المستودع. استخدم ملفاً نموذجياً للإعدادات، واترك القيم الحقيقية خارج الملفات التي تشاركها مع الآخرين. راجع الكود بعد أن يعمل، لأن النسخة الأولى تركز غالباً على الوصول إلى النتيجة لا على وضوح الطريق إليها.
متى يحتاج الحل إلى تطوير؟
يكفي المثال الصغير للتعلم، لكنه لا يغطي كل ما يحتاجه نظام حقيقي. عند زيادة المستخدمين أو البيانات ستظهر الحاجة إلى مراقبة، وصلاحيات، واختبارات آلية، وسياسة واضحة للتعامل مع الفشل. أضف هذه الأجزاء عندما تظهر مشكلة تبررها، ولا تنسخ بنية كبيرة إلى مشروع صغير بلا سبب. التصميم الجيد قابل للنمو، لكنه لا يحاول توقع كل شيء منذ اليوم الأول.
أخطاء ينبغي تجنبها
لا تنس تثبيت إصدار اللغة إذا كان اختلافه يغير النتيجة، ولا تسمح بتسريب الأسرار في print. لا تضف عشرات الخطوات قبل معرفة سبب فشل كل واحدة. راجع صلاحيات workflow، ولا تستخدم Action خارجية بلا مراجعة مصدرها وإصداراتها.
خطوة تالية مناسبة
أضف مصفوفة لاختبار أكثر من إصدار Python، ثم اجعل الدمج مشروطاً بنجاح المهمة. بعد ذلك أنشئ مهمة تبني حزمة أو صورة، لكن افصل البناء عن النشر حتى تحتاج إلى موافقة واضحة.
CI التي تعطي ثقة حقيقية
لا تقيس نجاح CI بعدد الخطوات، بل بما تمنعه من أخطاء قبل الدمج. ابدأ بتثبيت نسخة اللغة، ثم تثبيت الاعتمادات، وتشغيل formatter أو linter، وبعدها الاختبارات. استخدم cache بحذر حتى لا تخفي مشكلة في تثبيت حزمة، وثبت الإصدارات المهمة. لا تضع أسراراً داخل ملف workflow، واستخدم صلاحيات أقل للرمز الذي يشغل المهمة. اجعل الرسالة عند الفشل قابلة للقراءة، واسمح للمطور بتشغيل الأمر نفسه محلياً. كل فحص يجب أن يملك سبباً واضحاً، وإلا سيتعلم الفريق تجاهله.
اكتب ملاحظة قصيرة عن القرار الذي اتخذته أثناء التجربة، وسجل ما قسته أو اختبرته بدلاً من الاكتفاء بانطباع عام. قارن النسخة البسيطة بالنسخة التي أضفت إليها هذه الخطوة، ثم اسأل هل تحسن الوضوح أو الأداء أو سهولة الصيانة. إذا لم يظهر أثر عملي، ارجع إلى التصميم الأبسط. هذه المراجعة تمنع تحول المثال التعليمي إلى تعقيد ثابت لا يخدم المستخدم.
خطة تطبيق عملية
بعد فهم موضوع «إنشاء CI بسيطة باستخدام GitHub Actions للمشاريع البرمجية»، لا تنقل المثال إلى مشروع كبير دفعة واحدة. أنشئ مجلداً صغيراً، وثبت نسخة الأدوات التي ستستخدمها، ثم اكتب حالة نجاح واحدة يمكن تشغيلها من البداية إلى النهاية. احتفظ بالمدخل الذي استخدمته والنتيجة التي توقعتها، لأن ذلك يمنحك نقطة مقارنة عندما تغير الكود. إذا كان الموضوع يعتمد على خدمة أو قاعدة بيانات، جهز بيانات تجريبية لا تحمل معلومات حقيقية، واكتب طريقة تنظيفها بعد انتهاء الاختبار.
انتقل بعد ذلك إلى الحالات التي تسبب الالتباس. ماذا يحدث عندما تكون القيمة فارغة؟ كيف يتصرف البرنامج عند وصول نوع غير متوقع؟ هل تعود رسالة مفيدة إذا توقفت الخدمة الخارجية أو لم يجد التطبيق السجل المطلوب؟ اكتب إجابة لكل سؤال في اختبار أو ملاحظة قصيرة. لا تحاول معالجة كل احتمال في سطر واحد؛ فصل المسارات يجعل التصحيح أسهل ويمنع إخفاء المشكلة خلف استثناء عام.
من المفيد أن تقيس قبل التحسين وبعده. قد يكون القياس زمناً أو حجماً أو عدد استدعاءات أو نسبة أخطاء، بحسب طبيعة الموضوع. لا تعتمد على الانطباع وحده، ولا تقارن تشغيلين مختلفين من دون تثبيت الظروف قدر الإمكان. إذا لم يتحسن المؤشر، تراجع عن التغيير وابحث عن السبب بدلاً من إضافة طبقة أخرى. وبعد أن تستقر النتيجة، اكتب README قصيراً يوضح أمر التشغيل، المدخلات، المخرجات، وأهم قرار اتخذته أثناء البناء.
أخيراً، راجع حدود المثال. الكود التعليمي يشرح المفهوم، لكنه قد يحتاج في الإنتاج إلى صلاحيات، ومراقبة، واختبارات، وإدارة أسرار، وسياسة للتحديث. أضف ما يبرره الاستخدام الفعلي فقط. بهذه الطريقة تتعلم التقنية من دون أن تخلط بين نموذج صغير ونظام جاهز للمستخدمين.
الحفاظ على CI
راجع ملف workflow كما تراجع كود التطبيق. احذف الخطوة التي لم تعد تقدم معلومة، وحدد سبب أي استثناء أو شرط خاص. شغّل الفحوصات نفسها على فرع تجريبي، وتأكد من أن تحديث الاعتمادات لا يغير النتيجة بلا مراجعة. عندما تفشل CI، يجب أن يستطيع المطور معرفة الأمر الذي فشل وتشغيله محلياً، وإلا تحولت العملية إلى عائق يتجاوزه الفريق بدلاً من الاستفادة منه.
الخلاصة
أضف مصفوفة لاختبار أكثر من إصدار Python، ثم اجعل الدمج مشروطاً بنجاح المهمة. بعد ذلك أنشئ مهمة تبني حزمة أو صورة، لكن افصل البناء عن النشر حتى تحتاج إلى موافقة واضحة. يوضح هذا الموضوع كيف تتحول الفكرة النظرية إلى خطوات يمكن تشغيلها وفحصها.
ابدأ بتطبيق المثال على ملف صغير، ثم غيّر مدخلاً واحداً وراقب النتيجة. بعد ذلك أضف حالة فشل واكتب اختباراً لها، ثم انقل الفكرة إلى مشروعك الحقيقي بحذر. عندما تفهم سبب كل خطوة، ستستطيع تغيير الأدوات أو اللغة من دون فقدان المفهوم. البرمجة تتحسن بالمحاولات القصيرة والمراجعة المستمرة، لا بنسخ كود طويل من دون معرفة ما الذي يحميه أو ما الذي قد يكسره.