👨‍💻 تثبيت Gitness — استضافة Git مع CI/CD مدمج

انشر Gitness على Ubuntu بـ Docker — منصة Git مفتوحة المصدر من Harness تجمع بين استضافة المستودعات وطلبات الدمج وخطوط CI/CD المبنية على الحاويات في ملف تنفيذي واحد.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

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

سكريبت تثبيت آلي — أمر واحد ينشر Gitness على المنفذ 3047 مع وصول إلى Docker socket حتى تعمل خطوط الأنابيب.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/gitness/gitness-ubuntu.sh
chmod +x gitness-ubuntu.sh
sudo bash gitness-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/gitness/gitness-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x gitness-ubuntu.sh

3 تشغيل المثبت

يثبّت السكريبت Docker إذا لزم الأمر، يسحب صورة harness/gitness، ويشغّلها على المنفذ 3047 مع مجلد دائم ./data وربط Docker socket حتى تستطيع خطوط CI إنشاء حاويات.

sudo bash gitness-ubuntu.sh

4 إنشاء حساب المسؤول

افتح المتصفح وانتقل إلى Gitness، ثم سجّل أول حساب — سيصبح هو حساب المسؤول:

http://<your-server-ip>:3047

المنافذ المستخدمة

المنفذالغرض
3047Web UI + Git HTTP + API (host → container 3000)
docker.sockMounted so CI pipelines can create containers

نظرة عامة

Gitness هي منصة Git مفتوحة المصدر من Harness تجمع بين استضافة الشيفرة المصدرية وخطوط CI/CD المبنية على الحاويات في ملف Go تنفيذي واحد خفيف الوزن. إنها الخليفة المباشرة لـ Drone CI، وترث نموذج خطوط الأنابيب في Drone حيث تعمل كل خطوة بناء داخل حاوية Docker جديدة، مع إضافة استضافة المستودعات وطلبات الدمج ومراجعة الكود إلى نفس المنتج. بفضل قاعدة بيانات مدمجة وعدم وجود أي اعتماديات خارجية، يمكن نشر Gitness وتشغيله في أقل من دقيقة.

لماذا تستخدمه

يجمع Gitness ما كان يتطلب أداتين منفصلتين — سيرفر Git ونظام CI مثل Drone — في ملف تنفيذي خفيف واحد بدون أي قاعدة بيانات خارجية تحتاج لإدارتها. ولأن خطوط الأنابيب مبنية على الحاويات، تعمل كل خطوة بناء داخل حاوية Docker نظيفة ومعزولة، مما يمنحك عمليات بناء قابلة لإعادة الإنتاج دون التأثير على المضيف. بالنسبة للفرق الصغيرة أو المطورين الأفراد الذين يريدون استضافة Git وCI/CD بدون استهلاك موارد GitLab الكبير أو تعقيد تشغيل Drone وGitea بشكل منفصل، يُعد Gitness خياراً سريعاً وقليل الصيانة.

متى تحتاجه

  • تريد استضافة Git وCI/CD في ملف تنفيذي خفيف واحد بدلاً من تشغيل سيرفرات Git وCI منفصلة
  • أنت معتاد بالفعل على نموذج خطوط الأنابيب المبني على الحاويات في Drone CI وتريد خليفته الطبيعي
  • تحتاج تشغيل سيرفر Git + CI/CD عامل على VPS صغير خلال دقائق لا ساعات
  • تريد تجنّب إدارة سيرفر قاعدة بيانات منفصل فقط من أجل منصة Git الخاصة بك
  • تحتاج عمليات بناء مبنية على الحاويات حيث تعمل كل خطوة في خط الأنابيب داخل حاوية Docker معزولة وقابلة لإعادة الإنتاج
  • تقيّم توجه Harness مفتوح المصدر قبل النظر في منصتهم التجارية الأوسع

من يحتاجه

  • الفرق الصغيرة والمطورون المستقلون الذين يريدون استضافة Git وCI/CD دون نشر عدة خدمات منفصلة
  • مستخدمو Drone CI السابقون أو الحاليون الباحثون عن خليفته المباشر الذي يُطوَّر بنشاط
  • عشاق المختبرات المنزلية والاستضافة الذاتية الذين يريدون حزمة Git+CI خفيفة على VPS محدود الموارد
  • المطورون الذين يفضّلون خطوط الأنابيب المبنية على الحاويات حيث تعمل كل خطوة داخل حاوية Docker جديدة
  • الفرق التي تقيّم بدائل لـ GitLab ولا تريد استهلاكه الكبير للذاكرة الذي يصل لعدة جيجابايت
  • المستخدمون الذين يريدون عدم الاعتماد على قاعدة بيانات خارجية لتسهيل النسخ الاحتياطي وقابلية النقل
  • المساهمون في المصادر المفتوحة الذين يختبرون أدوات في مراحلها المبكرة من منظومة Harness مفتوحة المصدر

حالات الاستخدام الشائعة

  • استضافة مستودعات Git مع طلبات الدمج ومراجعة الكود لفريق صغير أو مشاريع شخصية
  • تشغيل خطوط أنابيب CI/CD مبنية على الحاويات تقوم بالبناء والاختبار والنشر مع كل push
  • استبدال إعداد Drone CI + سيرفر Git منفصل بملف تنفيذي موحد واحد
  • إقامة سيرفر Git داخلي خفيف على VPS أو جهاز مختبر منزلي محدود الموارد
  • بناء نماذج أولية لتعريفات خطوط أنابيب CI/CD قبل اعتماد منصة أثقل مثل GitLab أو Jenkins
  • تشغيل عمليات بناء معزولة وقابلة لإعادة الإنتاج حيث تُنفَّذ كل خطوة في حاوية Docker خاصة بها

الميزات الرئيسية

  • استضافة مستودعات Git مع طلبات الدمج ومراجعة الكود وحماية الفروع
  • خطوط أنابيب CI/CD مبنية على الحاويات حيث تعمل كل خطوة داخل حاوية Docker جديدة
  • قاعدة بيانات مدمجة — لا حاجة لـ PostgreSQL أو MySQL أو أي خدمة قاعدة بيانات خارجية
  • نشر بملف Go تنفيذي واحد يبدأ العمل في أقل من دقيقة بأقل إعداد
  • تعريفات خطوط الأنابيب كشيفرة، موروثة من نموذج YAML المُجرَّب في Drone
  • واجهة ويب مدمجة لتصفح المستودعات ومراجعة طلبات الدمج ومراقبة تشغيل خطوط الأنابيب
  • واجهة REST API لأتمتة إدارة المستودعات وخطوط الأنابيب
  • استهلاك موارد منخفض يناسب نسخ VPS الصغيرة حيث يكون GitLab ثقيلاً جداً

كيفية الاستخدام بعد التثبيت

  • افتح واجهة الويب على عنوان IP الخاص بسيرفرك والمنفذ 3047، ثم سجّل أول حساب — سيصبح هو حساب المسؤول
  • أنشئ أول مستودع Git ولاحظ رابط الاستنساخ (clone URL) المُولَّد بناءً على GITNESS_URL_BASE
  • استنسخ المستودع محلياً، ارفع الكود، وافتح طلب دمج لترى مسار المراجعة
  • أضف ملف .drone.yml أو تعريف خط أنابيب Gitness إلى مستودعك لتحديد خطوات CI/CD
  • تأكد من نجاح تشغيل خط الأنابيب بالتحقق من قدرته على إنشاء حاويات عبر Docker socket المربوط
  • ادعُ مستخدمين إضافيين إذا كنت تعمل ضمن فريق، وراجع صلاحياتهم من إعدادات المستودع
  • حدّث GITNESS_URL_BASE إذا وضعت Gitness لاحقاً خلف نطاق ووكيل عكسي، حتى تبقى روابط الاستنساخ صحيحة
  • أعدّ وكيلاً عكسياً مع HTTPS إذا كنت تخطط للوصول إلى Gitness من خارج شبكتك المحلية

أفضل ممارسات الأمان

  • لا تكشف المنفذ 3047 مباشرة للإنترنت بدون HTTPS — ضع Gitness خلف وكيل عكسي بشهادة TLS صالحة
  • قيّد من يستطيع رفع تعريفات خطوط الأنابيب — بما أن خطوط الأنابيب تعمل بوصول إلى Docker socket، يمكن لخط أنابيب خبيث التأثير على المضيف
  • تعامل مع Docker socket المربوط باعتباره وصولاً مكافئاً لصلاحيات root — يجب أن يكون وصول الرفع للمستودعات ذات خطوط الأنابيب مقتصراً على المستخدمين الموثوقين فقط
  • عيّن كلمات مرور قوية لجميع الحسابات، خصوصاً حساب المسؤول الأول الذي يُنشأ أثناء الإعداد
  • انسخ مجلد ./data احتياطياً بانتظام لأنه يحتوي على قاعدة البيانات المدمجة والمستودعات وسجل خطوط الأنابيب
  • حدّث صورة harness/gitness في Docker باستمرار للحصول على إصلاحات الأمان مع نضج المشروع
  • استخدم VPN أو قيّد الوصول حسب IP إذا كان Gitness يحتاج أن يكون متاحاً لفريقك فقط، وليس للإنترنت العام
  • راجع صلاحيات المستودعات وخطوط الأنابيب بشكل دوري، خصوصاً في النشرات العامة أو شبه العامة

المنافذ وإعدادات جدار الحماية

يستمع Gitness على المنفذ 3047 في المضيف، والمرتبط بالمنفذ الداخلي 3000 في الحاوية، ويخدم واجهة الويب وعمليات Git عبر HTTP وواجهة REST API كلها على هذا المنفذ الواحد. يُربط Docker socket داخل الحاوية حتى تستطيع خطوط الأنابيب إنشاء حاويات بناء — وهذا ليس منفذاً شبكياً لكنه يمثل حداً أمنياً مهماً، إذ إن أي شخص يستطيع رفع خط أنابيب يحصل فعلياً على تنفيذ للكود على المضيف. لا تكشف المنفذ 3047 مباشرة للإنترنت أبداً؛ ضعه خلف وكيل عكسي بـ HTTPS لأي وصول عن بُعد.

النسخ الاحتياطي والصيانة

  • انسخ مجلد ./data احتياطياً بانتظام — يحتوي على قاعدة البيانات المدمجة وكل المستودعات وسجل تنفيذ خطوط الأنابيب
  • بما أن Gitness لا يعتمد على قاعدة بيانات خارجية، فإن نسخة احتياطية واحدة للمجلد تلتقط كامل حالة التطبيق
  • انسخ احتياطياً ملف docker-compose.yml أو أمر التشغيل مع أي إعداد لـ GITNESS_URL_BASE حتى تتمكن من إعادة إنشاء الحزمة بنفس الشكل تماماً
  • خزّن النسخ الاحتياطية بعيداً عن السيرفر واختبر استعادة مجلد ./data على نسخة منفصلة بشكل دوري
  • صدّر تعريفات خطوط الأنابيب الحرجة إلى نظام التحكم بالإصدارات (عادة ما تكون موجودة أصلاً داخل كل مستودع) كإجراء وقائي إضافي
  • خذ لقطة (snapshot) للمجلد قبل الترقيات الكبيرة تحسباً لاحتياج التراجع عن عملية ترحيل

الأخطاء الشائعة

  • كشف المنفذ 3047 مباشرة للإنترنت بدون وكيل عكسي و HTTPS أمامه
  • منح صلاحية الرفع لمستخدمين غير موثوقين دون إدراك أن خطوط الأنابيب تعمل بوصول إلى Docker socket على المضيف
  • نسيان تحديث GITNESS_URL_BASE بعد نقل Gitness خلف نطاق جديد، مما يؤدي لروابط استنساخ معطوبة
  • عدم أخذ نسخة احتياطية من مجلد ./data، مما يؤدي لفقدان كامل للمستودعات وسجل خطوط الأنابيب عند حذف الحاوية
  • تشغيل Gitness بدون أي مجلد دائم على الإطلاق، مما يمحو كل مستودع عند إعادة إنشاء الحاوية
  • افتراض أن Gitness يضاهي GitLab أو نشرة Drone ناضجة في كل الميزات — فهو لا يزال مشروعاً في مرحلة مبكرة يتطور بنشاط
  • تجاهل التحديثات في هذه المرحلة المبكرة من المشروع، حيث تُصدَر الميزات وإصلاحات الأخطاء بشكل متكرر
  • ربط Docker socket دون فهم التبعات الأمنية لنسخة متعددة المستخدمين أو مواجهة للعامة

استكشاف الأخطاء وإصلاحها

  • لا يمكن تسجيل الحساب الأول — تأكد من أن الحاوية بدأت بنجاح وراجع السجلات بـ docker logs لأخطاء بدء التشغيل
  • خطوط الأنابيب تفشل في البدء — تحقق من أن Docker socket مربوط بشكل صحيح داخل الحاوية وأن Docker daemon يعمل على المضيف
  • روابط الاستنساخ خاطئة أو غير قابلة للوصول — تحقق من أن GITNESS_URL_BASE يطابق العنوان الفعلي الذي سيستخدمه المستخدمون للوصول للسيرفر
  • واجهة الويب غير قابلة للوصول — تأكد من أن المنفذ 3047 مربوط بشكل صحيح وغير محظور من جدار حماية المضيف
  • خط الأنابيب عالق في حالة انتظار أو قائمة انتظار — تحقق من أن الحاوية لديها إذن للتواصل مع Docker socket وأنها لا تصطدم بحدود الموارد
  • تبدو البيانات مفقودة بعد إعادة التشغيل — تأكد من أن مجلد ./data مربوط بشكل صحيح كمجلد دائم، وليس مجلداً مجهولاً أو مؤقتاً
  • أخطاء 502 أو أخطاء اتصال خلف وكيل عكسي — تأكد من أن الوكيل يوجّه إلى المنفذ 3047 في المضيف وأن حاوية Gitness تعمل
  • سلوك غير متوقع بعد التحديث — راجع ملاحظات الإصدار للمشروع، فـ Gitness لا يزال يتطور بسرعة وقد يتغير السلوك بين الإصدارات

البدائل

Gitea وForgejo سيرفرات Git ناضجة وخفيفة الوزن مع منظومة كبيرة من الإضافات والتكاملات، لكنهما يحتاجان نظام CI منفصل مثل Woodpecker أو Drone لخطوط الأنابيب. يجمع GitLab CE بين استضافة Git وCI/CD مثل Gitness لكنه أثقل بكثير، ويتطلب 4 جيجابايت رام أو أكثر مقابل استهلاك Gitness الطفيف. لا يزال Drone CI نفسه موجوداً كنظام CI مستقل يعمل مع أي سيرفر Git. بالنسبة للفرق التي تريد تحديداً نموذج خطوط أنابيب Drone مدمجاً مع استضافة Git في ملف تنفيذي خفيف واحد، يُعد Gitness الخيار الأكثر مباشرة — لكنه أحدث وأقل اختباراً من Gitea وForgejo وGitLab.

متى لا تستخدمه

لا يزال Gitness مشروعاً في مرحلة مبكرة مقارنة ببدائل ناضجة مثل Gitea أو Forgejo أو GitLab — إذا كنت تحتاج منصة مُختبرة جيداً مع منظومة إضافات كبيرة وضمانات استقرار طويلة الأمد، فتلك خيارات أكثر أماناً اليوم. لا يناسب الشركات الكبيرة التي تحتاج حوكمة متقدمة أو SSO/LDAP على نطاق واسع أو تكاملات طرف ثالث موسّعة يوفرها GitLab CE بالفعل. وإذا كنت لا تحتاج CI/CD إطلاقاً وتريد فقط استضافة Git، فقد تكون أداة أبسط مثل Gitea بدون حد الثقة الخاص بـ Docker socket خياراً أفضل.

هل تحتاج مساعدة احترافية؟

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

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

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

ما هو Gitness وما علاقته بـ Drone؟

Gitness هي منصة مفتوحة المصدر من Harness تجمع بين استضافة Git وCI/CD المبني على الحاويات، وهي خليفة Drone CI. ترث نموذج خطوط الأنابيب في Drone حيث تعمل كل خطوة داخل صورة Docker، وتضيف استضافة المستودعات وطلبات الدمج ومراجعة الكود في نفس المنتج.

لماذا يحتاج Gitness إلى Docker socket؟

خطوط أنابيبه مبنية على الحاويات: تعمل كل خطوة بناء داخل حاوية Docker، لذا يتواصل Gitness مع Docker daemon عبر الـ socket المربوط لإنشائها. هذا يعني أيضاً أن أي شخص يستطيع رفع خط أنابيب يمكنه تشغيل كود على المضيف، لذا قيّد الوصول لخطوط الأنابيب على المستخدمين الموثوقين.

ما المنفذ الذي يستخدمه Gitness؟

يربط سكريبت التثبيت المنفذ 3047 في المضيف بالمنفذ الداخلي 3000 في الحاوية، لذا تصل إلى واجهة الويب عبر http://your-server-ip:3047. هذا المنفذ الواحد يخدم الواجهة واستنساخ Git عبر HTTP وواجهة API. ضعه خلف وكيل عكسي بـ HTTPS للوصول عن بُعد.

هل يحتاج Gitness قاعدة بيانات منفصلة؟

لا. يأتي Gitness كملف Go تنفيذي واحد مع قاعدة بيانات مدمجة، لذا لا يوجد شيء آخر يجب نشره. كل شيء — المستودعات وقاعدة البيانات وسجل خطوط الأنابيب — يعيش في مجلد ./data، مما يجعل كلاً من النشر والنسخ الاحتياطي أبسط بكثير.

ما هو GITNESS_URL_BASE ولماذا يهم؟

يخبر Gitness بالعنوان العام الذي يصل من خلاله المستخدمون إليه، ويُستخدم لبناء روابط الاستنساخ المعروضة في الواجهة. يضبطه المثبت على عنوان IP الخاص بسيرفرك والمنفذ 3047. إذا وضعت Gitness لاحقاً خلف نطاق ووكيل عكسي، حدّث هذا المتغير وإلا ستكون روابط الاستنساخ التي ينسخها المستخدمون خاطئة.