إصلاح توقّف التشغيل الآلي في GitHub وتركيب منفّذ ذاتي على خادمنا الخاص

نبذة عنّا:

لدينا نظام إداري داخلي لشركة ، مبني بـ Next.js وقاعدة بيانات PostgreSQL، ويعمل داخل حاويات Docker على خادم سحابي خاص (لينكس، 16 نواة، 96 غيغابايت ذاكرة). الكود في مستودع خاص على GitHub، والنشر إلى الخادم آلي بالكامل عبر GitHub Actions.

المشكلة بالتفصيل:

1) منذ يوم 27 سبتمبر 2026 تتوقّف كل المسارات الآلية في GitHub Actions خلال ثانيتين قبل أن تبدأ، وتظهر هذه الرسالة من GitHub نفسها:

"The job was not started because recent account payments have failed or your spending limit needs to be increased."

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

3) النتيجة: لا يمكننا نشر أي تعديل إلى الخادم، ولا تعمل الفحوص الآلية. النظام الحالي على الخادم يعمل بشكل طبيعي، لكن التطوير متوقف تمامًا.

4) السبب الأعمق: كل عملية نشر تستهلك دقائق تشغيل كثيرة مدفوعة (بوابة فحص من نحو 15 مهمة متوازية)، فالاعتماد على خوادم GitHub المدفوعة يعرّضنا لهذا التوقف مرة بعد مرة.

المطلوب:

أولًا - رفع التوقف الحالي:

- تشخيص سبب الإيقاف بدقة، ومساعدتنا في حله مع دعم GitHub حتى تعود المسارات للعمل، مع إثبات ذلك بتشغيل ناجح.

ثانيًا - الحل الجذري (منفّذ ذاتي Self-hosted Runner على خادمنا):

- تركيب منفّذات ذاتية على خادمنا (سكربتات التركيب والإزالة جاهزة لدينا ويمكن مراجعتها واستخدامها)، بمستخدم مخصص غير جذر، وبسقف للمعالج والذاكرة لكل منفّذ، حتى لا تؤثر الفحوص على النظام الحي الذي يعمل عليه الموظفون.

- نقل مسارات الفحص ثم مسار النشر إلى المنفّذ الذاتي.

- معالجة مشكلة معروفة قبل النقل: الفحوص تشغّل قاعدة بيانات اختبار على منفذ ثابت (5432)، ومع عدة منفّذات على خادم واحد ستتصادم. المطلوب جعل المنفذ ديناميكيًا لكل مهمة.

- إثبات النجاح بتشغيل مهمّتين متزامنتين، ثم تشغيل نشر كامل ناجح.

- توفير طريقة رجوع بأمر واحد إن لم يعمل الحل.

شروط لا تنازل عنها:

- لا يُسمح بتعطيل بوابة الفحص قبل النشر أو تخفيفها أو تجاوزها بأي شكل، ولا بتعطيل أي اختبار لتسريع العمل.

- الخادم يحمل بيانات عملاء: سيكون الوصول مؤقتًا وبأقل صلاحية لازمة، ويُسحب فور التسليم، مع توقيع اتفاقية عدم إفصاح.

- التسليم يشمل توثيقًا مكتوبًا لكل ما تم، وإثباتًا عمليًا (روابط تشغيلات ناجحة)، لا مجرد القول بأنه تم.

المهارات المطلوبة:

GitHub Actions، إدارة خوادم لينكس، Docker، systemd، خبرة سابقة في تركيب Self-hosted Runners.