⚡ تثبيت Semaphore — لوحة التحكم وإدارة أتمتة Ansible وTerraform على Docker
نشر منصة Semaphore UI على Ubuntu باستخدام Docker — الواجهة الرسومية مفتوحة المصدر الرائدة لإدارة وتشغيل مهام Ansible وTerraform وسكريبتات Bash مع الصلاحيات والجدولة وسجلات البث المباشر.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/automation/semaphore/semaphore-ubuntu.sh
chmod +x semaphore-ubuntu.sh
sudo bash semaphore-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/automation/semaphore/semaphore-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x semaphore-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم لقاعدة البيانات (`./db`) وضبط مفتاح التشفير وتشغيل حاويتي Semaphore وقاعدة البيانات على المنفذ 3000.
sudo bash semaphore-ubuntu.sh
4 تسجيل الدخول وإنشاء أول مهمة Playbook
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:3000. سجل دخولك ببيانات المشرف، وأنشئ مشروعاً، وأضف مفتاح SSH لخزنة المفاتيح، واربط مستودع Git، ونفذ أول مهمة أتمتة بـ Ansible.
http://:3000
# Login with SEMAPHORE_ADMIN / SEMAPHORE_ADMIN_PASSWORD from your .env
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3000 | Semaphore Web UI + API |
| 22 (outbound) | SSH to managed hosts |
نظرة عامة
تعد Semaphore UI (المعروفة سابقاً بـ Ansible Semaphore) واجهة ويب عصرية وفائقة الخفة ولوحة تحكم متكاملة لإدارة وأتمتة البنية التحتية البرمجية. تم تطويرها بلغات Go وVue.js لتوفر بيئة تشغيل وإدارة بصرية لملفات Ansible Playbooks، وتكوينات Terraform وOpenTofu، وسكريبتات Bash، ومشاريع Pulumi. تعمل المنصة عبر المنفذ 3000، وتوفر نظام صلاحيات مستخدمين متقدماً (RBAC)، وخزنة مشفرة لمفاتيح SSH وكلمات مرور sudo، وجدولة آلية للمهام عبر Cron، وتنبيهات فورية عند فشل المهام (Slack وتيليجرام وديسكورد)، مع بث حي مباشر لسجلات الطرفية أثناء التنفيذ.
لماذا تستخدمه
يؤدي تشغيل ملفات Ansible يدوياً من الحواسيب الشخصية إلى اختلاف بيئات العمل، وتشتت مفاتيح SSH الخاصة، وانعدام الرؤية والتوثيق لبقية أعضاء الفريق. وفي حين تتسم منصة Red Hat Ansible Tower / AWX بالضخامة والاستهلاك المفرط للذاكرة (4 إلى 8 جيجابايت RAM) ومتطلبات Kubernetes المعقدة، تعمل Semaphore باستهلاك ضئيل جداً لا يتجاوز 50 ميجابايت على Docker لتمنح فريقك لوحة أتمتة رسومية أنيقة وفائقة السرعة.
متى تحتاجه
- تبحث عن واجهة ويب خفيفة ومفتوحة المصدر كبديل لـ Ansible AWX بدون متطلبات كوبرنيتس المعقدة
- تريد تمكين المطورين أو موظفي الدعم من تنفيذ مهام الأتمتة المعتمدة بنقرة زر واحدة دون الحاجة لمعرفة أوامر الطرفية
- تحتاج إلى خزنة مركزية مشفرة لإدارة مفاتيح SSH الخاصة، وكلمات مرور sudo، وبيانات البيئة لسيرفراتك
- تريد جدولة مهام الصيانة والتحديثات الدورية (تحديثات السيرفرات الأمنية، الفحص الدوري) آلياً عبر Cron
- تحتاج إلى سجل تدقيق ومتابعة حية ومباشرة لكافة مهام تعديل البنية التحتية مع حفظ السجلات التاريخية
من يحتاجه
- مهندسو الـ DevOps ومديرو النظم لإدارة وتحديث مئات الخوادم المركزية عبر مهام Ansible المؤتمتة
- مديرو البنية التحتية لتفويض مهام التشغيل اليومية لموظفي الدعم الفني دون مشاركة مفاتيح SSH الجذرية
- فرق التطوير البرمجي لتشغيل مهام النشر على بيئات الإنتاج عبر استدعاءات Webhooks وREST API
- أصحاب السيرفرات المنزلية لإدارة سيرفرات Proxmox وUbuntu وDebian بمهام أتمتة موحدة
- شركات إدارة خدمات تقنية المعلومات (MSPs) لإدارة مشاريع عملاء متعددين مع عزل الصلاحيات
حالات الاستخدام الشائعة
- جدولة مهمة أسبوعية لتحديث حزم الأمان على 50 سيرفر إنتاج تلقائياً في تمام الساعة 3:00 صباحاً
- توفير زر 'Deploy Staging' للمطورين لنشر أحدث كود على بيئة التجارب بنقرة زر دون منحهم صلاحيات SSH
- تنفيذ مهام بناء البنية التحتية السحابية عبر Terraform / OpenTofu ومتابعة النتائج حياً بالمتصفح
- إطلاق مهام الاستجابة للحوادث الطارئة تلقائياً فور استلام تنبيهات المراقبة عبر خطافات الـ Webhooks
- حفظ وإدارة مفاتيح SSH الخاصة بالمؤسسة بأمان فائق داخل خزنة المفاتيح المشفرة
الميزات الرئيسية
- دعم محركات أتمتة متعددة: تشغيل Ansible وTerraform وOpenTofu وسكريبتات Bash وPulumi من واجهة موحدة
- نظام تحكم بالصلاحيات (RBAC): إنشاء مشاريع معزولة، وتعيين أدوار المشرفين والأعضاء، وتقييد صلاحيات المهام
- خزنة مفاتيح مشفرة: إدارة وتخزين مفاتيح SSH، وكلمات المرور، وتوكنات API بتشفير AES-256 محكم
- تكامل مع مستودعات Git: سحب ملفات Playbooks آلياً من GitHub أو GitLab أو Gitea أو السيرفرات الخاصة
- بث حي للسجلات: متابعة تنفيذ الأوامر لحظياً بنصوص ملونة مع حفظ وتوثيق مخرجات كافة المهام السابقة
- مجدول مهام Cron مدمج: جدولة مهام الصيانة المتكررة للعمل في أوقات وأيام محددة بدقة
- تنبيهات فورية متعددة القنوات: إرسال تقارير نجاح أو فشل المهام لـ Telegram وSlack وDiscord والبريد
- معمارية Docker Compose تجمع Semaphore مع MySQL 8.0 أو PostgreSQL على مجلدات حفظ دائم
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:3000 لعرض واجهة تسجيل دخول Semaphore
- سجل الدخول باسم المستخدم وكلمة المرور للمشرف التي أنشأتها أثناء تشغيل السكريبت
- أنشئ مشروعاً جديداً (مثل 'خوادم الإنتاج' أو 'السيرفرات المنزلية')
- انتقل إلى Key Store وأضف مفتاح SSH الخاص (أو كلمة مرور sudo) للاتصال بالسيرفرات
- انتقل إلى Repositories واربط مستودع Git الذي يحتوي على ملفات Ansible Playbooks
- انتقل إلى Inventory وحدد عناوين IP لخوادمك المستهدفة
- أنشئ قالب مهمة (Task Template) واضغط 'Run' وشاهد تنفيذ الأوامر بالبث الحي في المتصفح
- ضع Semaphore خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
أفضل ممارسات الأمان
- تنبيه أمني حاسم: استخدم تشفير HTTPS دائماً في الإنتاج — لحماية بيانات الاعتماد وتوكنات المهام أثناء النقل
- عيّن مفتاح تشفير عشوائياً قوياً بحجم 32 بايت (`SEMAPHORE_ENCRYPTION_KEY`) لتشفير مفاتيح SSH بقاعدة البيانات
- أبقِ منفذ قاعدة البيانات 3306/5432 معزولاً داخل شبكة Docker ولا تكشفه للإنترنت العام
- فعل المصادقة الثنائية (2FA) لكافة حسابات المستخدمين من إعدادات الملف الشخصي
- احمِ مجلدي البيانات `./db` والإعدادات `./config` بصلاحيات نظام مناسبة بالسيرفر
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار
المنافذ وإعدادات جدار الحماية
يقدم Semaphore واجهته البرمجية ولوحة التحكم وخادم بث السجلات WebSocket عبر منفذ TCP 3000. كما يتطلب إمكانية الاتصال الخارجي بمنفذ SSH 22 للوصول إلى السيرفرات المدارة. في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 مع تفعيل ترقية WebSocket ووجهه لمنفذ 3000، مع إبقاء المنفذ 3000 مغلقاً خارجياً.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./db` احتياطياً، والذي يحتوي على قاعدة البيانات بكافة المشاريع، وقوالب المهام، والمفاتيح المشفرة
- احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على `SEMAPHORE_ENCRYPTION_KEY` (بدون هذا المفتاح لن تتمكن من فك تشفير البيانات)
- استخرج نسخة احتياطية دورية لقاعدة البيانات عبر mysqldump: `docker exec semaphore-db mysqldump -u semaphore -p<password> semaphore > semaphore_backup.sql`
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية والتأكد من فك تشفير مفاتيح الـ SSH بنجاح
الأخطاء الشائعة
- فقدان متغير البيئة `SEMAPHORE_ENCRYPTION_KEY` مما يؤدي إلى تلف واستحالة قراءة كافة مفاتيح SSH وكلمات المرور المخزنة
- التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر بدون شهادة SSL
- نسيان تثبيت مجموعات Ansible الإضافية المطلوبة (مثل `community.general`) في ملف متطلبات المهام
- عدم ربط مجلد التخزين الدائم `./db`، مما يسبب فقدان المشاريع وسجلات المهام عند تحديث الحاوية
- كشف منافذ قواعد البيانات للإنترنت العام مباشرة
استكشاف الأخطاء وإصلاحها
- فشل اتصال SSH بالسيرفرات المدارة — تأكد من إضافة المفتاح العام لـ Semaphore في ملف `~/.ssh/authorized_keys` بالسيرفر الهدف
- فشل المهمة وظهور 'Host key verification failed' — عطل فحص بصمة المضيف في متغيرات Ansible أو اضبط known_hosts
- ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs semaphore -f`
- خطأ الاتصال بقاعدة البيانات عند التثبيت — تأكد من عمل حاوية قاعدة البيانات وصحة بيانات الدخول في Compose
- السجلات الحية لا تظهر في الوقت الفعلي — تأكد من تهيئة ترويسات ترقية WebSocket في إعدادات Nginx (`Upgrade $http_upgrade`)
البدائل
منصة Ansible AWX الرسمية من ريد هات. منصة Rundeck لأتمتة سير العمل. خادم Jenkins مع إضافات Ansible. خطوط أنابيب GitHub Actions وGitLab CI. منصة Terraform Cloud السحابية.
متى لا تستخدمه
تجنب استخدام Semaphore إذا كنت تحتاج لمنظومة أتمتة مؤسسية عملاقة تشمل مزامنة فرق العمل مع خوادم LDAP المعقدة وعشرات الآلاف من السيرفرات بتدفقات عمل متشعبة (حيث صُممت منصة AWX / Red Hat AAP للمؤسسات الضخمة جداً). وإذا كنت تحتاج فقط لمنظومة CI/CD لبناء واختبار الأكواد، فإن GitLab CI أو GitHub Actions أكثر ملاءمة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي منصة Semaphore UI وكيف تقارن بـ Ansible AWX؟
تعد Semaphore UI واجهة ويب عصرية وخفيفة لإدارة Ansible وTerraform وBash. وخلافاً لـ AWX التي تتطلب عنقود كوبرنيتس ضخماً وما لا يقل عن 4 إلى 8 جيجابايت RAM، تعمل Semaphore بحجم 50 ميجابايت فقط على Docker بإعداد بسيط وسريع.
هل يدعم Semaphore تشغيل ملفات Terraform وOpenTofu؟
نعم! بالإضافة إلى Ansible، يدعم Semaphore أصلياً تشغيل مشاريع Terraform وOpenTofu وسكريبتات Bash ومشاريع Pulumi مباشرة من الواجهة الرسومية.
كيف يحفظ Semaphore مفاتيح SSH وكلمات المرور بأمان؟
يقوم Semaphore بتخزين مفاتيح SSH الخاصة، وعبارات المرور، وبيانات الاعتماد داخل قاعدة البيانات مشفرة بخوارزمية AES-256 باستخدام مفتاح التشفير الرئيسي `SEMAPHORE_ENCRYPTION_KEY`.
هل يمكن تشغيل مهام Semaphore تلقائياً عبر GitHub أو الـ Webhooks؟
نعم! يوفر كل قالب مهمة في Semaphore رابط Webhook ونقطة نهاية REST API مخصصة تتيح لك تشغيل المهام آلياً فور حدوث أي حدث في GitHub أو أنظمة المراقبة.
كم يستهلك Semaphore من الذاكرة العشوائية (RAM)؟
تم تطوير Semaphore بلغة Go وهي فائقة الخفة، حيث تستهلك عادة ما بين 30 إلى 70 ميجابايت فقط من الذاكرة العشوائية داخل Docker، بجانب استهلاك قاعدة البيانات لحوالي 100 ميجابايت.
