المواقع الإلكترونية
الإضافات المُدارة: Postgres و Redis
The Addons tab lets you attach a managed PostgreSQL database or a managed Redis instance to a site without building or maintaining a server for it. Kapsule provisions it, gives you a connection…
تتيح لك علامة التبويب "الإضافات" إرفاق قاعدة بيانات PostgreSQL مُدارة أو مثيل Redis مُدار بموقع ويب دون الحاجة إلى بناء خادم أو صيانته. يقوم Kapsule بتوفيره، ويعطيك سلسلة اتصال، ويزيله بشكل نظيف عند حذفه.
حيث تعيش الإضافات
افتح المواقع الإلكترونية، انقر على الموقع، افتح قائمة الإعدادات في شريط علامات تبويب الموقع، واختر الإضافات. الصفحة بعنوان الإضافات المُدارة.
هناك خياران في الكتالوج:
| الإضافة | الاستخدام النموذجي |
|---|---|
| PostgreSQL | مخزن البيانات الأساسي لتطبيق لا يعتمد على MySQL |
| Redis | التخزين المؤقت وتخزين الجلسات وطوابير المهام الخلفية |
هذه منفصلة عن قاعدة بيانات MySQL التي تأتي مع موقع استضافة قياسي. هذا موجود في علامة تبويب الملفات، ثم قاعدة البيانات ولا يحتاج إلى توفير: انظر الاتصال بقاعدة البيانات الخاصة بك عبر نفق SSH.
طلب إضافة
- ابحث عن الإضافة في قسم إضافة قاعدة بيانات مُدارة.
- انقر على إضافة إلى الموقع.
يتم تسجيل الطلب فوراً وتظهر الإضافة في الإضافات الخاصة بك مع شارة معلق والملاحظة في انتظار المُوفِّر. تقوم الصفحة بتحديث نفسها كل خمسة عشر ثانية، لذا يمكنك تركها مفتوحة.
تلتقط مهمة خلفية الطلبات المعلقة كل بضع دقائق، وتنشئ قاعدة بيانات مخصصة ومستخدماً مخصصاً لموقعك، وتكتب سلسلة اتصال مشفرة. ينتقل الحالة بعد ذلك إلى نشط.
يتطلب طلب الإضافة أو إزالتها إذن sites:write. يمكن لأعضاء الفريق بصلاحيات القراءة فقط رؤية الإضافات الموجودة وحالتها، لكن الأزرار مخفية.
واحدة من كل نوع، لكل موقع
يمكن لموقع أن يحتوي على إضافة PostgreSQL واحدة وإضافة Redis واحدة. طلب نسخة ثانية من نفس النوع سيتم رفضه برسالة تفيد بأنها مُوفَّرة بالفعل، والكتالوج يخفي خياراً بمجرد تثبيته. عند تثبيت الاثنين معاً، يقرأ قسم الكتالوج تم تثبيت جميع الإضافات المتاحة.
قراءة الحالة
| الحالة | المعنى |
|---|---|
| معلق | مطلوب في قائمة الانتظار للمُوفِّر |
| جاري التوفير | جاري الإنشاء الآن |
| نشط | جاهز للاستخدام |
| فشل | لم يكتمل التوفير؛ يتم عرض السبب على الصف |
| محذوف | تم الحذف، لم يعد مدرجاً |
يُظهر صف فشل نص الخطأ الفعلي تحته بدلاً من رسالة عامة. إذا لم يكن السبب شيئاً يمكنك التعامل معه، اقتبس نصه كما هو في تذكرة الدعم: انظر فتح تذكرة دعم.
الحصول على سلسلة الاتصال
بمجرد أن تصبح إضافة نشطة، يعرض صفها سلسلة اتصال مقنعة مع استبدال كلمة المرور بنقاط، حتى تتمكن من تأكيد المضيف واسم قاعدة البيانات في لمحة دون كشف بيانات الاعتماد.
انقر على نسخ الاتصال لوضع سلسلة الاتصال الكاملة في الحافظة. يتم فك تشفيرها على جانب الخادم لهذا الطلب الواحد ولا تُطبع على الصفحة أبداً، لذا لا تكشف المشاركات والقطات الشاشة عنها. كل كشف مُسجل في مسار التدقيق للموقع ويظهر في سجل نشاط الموقع.
السلسلة بصيغة URL المعتادة لكل محرك، تحمل المضيف والمنفذ والمستخدم وكلمة المرور واسم قاعدة البيانات التي تم إنشاؤها لهذا الموقع.
استخدامها في التطبيق الخاص بك
الصق سلسلة الاتصال في حيث يقرأ التطبيق الخاص بك تكوينه. على موقع Node.js، المكان الصحيح هو علامة التبويب أسرار، تحت مفتاح مثل DATABASE_URL أو REDIS_URL، في بيئة الإنتاج.
لا تضمّن سلسلة الاتصال في ملف تلتزم به. إنها تحتوي على كلمة مرور نشطة. إذا وصلت إلى جهاز تحكم git فيجب أن تعتبر مكشوفة، والحل الحقيقي الوحيد هو حذف الإضافة وطلب واحدة جديدة، لأن بيانات الاعتماد لا يمكن تدويرها في المكان من اللوحة.
إزالة إضافة
انقر على حذف على الصف. يطلب KPanel منك التأكيد ويكون صريحاً جداً حول ما يحدث: هذا يزيل قاعدة البيانات المُدارة، والبيانات غير قابلة للاسترجاع.
يتم وضع علامة على الصف كمحذوف فوراً ويقوم المُوفِّر بإزالة قاعدة البيانات والمستخدم الأساسيين في الممر التالي له. يتم إنهاء الاتصالات الموجودة كجزء من تلك الإزالة.
لا يتم أخذ نسخة احتياطية من إضافة مُدارة عند الحذف، ولا توجد خاصية الإلغاء. إذا كان هناك أي شيء فيها تريد الاحتفاظ به، فقم بتفريغه أولاً باستخدام pg_dump أو redis-cli --rdb بينما تكون الإضافة لا تزال نشطة وسلسلة الاتصال لا تزال تعمل.
الاختيار بين الخيارات
استخدم PostgreSQL عندما يحتاج التطبيق الخاص بك إلى قاعدة بيانات علائقية ومكتوب ضد Postgres: قيود قوية وتحويلات وأعمدة JSON والبحث بنص كامل الذي قد تضطر إلى إضافته بخلاف ذلك.
استخدم Redis للأشياء التي يُسمح لها بالاختفاء: أجزاء مخزنة مؤقتاً وعدادات حد المعدل وتخزين الجلسات وطوابير المهام. تعامل معها كسريعة وغير مستقرة، وليس كنظام سجل.
استخدم قاعدة بيانات MySQL المدمجة من أجل WordPress ولأي شيء مكتوب ضد MySQL بالفعل. إضافة إضافة Postgres إلى موقع WordPress لا تفعل شيئاً مفيداً، لأن WordPress لا يمكنه التحدث معها.
استكشاف الأخطاء
الإضافة معلقة منذ وقت طويل. يعمل المُوفِّر حسب الجدول الزمني وليس فوراً. اترك الصفحة مفتوحة، لأنها تحدث نفسها، وتحقق لاحقاً. إذا لم تتحرك بعد بضع جولات، فافتح تذكرة دعم مع نطاق الموقع ونوع الإضافة.
فشل التوفير. اقرأ الخطأ على الصف. احذف الإضافة الفاشلة واطلب مرة أخرى، وهو آمن: صف فاشل لم يكن أبداً لديه قاعدة بيانات نشطة خلفه.
نسخ الاتصال لا يفعل شيئاً. بعض المتصفحات تحظر عمليات كتابة الحافظة عندما لا تكون علامة التبويب مركزة. انقر على الصفحة أولاً، ثم انقر على الزر مرة أخرى.
التطبيق لا يستطيع الاتصال. تحقق من ثلاثة أشياء بالترتيب: أن حالة الإضافة نشطة، وأنك نسخت السلسلة بدلاً من إعادة كتابتها، وأن التطبيق يقرأ القيمة التي عينتها فعلاً بدلاً من قيمة قديمة من نشر سابق. عادة ما تكون هناك حاجة إلى إعادة تشغيل قبل التقاط التكوين الجديد.
يتم رفض الاتصالات بعد إعادة النشر. أكد أن سلسلة الاتصال في التكوين الخاص بك تطابق الموجودة على هذه الصفحة. حذف وإعادة طلب إضافة ينشئ مستخدماً جديداً وكلمة مرور جديدة، لذا لن تعمل السلسلة القديمة.
الخطوات التالية
- تخزين أسرار التطبيق لموقع، المكان الصحيح للاحتفاظ بسلسلة الاتصال.
- الاتصال بقاعدة البيانات الخاصة بك عبر نفق SSH لقاعدة بيانات MySQL المدمجة.
- إعدادات الموقع لبقية التكوين على مستوى الموقع.