⚙️ تثبيت Jenkins — سيرفر أتمتة CI/CD
انشر Jenkins على Ubuntu بـ Docker وأتمت خطوط البناء والاختبار والنشر لديك بأكثر من 1800 إضافة ونظام Pipeline as Code.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/DevOps/jenkins/jenkins-ubuntu.sh
chmod +x jenkins-ubuntu.sh
sudo bash jenkins-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/DevOps/jenkins/jenkins-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x jenkins-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم الأمر، يسحب صورة Jenkins LTS الرسمية، ويُشغّل الحاوية مع حجم تخزين دائم لمجلد JENKINS_HOME حتى تبقى مهامك وإضافاتك وإعداداتك محفوظة بعد إعادة التشغيل.
sudo bash jenkins-ubuntu.sh
4 الدخول إلى الواجهة
افتح المتصفح، افتح قفل Jenkins باستخدام كلمة مرور المسؤول الأولية المطبوعة في سجلات الحاوية، ثبّت الإضافات المقترحة، وأنشئ أول حساب مسؤول.
http://<your-server-ip>:8080
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8080 | HTTP Web Interface |
نظرة عامة
Jenkins هو سيرفر أتمتة مجاني ومفتوح المصدر يشغّل خطوط التكامل المستمر والتسليم المستمر (CI/CD). تفرّع أصلاً من Hudson عام 2011، ويعمل الآن على JVM وتديره مؤسسة Continuous Delivery Foundation. مع أكثر من 1800 إضافة من المجتمع ودعم أصلي لـ Pipeline as Code عبر ملف Jenkinsfile، يستطيع Jenkins بناء واختبار ونشر أي نوع تقريباً من مشاريع البرمجيات.
لماذا تستخدمه
Jenkins هو أكثر سيرفرات CI/CD انتشاراً وحيادية تجاه الموردين، مع نظام إضافات يغطي عملياً كل أنظمة التحكم بالإصدارات وأدوات البناء ومزودي السحابة وقنوات الإشعارات. استضافته ذاتياً تمنحك تحكماً كاملاً في عملاء البناء والأسرار وموارد الحوسبة — بدون فوترة بالدقيقة كما في خدمات CI السحابية، وبدون حدود للمهام المتزامنة سوى حدود جهازك. بنيته القائمة على متحكم/عملاء تتوسع من سيرفر واحد إلى أسطول موزّع من عقد البناء على أنظمة تشغيل ومعماريات مختلفة.
متى تحتاجه
- تحتاج بناء واختبار ونشر الكود تلقائياً في كل مرة يُدفع فيها إلى Git
- يستخدم فريقك عدة أنظمة تحكم بالإصدارات أو لغات أو أدوات بناء ويحتاج مركز أتمتة واحد
- تريد تجنب الفوترة بالدقيقة وحدود التزامن في منصات CI/CD السحابية المُدارة
- تحتاج بناءً موزعاً عبر عدة عملاء يعملون بأنظمة تشغيل أو معماريات مختلفة
- تحتاج تخصيصاً عميقاً عبر الإضافات لأدوات لا تدعمها خدمات CI السحابية جيداً
- متطلبات الامتثال أو إقامة البيانات تفرض بقاء خط البناء والأسرار على بنية تحتية تتحكم بها
حالات الاستخدام الشائعة
- بناء وتشغيل مجموعات الاختبار تلقائياً عند كل دفع أو طلب سحب على Git
- نشر التطبيقات إلى بيئات الاختبار والإنتاج بعد نجاح الاختبارات
- بناء ونشر صور Docker إلى سجل خاص مثل Harbor مع كل إصدار
- تشغيل مهام مجدولة مثل البناء الليلي أو النسخ الاحتياطي لقواعد البيانات أو تحديث الاعتماديات
- تنسيق خطوط أنابيب متعددة المراحل تشمل البناء والاختبار وفحص الأمان والنشر
- تنسيق أتمتة البنية التحتية مع أدوات مثل Ansible وTerraform وKubernetes
الميزات الرئيسية
- Pipeline as Code باستخدام ملف Jenkinsfile مكتوب بصياغة Groovy التصريحية أو النصية، مُدار مع الكود المصدري في نظام التحكم بالإصدارات
- أكثر من 1800 إضافة تغطي التحكم بالمصدر وأدوات البناء ومزودي السحابة وفحص الأمان والإشعارات
- بناء موزع عبر بنية متحكم/عملاء تتوسع عبر أجهزة وأنظمة تشغيل متعددة
- إدارة أسرار مدمجة لتخزين مفاتيح SSH والرموز وكلمات المرور المستخدمة في خطوط الأنابيب بأمان
- تصور بصري لخطوط الأنابيب يعرض مراحل البناء والسجلات والحالة في الوقت الفعلي
- بناءات مصفوفية وذات معاملات لاختبار عدة إعدادات أو بيئات
- واجهة REST API وأدوات سطر أوامر واسعة لتشغيل ومراقبة وإدارة المهام برمجياً
- تكامل أصلي مع Git وGitHub وGitLab وBitbucket وDocker وKubernetes وMaven وGradle وnpm
كيفية الاستخدام بعد التثبيت
- افتح قفل Jenkins بكلمة مرور المسؤول الأولية المطبوعة في سجلات الحاوية أو الموجودة في /var/jenkins_home/secrets/initialAdminPassword
- ثبّت مجموعة الإضافات المقترحة أو اختر الإضافات يدوياً لـ Git وDocker وأدوات البناء الخاصة بك
- أنشئ أول حساب مسؤول واضبط رابط Jenkins تحت Manage Jenkins → System
- أضف بيانات اعتماد لمستودعات Git وسجلات الحاويات وأهداف النشر تحت Manage Jenkins → Credentials
- أنشئ مهمة Pipeline جديدة ووجّهها إلى مستودع يحتوي على Jenkinsfile لتعريف مراحل البناء
- اضبط محفزات البناء مثل Webhooks من GitHub أو استطلاع SCM لتشغيل خطوط الأنابيب تلقائياً عند وصول commits جديدة
- أضف عملاء بناء تحت Manage Jenkins → Nodes إذا احتجت بناءً موزعاً أو خاصاً بمنصة معينة
- ثبّت إضافات الإشعارات (Slack، البريد الإلكتروني) لتنبيه فريقك عند فشل البناء أو حالة النشر
أفضل ممارسات الأمان
- ضع Jenkins خلف وكيل عكسي مع HTTPS لأن الإعداد الافتراضي يقدم واجهة الويب عبر HTTP عادي
- لا تكشف المنفذ 8080 مباشرة للإنترنت دون مصادقة وطبقة TLS أمامه
- فعّل نظام الأمان المدمج في Jenkins والتفويض القائم على المصفوفة لتقييد من يستطيع إعداد المهام
- خزّن كل الأسرار (مفاتيح API ومفاتيح SSH وكلمات المرور) في Jenkins Credentials Manager بدلاً من كتابتها مباشرة في Jenkinsfile
- قيّد الموافقة على السكريبتات حتى لا تستطيع سكريبتات الأنابيب تنفيذ أوامر نظام عشوائية دون مراجعة المسؤول
- حافظ على تحديث نواة Jenkins وكل الإضافات المثبتة — الإضافات القديمة مصدر شائع للثغرات المعروفة
- شغّل عملاء البناء بأقل صلاحيات ممكنة وتجنب تشغيل المتحكم نفسه كمنفذ بناء للمهام غير الموثوقة
- فعّل تسجيل التدقيق لتتبع تغييرات الإعدادات وتنفيذ المهام لأغراض الامتثال واستكشاف الأخطاء
المنافذ وإعدادات جدار الحماية
يستمع Jenkins على المنفذ 8080 لواجهة الويب وREST API افتراضياً. إذا استخدمت عملاء بناء واردين (JNLP)، يحتاج Jenkins أيضاً فتح منفذ TCP 50000 للاتصال بين العميل والمتحكم. يجب ألا يُكشف المنفذ 8080 مباشرة للإنترنت — ضع Jenkins خلف وكيل عكسي مثل Nginx Proxy Manager مع شهادة TLS صالحة، وقيّد الوصول المباشر للمنفذين 8080 و50000 في الجدار الناري على الشبكات الموثوقة أو VPN فقط.
النسخ الاحتياطي والصيانة
- انسخ دليل JENKINS_HOME بالكامل احتياطياً (عادةً /var/jenkins_home في Docker)، والذي يحتوي على كل المهام وتاريخ البناء والإضافات والإعدادات
- استخدم إضافة ThinBackup أو periodic-backup لجدولة نسخ احتياطي تلقائي للإعدادات وبيانات المهام
- ملفات Jenkinsfile مُدارة بالفعل في Git، لذا فقط إعدادات Jenkins وبيانات الاعتماد والإضافات تحتاج نسخاً احتياطياً منفصلاً
- انسخ ملف credentials.xml ودليل الأسرار بعناية — هذه مشفرة بمفتاح رئيسي مخزن أيضاً في JENKINS_HOME
- خزّن النسخ الاحتياطية خارج السيرفر، ويُفضل على قرص منفصل أو تخزين بعيد، واختبر الاستعادة دورياً على نسخة جديدة
- وثّق قائمة الإضافات المثبتة وإصداراتها حتى يمكن إعادة تثبيت جديد لنفس الحالة بالضبط
الأخطاء الشائعة
- تشغيل بناءات Jenkins مباشرة على عقدة المتحكم بدلاً من عملاء مخصصين، مما يعرّض الأمان والموارد للخطر
- كشف المنفذ 8080 للإنترنت دون وكيل عكسي وTLS، مما يترك بيانات تسجيل الدخول وسجلات البناء غير مشفرة
- كتابة الأسرار مثل مفاتيح API وكلمات المرور مباشرة في Jenkinsfile بدلاً من استخدام Credentials Manager
- عدم تثبيت إصدارات الإضافات، مما قد يكسر خطوط الأنابيب فجأة بعد تحديث تلقائي للإضافات
- تجاهل إعداد كلمة مرور المسؤول الأولية وترك Jenkins بمصادقة ضعيفة أو افتراضية
- تخطي النسخ الاحتياطي لـ JENKINS_HOME، مما يؤدي لفقدان كامل لتاريخ المهام والإعدادات بعد عطل السيرفر
- ترك القرص يمتلئ بمخرجات البناء والسجلات القديمة نتيجة عدم إعداد أدوات تنظيف البناء على المهام
استكشاف الأخطاء وإصلاحها
- لا يمكن الوصول لواجهة الويب — تحقق من تشغيل الحاوية، وتأكد من عدم حظر المنفذ 8080 بالجدار الناري، وراجع سجلات الحاوية لأخطاء بدء التشغيل
- نسيت كلمة مرور المسؤول الأولية — استرجعها مجدداً من /var/jenkins_home/secrets/initialAdminPassword داخل الحاوية قبل اكتمال معالج الإعداد
- فشل خط الأنابيب بخطأ 'permission denied' — تحقق من ملكية الملفات داخل حاوية Jenkins وتأكد أن مستخدم Jenkins يملك وصولاً للأحجام المُركّبة
- العميل لا يتصل بالمتحكم — تأكد أن منفذ TCP 50000 مفتوح وأن العميل يملك رابط المتحكم الصحيح والسر الصحيح
- فشل تثبيت الإضافات — تحقق من اتصال Jenkins Update Center وتأكد أن الحاوية تملك وصولاً صادراً للإنترنت
- فشل البناء بعد تحديث إضافة — ارجع للإصدار السابق من Manage Jenkins → Plugins وثبّت الإصدار مستقبلاً
- فشل بناءات Docker داخل Jenkins — تأكد أن حاوية Jenkins تملك وصولاً لـ Docker socket أو أن Docker-in-Docker مضبوط بشكل صحيح
البدائل
GitHub Actions وGitLab CI/CD هما البديلان السحابيان الأكثر شيوعاً، يقدمان خطوط أنابيب متكاملة بإحكام دون صيانة سيرفر لكن بفوترة حسب الاستخدام ومرونة أقل للبنية التحتية المعقدة ذاتية الاستضافة. CircleCI وTravis CI خدمات CI سحابية أولاً بحدود مجانية سخية لكن بقيود فوترة مشابهة. Woodpecker CI وDrone بديلان خفيفان قائمان على الحاويات وأسهل في الاستضافة الذاتية من Jenkins لكن بنظام إضافات أصغر. Gitea Actions، إذا كنت تستضيف Gitea بالفعل، يقدم مهام سير عمل متوافقة مع GitHub Actions دون سيرفر CI منفصل. للفرق التي تحتاج نظام إضافات Jenkins الذي لا يُضاهى وتحكماً كاملاً في بنية البناء التحتية، يبقى Jenkins الخيار الأكثر مرونة للاستضافة الذاتية.
متى لا تستخدمه
Jenkins ليس الخيار الأفضل إذا كان فريقك صغيراً ويحتاج فقط أتمتة بسيطة للبناء عند الدفع — GitHub Actions أو GitLab CI/CD سيشغلانك في دقائق دون أي صيانة سيرفر. إذا كانت مشاريعك خفيفة وقائمة على الحاويات، تقدم Woodpecker CI أو Drone إعداداً ذاتي الاستضافة أبسط بكثير وعبئاً تشغيلياً أقل من بنية Jenkins القائمة على Java. يتطلب Jenkins أيضاً صيانة مستمرة — تحديث الإضافات وتصحيحات الأمان وضبط JVM — لذا إن لم تستطع تخصيص وقت لصيانة السيرفر، فخدمة CI مُدارة خيار أنسب. للسيرفرات محدودة الموارد جداً، قد يكون استهلاك Jenkins لـ JVM (عادةً 1-2 جيجابايت رام كحد أدنى) ثقيلاً مقارنة بالبدائل الأخف.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل Jenkins مجاني للاستخدام؟
نعم. Jenkins مجاني تماماً ومفتوح المصدر برخصة MIT. لا توجد باقات مدفوعة أو حدود مستخدمين أو قيود ميزات — تدفع فقط مقابل البنية التحتية التي تشغّله عليها.
ما هو ملف Jenkinsfile؟
Jenkinsfile هو ملف نصي، مكتوب بصياغة Groovy التصريحية أو النصية، يعرّف خط البناء بأكمله كشيفرة برمجية. يُخزَّن مع الكود المصدري في نظام التحكم بالإصدارات، لذا تُتبَّع تغييرات خط الأنابيب وتُراجَع وتُرجَّع مثل كود التطبيق تماماً.
كم عدد إضافات Jenkins؟
يمتلك Jenkins أكثر من 1800 إضافة في Update Center، تغطي تكاملات التحكم بالمصدر وأدوات البناء ومزودي السحابة وأدوات فحص الأمان وخدمات الإشعارات. هذا واحد من أكبر أنظمة الإضافات لأي أداة CI/CD.
هل يستطيع Jenkins بناء صور Docker؟
نعم. يستطيع Jenkins بناء ونشر صور Docker باستخدام إضافة Docker Pipeline، إما بتركيب Docker socket الخاص بالمضيف داخل حاوية Jenkins أو بتشغيل Docker-in-Docker. تستخدم فرق كثيرة Jenkins لبناء الصور ونشرها إلى سجل خاص مثل Harbor.
كيف أؤمّن Jenkins للاستخدام في الإنتاج؟
ضع Jenkins خلف وكيل عكسي مع HTTPS، فعّل التفويض القائم على المصفوفة، خزّن كل الأسرار في Credentials Manager، قيّد الموافقة على سكريبتات الأنابيب، وحافظ على تحديث نواة Jenkins والإضافات بانتظام. لا تكشف المنفذ 8080 مباشرة للإنترنت دون طبقة TLS أمامه.
