انتقل إلى المحتوى
⁨NDDev OpenNetwork⁩، الصفحة الرئيسية
المجتمع
اللغة: العربية
العرض
المظهر
الحركة

GitHub Device Sync ومنظومة CI/CD: إعداد CI/CD على GitHub Actions

يتولّى GitHub Device Sync ومنظومة CI/CD من NDDev إعداد CI/CD لأسطول المستودعات على GitHub. يوصّف GDS المستودعات والسياسات والأجهزة في مصدر واحد، ويُجري التعديلات عليها عبر خطة وتأكيد. وتعمل إلى جانبه مكتبة CI-workflows، وعقود التسليم CD-workflows، وتثبيت المشغّل الرسمي. الكود مفتوح بموجب AGPL-3.0، وتدير NDDev مستودعاتها الخاصة على هذه المنظومة.

لمن يناسب؟

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

  • المستودعات والأجهزة في توصيف واحد
  • خطة وتأكيد وسجلّ
  • مسارات عمل (workflows) قابلة لإعادة الاستخدام
  • مشغّلات GitHub Actions مستضافة ذاتياً

الأجزاء الأربعة للمنظومة

يفصل GitHub Device Sync بين العناصر التي غالباً ما تختلط معاً: هوية المستودع، وتصنيفه، وطوبولوجيا Git، وتوضعه على الأجهزة، والحالة المرصودة، والسياق المخصّص لوكلاء الذكاء الاصطناعي. ومن التوصيف المرجعي، يبني بطريقة حتمية السياسة والملفات لكل مستودع. وتقتصر أوامر القراءة على القراءة وحدها. أمّا التعديلات فيُنفَّذ كلٌّ منها وفق خطة محفوظة: التأكيد، وإعادة فحص الشروط، والتحقّق من النتيجة، والتسجيل في السجلّ.

  • توصيفات مرجعية للمالكين والمحدِّدات والأجهزة
  • ملفات حتمية للسياسة وسياق الوكلاء في كل مستودع
  • خطة وتأكيد وتطبيق وتحقّق وسجلّ لكل تعديل
  • حزم CI مخصّصة للغات Python وNode وGo وRust وJava و.NET وDart وFlutter وغيرها من اللغات
  • CodeQL وOSSF Scorecard وgitleaks وactionlint وzizmor وSBOM للكود المفتوح
  • عقود تسليم بخطة غير قابلة للتغيير وتراجع دقيق
  • منافذ تشغيل للمشغّل بالوسم nddev-linux، يعمل كلٌّ منها في خدمة systemd خاصة به
  • ترخيص AGPL-3.0 للمنظومة بالكامل

تمثّل CI-workflows مكتبة لمسارات عمل قابلة لإعادة الاستخدام في GitHub Actions بإصدارات مثبّتة عبر SHA: فحوصات اللغات، والفحص الأمني، وSBOM، وسلسلة الإصدار. وتنقسم البرامج بحسب مستوى ظهور المستودع والمزايا المدفوعة في GitHub: الكود المفتوح، والمستودعات الخاصة على الباقة الأساسية، والمستودعات الخاصة مع إضافات مشتراة بشكل منفصل. أمّا CD-workflows فتوصّف عملية التسليم: خطة غير قابلة للتغيير، وربط التأكيد، والتحقّق، والأدلّة، والتراجع الدقيق.

يثبّت GitHub Actions light المشغّل الرسمي actions/runner على Linux: إصدار بقيمة تحقّق مثبّتة، وخدمة systemd مستقلة لكل منفذ تشغيل، وتسجيل في المؤسسة أو المستودع. وتبقى قائمة الانتظار والصلاحيات والحالات في GitHub. وتعمل المستودعات العامة وطلبات pull request الواردة من التفريعات على مشغّلات GitHub، في حين يُنفَّذ الكود الخاص على منافذ التشغيل لديك.

إعداد CI/CD خطوة بخطوة

الترتيب الذي نتّبعه لربط المنظومة بمؤسستك.

  1. الحصر

    نجمع قائمة المستودعات والمالكين والأجهزة ونوصّفها في GDS.

  2. الفحوصات

    نختار برنامج CI المناسب لمستوى ظهور المستودعات وباقة GitHub لديك، ونربط مسارات العمل (workflows) عبر استدعاءات قصيرة في كل مستودع.

  3. المشغّلات

    نثبّت منافذ تشغيل GitHub Actions light على خوادم Linux لديك ونُسجّلها في المؤسسة.

  4. التسليم

    نوصّف عملية النشر عبر عقود CD-workflows: الخطة، والتأكيد، والتطبيق، والتحقّق، والتراجع.

  5. التسليم للفريق

    نوضّح للفريق كيفية قراءة الخطة والسجلّ، ونترك إرشادات لكل خطوة.

أسئلة حول GDS ومنظومة CI/CD

هل تناسبنا هذه المنظومة إذا كنّا نستخدم GitLab؟

بُنيت المنظومة حول GitHub وGitHub Actions. أمّا إعداد CI/CD على المنصات الأخرى فنقدّمه ضمن خدمة مستقلة في NDDev.Dev.

هل نحتاج إلى باقة مدفوعة في GitHub؟

توفّر المكتبة للمستودعات المفتوحة مجموعة مجانية كاملة من فحوصات الأمان. وللمستودعات الخاصة على الباقة الأساسية برنامجها الخاص. أمّا المزايا المدفوعة فلا تُفعَّل إلا في المواضع التي اشتريتها فيها.

أين تُحفَظ بيانات الاعتماد الخاصة بالنشر؟

تُحفَظ لدى منفِّذ التسليم، بمعزل عن المشغّلات. وتمرّر له عقود CD-workflows خطة مختومة، ولا ينفّذ سوى هذه الخطة.

ما هو GDS بعبارة بسيطة؟

هو توصيف واحد لجميع مستودعاتك يحدّد من يملكها، وما القواعد المطبّقة عليها، وعلى أي أجهزة توجد، وما الذي يعرفه عنها وكلاء الذكاء الاصطناعي. يقارن GDS هذا التوصيف بالواقع الفعلي، ويقترح خطة للتعديلات.

هل يمكن استخدام جزء واحد فقط؟

نعم. يوجد كل جزء في مستودعه الخاص ويعمل بصورة مستقلة: يمكنك ربط مسارات العمل (workflows) وحدها أو المشغّلات وحدها.

ما تكلفة الإعداد؟

يعتمد السعر على عدد المستودعات والمشغّلات وبيئات التسليم. نقدّم التقدير بعد دراسة الوضع، ونثبّت النتيجة النهائية في المواصفات الفنية؛ علماً بأن إعداد هذه المواصفات مشمول في تكلفة المشروع.

ننظّم المستودعات ومسارات العمل

أخبرنا بعدد المستودعات لديك وكيف تطلق الإصدارات حالياً، وسنقترح عليك من أي جزء تبدأ.

نردّ خلال 24 ساعة

المساعد

جارٍ تحميل المساعد…