تخطي للذهاب إلى المحتوى

توثيق وحدة مدير المستودعات والخوادم لأودو

كيفية التثبيت والإعداد


تعمل هذه الوحدة على أنظمة لينكس فقط، وتم اختبارها على Debian 12 وCentOS 8


Before we start Please prepare this requirements 

الخادم الرئيسي

جميع الخطوات إلزامية، ولن تعمل الوحدة بدونها

  1. ثبّت حزمة Python المسماة paramiko (pip install paramiko)
  2. ارفع الوحدة (sadeem_server_git_manager) إلى مجلد الإضافات (addons) في تثبيت أودو الخاص بك
  3. أعد تشغيل خدمة أودو


تثبيت الوحدة
  1. فعّل وضع المطوّر: اذهب إلى الإعدادات وانزل لأسفل ثم اضغط تفعيل وضع المطوّر
  2. اذهب إلى قائمة التطبيقات واضغط تحديث قائمة التطبيقات ثم اضغط تحديث
  3.  ابحث عن "sadeem_server_git_manager" ثم اضغط تفعيل/تثبيت
  4. بعد تثبيت الوحدة، امنح المستخدم الصلاحيات اللازمة لإدارة وحدة مدير المستودعات والخوادم

أنت الآن جاهز لإعداد الوحدة

إعداد الوحدة


بعد تثبيت الوحدة بنجاح والحصول على الصلاحيات اللازمة، حدّث الصفحة لتظهر الوحدة الجديدة

 1- افتح قائمة الوحدة



أضف أول خادم 

اذهب إلى >> قائمة الخوادم واضغط زر جديد لإنشاء خادم



  1. تأكيد الخادم
  2. إلغاء الخادم
  3. اسم الخادم
  4. عنوان IP للخادم
  5. اسم مستخدم SSH
  6. منفذ SSH
  7. تشغيل الأوامر على هذا الخادم باستخدام "sudo"
  8. أمر إعادة تشغيل الخدمة الافتراضي، مثل service odoo restart
  9. مجلد الإضافات (addons) الافتراضي
  10. دولة الخادم
  11. منطقة الخادم
  12. كلمة مرور الخادم إذا كنت تستخدم كلمة مرور
  13. مفتاح الخادم إذا كنت تتصل باستخدام مفتاح

إذا فعّلت "sudo" فسيُنفّذ كل أمر على هذا الخادم مسبوقًا بـ sudo

وإذا فعّلت sudo فيجب إدخال كلمة المرور، وإلا لن يتم تأكيد الخادم


إذا أدخلت المفتاح وكلمة المرور معًا فستستخدم الوحدة المفتاح فقط، لذلك أدخل طريقة الاتصال الصحيحة


  1. إعادة إلى مسودة
  2. إلغاء الخادم
  3. تثبيت المتطلبات
  4. حالة الخادم

عند الضغط على "تثبيت المتطلبات" تُثبّت الحزم المطلوبة على الخادم البعيد

وحاليًا المطلوب هو "git" فقط


أضف أول حساب Git 

اذهب إلى >> قائمة حسابات Git واضغط زر جديد لإنشاء حساب



  1. اسم مستخدم الحساب
  2. رمز الوصول (Access token)
  3. ملاحظات

كيف تنشئ رمز وصول في GitHub


افتح حسابك في GitHub، ومن الإعدادات افتح Developer settings ثم Personal access tokens

اكتب ملاحظاتك واختر مدة الصلاحية

واختر صلاحيات repo الكاملة لتتمكن من الوصول إلى المستودعات الخاصة.



أضف أول مستودع 

اذهب إلى >> قائمة المستودعات واضغط زر جديد لإنشاء مستودع




  1. قائمة المستودعات
  2. اسم المستودع
  3. حساب GitHub الذي لديه صلاحية الوصول إلى هذا المستودع
  4. الفرع (Branch)
  5. تفعيل Queue Job، وهذا الخيار مخصص للمستودعات الكبيرة والعدد الكبير من الخوادم
  6. آخر Commit تم سحبه من هذا المستودع
  7. رسالة آخر Commit
  8. صاحب آخر Commit
  9. سطور الخوادم: أضف هنا كل الخوادم التي تريد ربطها بهذا المستودع
  10. حالة Webhook المستودع


تفعيل Queue Job يتطلب وحدة إضافية تجدها هنا

https://apps.odoo.com/apps/modules/17.0/queue_job/

يرجى تثبيت هذه الوحدة قبل تفعيل الخيار، والتأكد من إعدادها بشكل صحيح وأنها تعمل




  1.  هذا الخيار يعيد تشغيل الخدمة على هذا الخادم تلقائيًا عند وصول Commit جديد
  2. يعني أن آخر Commit على هذا الخادم مطابق لآخر Commit في المستودع
  3. فك ربط Webhook
  4. Webhook هذا المستودع غير مرتبط
  5. Webhook هذا المستودع مرتبط



عندما تستقبل الوحدة حدث Webhook جديدًا من Git، تبدأ سحب التحديثات على كل الخوادم المرتبطة بهذا المستودع، وتُسجل كل الإجراءات


توثيق وحدة Simple SaaS لأودو
كيفية تثبيت وإعداد وحدة Simple SaaS