👨‍💻 تثبيت Concourse CI — تكامل مستمر يركّز على خطوط الأنابيب

انشر Concourse CI على Ubuntu بـ Docker — نظام CI/CD يركّز على خطوط الأنابيب حيث يعمل كل بناء في حاوية جديدة، مع PostgreSQL وتسجيل دخول مسؤول مُولَّد، على المنفذ 8244.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر Concourse CI مع PostgreSQL على المنفذ 8244 ويُولّد كلمة مرور مسؤول. أدر خطوط الأنابيب بواجهة سطر الأوامر fly.
عرض على GitHub

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

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

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

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

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

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

chmod +x concourse-ubuntu.sh

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

./concourse-ubuntu.sh

4 تسجيل الدخول وتثبيت fly CLI

http://your-server-ip:8244

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

المنفذالغرض
8244Concourse web UI and API — also the fly CLI target (mapped from container port 8080)
5432PostgreSQL — internal to the Docker network, not exposed to the host

نظرة عامة

Concourse نظام تكامل وتسليم مستمر مفتوح المصدر مبني حول خطوط أنابيب تصريحية (declarative)، حيث تُنفَّذ كل مهمة داخل حاوية جديدة تماماً وزائلة. تُعرَّف خطوط الأنابيب بصيغة YAML كموارد (resources — أشياء تراقبها Concourse بحثاً عن تغييرات، مثل مستودع Git أو سجل Docker) ومهام (jobs — سلاسل من المهام تعمل عند تغيّر مورد)، تُعرَض كرسم بياني بصري حي في واجهة الويب. على عكس معظم أدوات CI، لا تملك Concourse تقريباً أي نظام إضافات مدمج — كل شيء تقريباً حاوية، مما يُبقي النواة صغيرة والسلوك متسقاً وقابلاً للتكرار.

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

تحل Concourse مشكلة تنمو مع الوقت في أنظمة CI الأخرى: تتراكم على وكلاء البناء طويلي الأمد أدوات مُثبَّتة وحالة مخبَّأة وانحراف إعدادات إلى أن ينجح البناء أو يفشل لأسباب لا علاقة لها بالكود قيد الاختبار. ولأن كل مهمة في Concourse تعمل في حاوية جديدة تماماً يُحدّدها خط الأنابيب نفسه، فإن بناءً ينجح اليوم سيتصرف بنفس الطريقة الشهر القادم، وتعيش إعدادات خط الأنابيب بأكملها في YAML خاضع للتحكم بالإصدارات بدلاً من إعدادات واجهة متناثرة. هذا يجعل Concourse خياراً قوياً للفرق التي تريد أن يكون سلوك CI/CD قابلاً للتكرار والتدقيق بالكامل بدلاً من الاعتماد على حالة سيرفر بناء متراكمة.

متى تحتاجه

  • تريد خطوط أنابيب CI/CD مُعرَّفة بالكامل كـ YAML خاضع للتحكم بالإصدارات بدلاً من إعدادها عبر واجهة ويب
  • تحتاج قابلية تكرار البناء — يجب أن تعمل كل مهمة في حاوية نظيفة ومُحدَّدة بدلاً من وكيل طويل الأمد بحالة متراكمة
  • فريقك محبَط من انحراف وكلاء Jenkins عن التزامن أو تراكم أدوات مُثبَّتة وذواكر مخبَّأة قديمة مع الوقت
  • تحتاج نظام CI مبني حول الحاويات أصلياً، دون الحاجة لإضافات منفصلة لتشغيل كل مهمة في Docker
  • تريد رسماً بيانياً بصرياً فورياً لخط الأنابيب يعرض حالة الموارد والمهام بدلاً من قائمة مسطّحة من مهام البناء

من يحتاجه

  • مهندسو DevOps والمنصات الذين يريدون خطوط أنابيب CI/CD مُعرَّفة كـ code وخاضعة للتحكم بالإصدارات جنباً إلى جنب مع التطبيقات التي يبنونها
  • الفرق التي عانت من انحراف وكلاء Jenkins أو مشكلات توافق الإضافات أو إعدادات تعيش فقط في واجهة الويب
  • المؤسسات التي تحتاج قابلية تكرار وتدقيق للبناء لأسباب امتثال أو هندسة إصدارات
  • المهندسون المرتاحون للعمل من سطر الأوامر الذين يفضّلون fly CLI على النقر عبر نماذج إعداد خط الأنابيب
  • الفرق التي تبني خطوط أنابيب تسليم متعددة المراحل ومعقدة تستفيد من نموذج المورد-والمهمة في Concourse
  • عشاق الاستضافة الذاتية والفرق الصغيرة التي تريد نظام CI أصيل الحاويات دون تعقيد تشغيلي بمستوى Kubernetes

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

  • تشغيل مجموعات اختبار آلية وبناء أدوات لكل commit يُدفع لمستودع Git
  • بناء ودفع صور Docker لسجل تلقائياً كجزء من خط أنابيب تسليم متعدد المراحل
  • تنسيق خطوط أنابيب نشر تُرقّي بناءً عبر بيئات التجريب والإنتاج ببوابات موافقة يدوية
  • مراقبة موارد خارجية (مستودعات Git، دلاء S3، سجلات Docker، مُشغّلات زمنية) وتشغيل مهام تلقائياً عند تغيّرها
  • استبدال وكلاء بناء Jenkins طويلي الأمد بحاويات زائلة وقابلة للتكرار لكل مهمة بناء منفردة

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

  • خطوط أنابيب YAML تصريحية تُعرّف موارد (أشياء لمراقبتها) ومهام (سلاسل من المهام) كإعدادات خاضعة للتحكم بالإصدارات
  • تعمل كل مهمة في حاوية جديدة زائلة يُحدّدها خط الأنابيب نفسه، مما يُلغي انحراف الوكلاء وحالة البناء القديمة
  • رسم بياني بصري حي لخط الأنابيب في واجهة الويب يعرض حالة الموارد والمهام فورياً
  • أداة سطر الأوامر fly لرفع خطوط الأنابيب وتشغيل عمليات البناء وبث مخرجات البناء من الطرفية
  • أنواع الموارد نفسها حاويات قابلة للتوصيل، فيُضاف دعم أنظمة جديدة (Git، S3، Slack، سجلات Docker) دون لمس نواة Concourse
  • تحكم وصول قائم على الفرق، يتيح لفرق مختلفة إدارة خطوط أنابيبها الخاصة ضمن نفس نسخة Concourse
  • استمرارية مدعومة بـ PostgreSQL لحالة خط الأنابيب وسجل البناء وبيانات الاعتماد

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

  • افتح http://your-server-ip:8244 والتقط كلمة مرور المسؤول العشوائية التي يطبعها المُثبّت — لا توجد بيانات اعتماد افتراضية
  • نزّل fly CLI من الرابط المعروض في تذييل واجهة الويب، بما يطابق نظام تشغيلك المحلي
  • سجّل الدخول من الطرفية بـ fly -t <target-name> login -c http://your-server-ip:8244 -u <username> -p <password>
  • اكتب خط أنابيبك الأول كملف YAML يُعرّف مورداً (مثل مستودع Git) ومهمة تعمل عند تغييره
  • ارفع وفعّل خط الأنابيب بـ fly -t <target-name> set-pipeline -p <pipeline-name> -c pipeline.yml، ثم أزل إيقافه المؤقت
  • راقب تنفيذ خط الأنابيب في واجهة الويب، واستخدم fly -t <target-name> watch لبث مخرجات البناء من الطرفية

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

  • غيّر كلمة مرور المسؤول المُولَّدة فوراً إذا كنت تخطط لإبقاء هذا النشر بعد الاختبار الأولي، وخزّن بيانات الاعتماد في مدير كلمات مرور
  • لا تكشف المنفذ 8244 مباشرة للإنترنت العام دون وكيل عكسي يوفّر TLS، لأن تسجيلات دخول fly CLI ومخرجات البناء ستنتقل بـ HTTP عادي دون ذلك
  • استخدم ميزة الفرق في Concourse لفصل وصول خطوط الأنابيب بين مشاريع أو أقسام مختلفة بدلاً من منح الجميع صلاحيات مسؤول
  • خزّن الأسرار (مفاتيح API، بيانات اعتماد النشر) باستخدام تكامل مدير بيانات الاعتماد في Concourse (Vault أو AWS Secrets Manager أو أسرار Kubernetes) بدلاً من ترميزها ثابتة في YAML خط الأنابيب
  • قيّد أي مستودعات Git أو سجلات يمكن لخط الأنابيب السحب منها إذا كنت تُشغّل تعريفات خط أنابيب غير موثوقة أو من طرف ثالث
  • حدّث صورتي Concourse وPostgreSQL Docker بانتظام، لأن أنظمة CI القادرة على تشغيل حاويات مُعرَّفة بخط أنابيب عشوائي تمثّل سطح هجوم ذا معنى إذا اختُرقت

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

تكشف Concourse منفذ المضيف 8244 لكل من واجهة الويب والواجهة البرمجية التي يستخدمها fly CLI، مُطابَق من منفذ الحاوية الداخلي 8080. داخلياً، تستمع PostgreSQL على المنفذ 5432، لكنه غير مكشوف للمضيف افتراضياً — فقط الحاويات الأخرى على نفس شبكة Docker يمكنها الوصول إليه. لا تكشف المنفذ 8244 مباشرة للإنترنت دون TLS أبداً، لأن مصادقة fly CLI وسجلات البناء ستُرسل بـ HTTP عادي دون ذلك. ضع Concourse خلف وكيل عكسي بشهادة صالحة لأي وصول خارج شبكتك المحلية، وقيّد كشف PostgreSQL على شبكة Docker الداخلية فقط.

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

  • انسخ احتياطياً حجم قاعدة بيانات PostgreSQL، الذي يحمل كل إعدادات خط الأنابيب وسجل البناء وبيانات الفرق/المستخدمين — هذا مصدر الحقيقة الوحيد لـ Concourse
  • صدّر ملفات YAML لخطوط أنابيبك للتحكم بالإصدارات (Git) كمصدر رسمي، حتى يمكن إعادة تطبيق خطوط الأنابيب على نسخة Concourse جديدة حتى لو فُقدت قاعدة البيانات
  • انسخ احتياطياً أي إعدادات مدير بيانات اعتماد (مسارات Vault، إعدادات خلفية الأسرار) بشكل منفصل، لأن أسرار خط الأنابيب غالباً ما تعيش خارج Concourse نفسها
  • وثّق إعداد هدف fly CLI وبنية الفرق حتى يتمكن المشغّلون من إعادة الاتصال وإدارة خطوط الأنابيب بعد الاستعادة
  • اختبر استعادة نسخة PostgreSQL الاحتياطية إلى نشر Concourse جديد دورياً للتأكد أن سجل خط الأنابيب وإعداداته يعودان سليمين

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

  • فقدان كلمة مرور المسؤول العشوائية دون حفظها في أي مكان، مما يتطلب إعادة تثبيت كاملة لاستعادة الوصول
  • كشف المنفذ 8244 للإنترنت دون وكيل عكسي منهي لـ TLS أمامه
  • ترميز الأسرار (رموز API، بيانات اعتماد النشر) مباشرة في YAML خط الأنابيب بدلاً من استخدام تكامل مدير بيانات اعتماد
  • توقّع إعداد خطوط الأنابيب عبر واجهة الويب — تُكتب خطوط أنابيب Concourse كـ YAML وتُطبَّق عبر fly CLI، لا تُبنى بصرياً
  • نسيان إزالة الإيقاف المؤقت لخط أنابيب مرفوع حديثاً، فلا يُشغَّل أبداً رغم ضبطه بنجاح
  • تشغيل PostgreSQL دون حجم دائم، مما يُسبّب فقداناً كاملاً لسجل خط الأنابيب والبناء عند إعادة إنشاء الحاوية
  • التقليل من تقدير منحنى التعلّم للفرق القادمة من Jenkins — يتطلب نموذج المورد/المهمة/المهمة الفرعية في Concourse نموذجاً ذهنياً مختلفاً عن معظم أدوات CI التقليدية

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

  • تعذّر تسجيل الدخول بـ fly CLI — تحقق أنك تستخدم العنوان واسم المستخدم وكلمة المرور بالضبط من مخرجات المُثبّت، وأن المنفذ 8244 قابل للوصول
  • خط الأنابيب رُفع لكن لا يُشغَّل أبداً — تحقق ما إذا كان خط الأنابيب متوقفاً مؤقتاً؛ خطوط الأنابيب الجديدة متوقفة مؤقتاً افتراضياً ويجب إزالة إيقافها صراحة بـ fly unpause-pipeline
  • فحص المورد يفشل بصمت — استخدم fly check-resource لتشغيل فحص مورد يدوياً ورؤية مخرج الخطأ الفعلي
  • البناء يفشل فوراً بخطأ إنشاء حاوية — تحقق أن الصورة الأساسية المحدَّدة في إعداد المهمة موجودة وقابلة للسحب من شبكة الحاوية
  • واجهة الويب تُحمَّل لكن رسم خط الأنابيب لا يُحدَّث فورياً — تحقق من مشكلات اتصال WebSocket، خاصة إذا كانت Concourse خلف وكيل عكسي غير مُعدّ لتمرير اتصالات WebSocket
  • أخطاء اتصال PostgreSQL عند البدء — تأكد أن حاوية postgres سليمة وأن متغيرات بيئة اتصال قاعدة البيانات تتطابق بين حاويتي concourse وpostgres
  • أخطاء عدم تطابق إصدار fly CLI — يجب عموماً أن يتطابق (أو يتوافق) إصدار ملف fly التنفيذي مع إصدار سيرفر Concourse؛ نزّل CLI المطابق من واجهة الويب

البدائل

يملك Jenkins إضافات أكثر بكثير ويمكنه فعل أي شيء تقريباً، لكن وكلاءه طويلي الأمد يتراكم عليهم الحالة مع الوقت، وتصبح إدارة الإضافات عبئاً صيانياً خاصاً بها، وغالباً ما تعيش إعدادات خط الأنابيب جزئياً في الواجهة بدلاً من Git بالكامل. تقدّم GitLab CI وGitHub Actions تكاملاً وثيقاً لـ CI/CD إذا كان كودك يعيش بالفعل على تلك المنصات، مقابل بعض المرونة مع تجربة إعداد أكثر سلاسة. Woodpecker CI وDrone أنظمة CI أخف وأصيلة الحاويات شبيهة روحياً بـ Concourse لكن بنموذج YAML أبسط أقرب لصيغة GitHub Actions. Tekton أصيل Kubernetes وخيار جيد إذا كانت بنيتك التحتية تتمحور حول Kubernetes بالفعل، مقابل الحاجة لعنقود Kubernetes للعمل أصلاً. للفرق التي تريد تحديداً أن تعمل كل مهمة بناء في حاوية جديدة وقابلة للتكرار مُعرَّفة بالكامل بـ YAML خط الأنابيب، تبقى Concourse من أكثر التطبيقات تعمّداً لتلك الفكرة.

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

تجاوز Concourse إذا كان فريقك مرتاحاً مع Jenkins ولا يعاني ألماً فعلياً من انحراف الوكلاء أو تضخم الإضافات — ترحيل إعداد CI عامل يحمل تكلفة حقيقية، ونظام إضافات Jenkins يغطي تكاملات أكثر بكثير جاهزة. إذا كنت تبني بالفعل على GitHub أو GitLab وتريد أقل إعداد احتكاكاً، فإن CI/CD المدمج لديهما (GitHub Actions، GitLab CI) سيُشغّلك أسرع ببنية تحتية أقل جدة لتشغيلها. يحمل نموذج المورد/المهمة/المهمة الفرعية في Concourse وسير عمله المرتكز على CLI منحنى تعلّم حقيقياً أيضاً — قد تجد الفرق التي تحتاج تأهيل مساهمين كثر بخبرة CI قليلة أن YAML أبسط شبيه بـ GitHub Actions في Woodpecker CI أسهل للتبني بسرعة. وإذا كانت بنيتك التحتية بالفعل قائمة بالكامل على Kubernetes، فقد يتكامل Tekton بشكل أكثر طبيعية من تشغيل Concourse كنظام منفصل.

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

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

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

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

ما هي Concourse CI؟

Concourse نظام تكامل مستمر مبني حول خطوط أنابيب تصريحية حيث تعمل كل مهمة منفردة في حاوية جديدة تماماً. تُعرَّف خطوط الأنابيب بصيغة YAML كموارد تراقبها ومهام تُشغّلها، تُعرَض كرسم بياني بصري حي.

أي منفذ تستخدم وما هو تسجيل الدخول؟

تعمل Concourse على منفذ المضيف 8244 لكل من واجهة الويب وواجهتها البرمجية. يُنشئ المُثبّت مستخدم مسؤول محلياً على الفريق الرئيسي بكلمة مرور عشوائية ويطبعها عند الانتهاء — لا توجد بيانات اعتماد افتراضية، فالتقط ذلك المخرج.

هل أُعدّ خطوط الأنابيب في واجهة الويب؟

لا — وهذا يُفاجئ القادمين من أنظمة CI أخرى. تُكتب خطوط الأنابيب كـ YAML وتُطبَّق باستخدام أداة سطر الأوامر fly، التي تُنزّلها من رابط في واجهة الويب. يعرض المتصفح حالة خط الأنابيب ومخرجات البناء لكنه ليس مكان تعريفها.

لماذا تعمل كل مهمة في حاوية جديدة؟

إنه القرار التصميمي الأساسي. في أنظمة CI ذات الوكلاء الدائمين، تُثبَّت الأدوات يدوياً وتصبح الذواكر المخبَّأة قديمة إلى أن ينجح البناء أو يفشل لأسباب مدفونة في حالة الجهاز. تشغيل كل مهمة في حاوية نظيفة يعني أن بناءً ناجحاً بدأ من نقطة انطلاق قابلة للتكرار في كل مرة.

كيف تُقارن Concourse بـ Jenkins؟

يملك Jenkins إضافات أكثر بكثير ويمكنه فعل أي شيء تقريباً، لكن وكلاءه طويلي الأمد يتراكم عليهم الحالة، وتصبح إدارة الإضافات عبئاً صيانياً خاصاً بها، وغالباً ما تعيش الإعدادات في الواجهة بدلاً من Git. تُبادل Concourse تلك المرونة بخطوط أنابيب مُعرَّفة بالكامل كـ YAML خاضع للتحكم بالإصدارات ومهام تعمل دائماً في حاوية جديدة قابلة للتكرار، مما يناسب الفرق التي تريد تحديداً ذلك الضمان.