👨‍💻 تثبيت Bytebase — CI/CD لقواعد البيانات وترحيل المخططات

انشر Bytebase على Ubuntu بـ Docker — منصة DevOps لقواعد البيانات تجلب التحكم بالإصدارات والمراجعة وCI/CD آمناً لتغييرات المخطط عبر قواعد بياناتك، على المنفذ 8243.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر Bytebase على المنفذ 8243 بقاعدة بيانات مدمجة. سجّل الحساب الأول لتصبح مشرف مساحة العمل.
عرض على GitHub

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

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

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

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

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

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

chmod +x bytebase-ubuntu.sh

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

./bytebase-ubuntu.sh

4 تسجيل الحساب الأول

http://your-server-ip:8243

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

المنفذالغرض
8243Bytebase web interface (mapped from container port 8080)

نظرة عامة

Bytebase منصة DevOps وCI/CD مفتوحة المصدر لقواعد البيانات تجلب نفس انضباط المراجعة والتحكم بالإصدارات والطرح الآمن الذي تطبّقه فرق البرمجة على كود التطبيقات إلى تغييرات مخطط قاعدة البيانات. بدلاً من تشغيل الترحيلات يدوياً أو الثقة بسكريبت محلي لمطور، تمرّ تغييرات المخطط عبر سير عمل محدد — تُقترح كتغيير، يراجعها زميل أو مراجع SQL، وتُطرح مع سجل تدقيق كامل عبر بيئاتك.

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

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

متى تحتاجه

  • يطبّق فريقك حالياً ترحيلات قاعدة البيانات بتشغيل سكريبتات يدوياً أو بالثقة بتغييرات محلية لمطورين أفراد
  • تحتاج خطوة مراجعة وموافقة لتغييرات المخطط قبل وصولها للإنتاج، مشابهة لطلب سحب (pull request) للكود
  • تدير عدة بيئات قواعد بيانات (تطوير، اختبار، إنتاج) وتحتاج طرحاً متسقاً ومتتبَّعاً عبر جميعها
  • تريد سجل تدقيق كاملاً لمن غيّر أي مخطط، ومتى، ولماذا، لأغراض الامتثال أو التحقيق في الحوادث
  • تدعم عدة محركات قواعد بيانات (MySQL وPostgreSQL وغيرها) وتريد أداة واحدة متسقة عبرها جميعاً
  • تنتقل من سكريبتات ترحيل مرتجلة نحو عملية تغيير قاعدة بيانات بأسلوب GitOps ومتحكم بإصدارها

من يحتاجه

  • مديرو قواعد البيانات الذين يحتاجون رؤية وتحكماً في تغييرات المخطط عبر قواعد بيانات وفرق كثيرة
  • فرق هندسة الخلفية التي تريد مراجعة الترحيلات بنفس الطريقة التي تُراجَع بها طلبات سحب كود التطبيقات
  • فرق المنصات وDevOps التي تبني خطوط CI/CD تحتاج خطوة محكومة لتغييرات مخطط قاعدة البيانات
  • الشركات الناشئة والمؤسسات الصغيرة والمتوسطة التي ليس لديها مدير قواعد بيانات مخصص لكنها تحتاج إدارة تغيير مخطط آمنة وقابلة للتدقيق
  • المنظمات المهتمة بالامتثال التي تحتاج سجل تدقيق يثبت من وافق على كل تغيير مخطط ونفّذه
  • الفرق التي تدير عدة محركات قواعد بيانات تحت سقف واحد وتريد طبقة حوكمة واحدة بدلاً من أدوات لكل محرك

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

  • مراجعة والموافقة على ترحيل مخطط قبل تطبيقه على قاعدة بيانات إنتاج
  • تتبّع تاريخ كامل لكل تغيير مخطط تم في بيئات التطوير والاختبار والإنتاج
  • تشغيل فحوصات مراجعة SQL تلقائياً وفق قواعد أمان وأسلوب يحددها الفريق قبل السماح بمرور الترحيل
  • تنسيق طرح المخطط عبر عدة نسخ أو أجزاء (shards) من قاعدة البيانات من طلب تغيير واحد
  • منح وصول محدود أو للقراءة فقط عبر محرر SQL للمطورين دون منحهم بيانات اعتماد قاعدة بيانات إنتاج خام
  • تدقيق من نفّذ تغيير مخطط معين أثناء تحليل ما بعد حادثة

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

  • ترحيلات مخطط متحكم بإصدارها بسير عمل مراجعة وموافقة قبل التنفيذ
  • دعم واسع لمحركات قواعد البيانات يشمل MySQL وPostgreSQL وTiDB وSnowflake وClickHouse وMongoDB وOracle وMSSQL
  • قواعد مراجعة SQL مدمجة تلتقط الترحيلات الخطرة (فهارس مفقودة، أقفال غير آمنة، عبارات تدميرية) قبل الطرح
  • محرر SQL لتشغيل ومراجعة الاستعلامات بوصول محدود قائم على الأدوار بدلاً من مشاركة بيانات اعتماد قاعدة البيانات الخام
  • سجل تدقيق كامل لكل تغيير مخطط، من اقترحه، من وافق عليه، ومتى نُفّذ
  • دعم سير عمل بأسلوب GitOps بحيث يمكن أن تنشأ تغييرات المخطط من ملفات ترحيل متحكم بإصدارها
  • طرح واعٍ بالبيئة، يتيح لتغيير مراجَع واحد الانتقال عبر التطوير والاختبار والإنتاج
  • مساحة عمل ويب مع تحكم بالوصول قائم على الأدوار للمطورين والمراجعين والمديرين

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

  • سجّل الحساب الأول على http://your-server-ip:8243 — يصبح تلقائياً مشرف مساحة العمل
  • أضف نسخ قواعد بياناتك (MySQL أو PostgreSQL أو غيرها) تحت قسم Instances ببيانات اعتماد الاتصال
  • أنشئ مشروعاً لتجميع قواعد البيانات ذات الصلة وتحديد من يمكنه اقتراح تغييرات والموافقة عليها
  • ادعُ أعضاء الفريق وخصّص أدواراً (Owner، DBA، Developer) تطابق عملية المراجعة والموافقة الفعلية لديك
  • أعدّ سياسات مراجعة SQL لفرض قواعد أمان الترحيل الخاصة بفريقك تلقائياً على كل تغيير مقترح
  • أرسل تغيير مخطط تجريبي من البداية للنهاية للتأكد من أن سير عمل المراجعة-الموافقة-الطرح يعمل كما هو متوقع
  • اربط خط CI/CD لديك أو نظام التحكم بالإصدارات إذا أردت أن تنشأ الترحيلات من ملفات SQL مُودَعة
  • أعدّ نسخاً احتياطية مجدولة لحجم ./data الذي يحمل قاعدة بيانات Bytebase الوصفية المدمجة

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

  • لا تكشف المنفذ 8243 مباشرة للإنترنت دون وكيل عكسي يضيف HTTPS أبداً — ستنتقل بيانات الاعتماد وبيانات المخطط دون تشفير
  • استخدم بيانات اعتماد قاعدة بيانات محدودة الصلاحيات لكل نسخة يتصل بها Bytebase، وليس حساب مستخدم فائق مشتركاً
  • خصّص الأدوار بعناية — ليس كل عضو فريق يحتاج صلاحية DBA أو Owner للموافقة على تغييرات المخطط وتنفيذها
  • راجع سجل التدقيق دورياً للتأكد من أن المستخدمين المتوقعين فقط هم من يقترحون ويوافقون على تغييرات المخطط
  • أعد توليد بيانات اعتماد نسخة قاعدة البيانات المخزّنة في Bytebase إن شككت يوماً بتسريبها
  • حافظ على تحديث صورة Bytebase Docker لتلقّي إصلاحات الأمان للمنصة ومحرك مراجعة SQL الخاص بها
  • قيّد وصول محرر SQL للأدوار غير التابعة لـ DBA إلى القراءة فقط أو الاستعلام فقط حيثما يسمح سير عملك
  • انسخ احتياطياً قاعدة البيانات الوصفية المدمجة قبل كل ترقية إصدار لـ Bytebase

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

يستمع Bytebase على منفذ الحاوية 8080، المعيّن للمنفذ المضيف 8243 في هذا النشر. يخدم هذا المنفذ واجهة الويب والـ API معاً، ويجب ألا يُكشف مباشرة للإنترنت العام — ضع وكيلاً عكسياً مثل Nginx Proxy Manager أو Caddy أمامه لإضافة HTTPS قبل السماح بالوصول الخارجي. إذا كان Bytebase يحتاج الوصول من فريقك الداخلي فقط، فكّر في تقييد الوصول أكثر بـ VPN أو قائمة IP مسموحة بدلاً من كشفه علناً على الإطلاق.

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

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

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

  • كشف المنفذ 8243 مباشرة للإنترنت دون وكيل عكسي وHTTPS أمامه
  • ربط Bytebase بحساب مستخدم فائق مشترك بدلاً من بيانات اعتماد محدودة الصلاحيات لكل نسخة
  • افتراض أن Bytebase نفسه ينسخ احتياطياً قواعد البيانات التي يديرها — إنه يدير الترحيلات فقط، وليس البيانات الأساسية
  • تجاهل إعداد سياسة مراجعة SQL، مما يسمح بمرور ترحيلات خطرة (مثل تعديل جدول كبير بلا فهرسة) دون مراجعة
  • منح كل عضو فريق أدوار Owner أو DBA بدلاً من مطابقة الأدوار مع مسؤوليات المراجعة الفعلية
  • عدم نسخ حجم ./data احتياطياً قبل ترقية إصدار، مما يخاطر بفقدان تاريخ المشروع وسجلات التدقيق
  • التعامل مع Bytebase كأداة استعلام للتحليلات العشوائية بدلاً من منصة ترحيل ومراجعة محكومة
  • نسيان تسجيل الحساب الأول بسرعة — أول من يسجّل يصبح مشرف مساحة العمل

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

  • تعذّر الوصول لواجهة الويب — تأكد من تشغيل الحاوية وأن المنفذ 8243 (أو وكيلك العكسي) قابل للوصول وغير محظور بجدار الحماية
  • فشل الاتصال بقاعدة البيانات عند إضافة نسخة — تحقق من أن مضيف قاعدة البيانات ومنفذها وبيانات اعتمادها قابلة للوصول من داخل شبكة حاوية Bytebase
  • قواعد مراجعة SQL لا تحظر ترحيلاً متوقعاً — تحقق من أن سياسة المراجعة مُخصَّصة فعلياً للمشروع الذي ينتمي له الترحيل
  • الترحيل عالق في حالة انتظار — تأكد من أن مُوافقاً بالدور الصحيح راجع التغيير ووافق عليه
  • سجل التدقيق يفتقد إدخالات متوقعة — تحقق من أن الإجراء نُفّذ عبر Bytebase نفسه وليس مباشرة على قاعدة البيانات خارج سير عمله
  • فشل تشغيل الحاوية بعد الترقية — راجع السجلات بحثاً عن أخطاء ترحيل البيانات الوصفية وتأكد من عدم تلف حجم ./data
  • استعلامات محرر SQL بطيئة — تحقق من أداء قاعدة البيانات الهدف نفسها وليس Bytebase، لأنه يمرّر الاستعلامات بدلاً من تنفيذها بنفسه
  • فقدان وصول المشرف — استعد حجم ./data من نسخة احتياطية حديثة، لأن أدوار مساحة العمل مخزّنة في بيانات Bytebase الوصفية

البدائل

Flyway وLiquibase مكتبات ترحيل تدمجها مباشرة في خط البناء الخاص بك — تطبّق ملفات ترحيل مُرقَّمة الإصدار بموثوقية لكنها تترك سير عمل المراجعة وواجهة الويب وحوكمة قواعد البيانات المتعددة لتبنيها بنفسك. Adminer وCloudBeaver عملاء قواعد بيانات لتصفح الجداول وتشغيل SQL مباشرة بدلاً من حوكمة كيفية اقتراح التغييرات والموافقة عليها — يحلّان مشكلة مختلفة تماماً. يقدّم Liquibase Pro ومنصات DevOps التجارية لقواعد البيانات حوكمة مشابهة لـ Bytebase لكن بتكلفة ترخيص؛ يغطّي جوهر Bytebase مفتوح المصدر نفس سير عمل المراجعة والطرح مجاناً. للفرق التي تريد تحديداً المراجعة والموافقة وسجل التدقيق مبنية حول ترحيلات المخطط بواجهة ويب، يبقى Bytebase الخيار الأكثر اكتمالاً.

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

لا تلجأ إلى Bytebase إذا كان كل ما تحتاجه متصفح قاعدة بيانات بسيط لتشغيل استعلامات SQL عشوائية — Adminer أو CloudBeaver أخف وزناً لذلك. إذا كان فريقك يملك بالفعل خط CI/CD ناضجاً يستخدم Flyway أو Liquibase ويحتاج فقط تطبيق ملفات الترحيل بموثوقية، فإن إضافة طبقة مراجعة Bytebase قد تكون حوكمة أكثر مما يحتاجه فريق صغير فعلياً. وإذا كنت تدير قاعدة بيانات صغيرة واحدة فقط بمطور واحد، فإن سير عمل المراجعة والموافقة على الأرجح عبء لا تحتاجه بعد — أدخله عندما ينمو الفريق ويزداد خطر التغييرات غير المراجَعة.

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

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

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

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

ما هو Bytebase؟

Bytebase منصة DevOps وCI/CD لقواعد البيانات. تجلب التحكم بالإصدارات والمراجعة والطرح الآمن لتغييرات مخطط قاعدة البيانات — نفس الانضباط الذي تطبّقه الفرق على كود التطبيقات.

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

يعمل Bytebase على المنفذ المضيف 8243. لا يوجد تسجيل دخول افتراضي — تسجّل الحساب الأول عند أول زيارة، ويصبح هذا الحساب تلقائياً مشرف مساحة العمل.

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

ليس لهذا النشر. يستخدم Bytebase قاعدة بيانات مدمجة تناسب الإعدادات الصغيرة، فلا حاجة لإعداد أي شيء إضافي وتعيش بياناته الوصفية في حجم ./data.

كيف يختلف عن Flyway أو Liquibase؟

Flyway وLiquibase مكتبات ترحيل تدمجها في خط الأنابيب الخاص بك — تطبّق ملفات ترحيل مُرقَّمة الإصدار جيداً لكنها تترك المراجعة والموافقة وواجهة الويب وحوكمة قواعد البيانات المتعددة لتبنيها بنفسك.

هل Bytebase عميل قاعدة بيانات مثل Adminer؟

لا — يحلّان مشكلتين مختلفتين. Adminer وCloudBeaver واجهات استعلام لتصفح الجداول وتشغيل SQL مباشرة. يحكم Bytebase كيفية اقتراح تغييرات المخطط ومراجعتها والموافقة عليها وطرحها عبر البيئات، مع سجل تدقيق.