يتيح لك تبويب المكونات الإضافية إرفاق قاعدة بيانات PostgreSQL مُدارة أو نسخة Redis مُدارة بموقع دون بناء أو صيانة خادم لها. تتولى KapsuleHost توفيرها، وتمنحك سلسلة اتصال، وتزيلها بشكل نظيف عند إلغائها.
أين تجد المكونات الإضافية
افتح المواقع، وانقر على الموقع، ثم افتح مجموعة التطبيقات في القائمة اليسرى للموقع، واختر الإضافات. عنوان الصفحة هو المكونات الإضافية المُدارة.
يتوفر خياران في الكتالوج:
| المكوّن الإضافي | الاستخدام النموذجي |
|---|---|
| PostgreSQL | مخزن البيانات الأساسي لتطبيق لا يعمل على MySQL |
| Redis | التخزين المؤقت، وتخزين الجلسات، وقوائم انتظار المهام الخلفية |
هذه منفصلة عن قاعدة بيانات MySQL التي تأتي مع موقع الاستضافة القياسي. تلك موجودة في تبويب قاعدة البيانات ولا تحتاج إلى توفير: راجع الاتصال بقاعدة بياناتك عبر نفق SSH.
طلب مكوّن إضافي
- ابحث عن المكوّن الإضافي في قسم إضافة قاعدة بيانات مُدارة.
- انقر على إضافة إلى الموقع.
يُسجَّل الطلب فورًا، ويظهر المكوّن الإضافي في المكونات الإضافية الخاصة بك بشارة PENDING وملاحظة في انتظار الموفِّر. تُحدِّث الصفحة نفسها تلقائيًا كل خمس عشرة ثانية، لذا يمكنك تركها مفتوحة.
تلتقط مهمة خلفية الطلبات المعلّقة كل بضع دقائق، وتُنشئ قاعدة بيانات مخصصة ومستخدمًا مخصصًا لموقعك، وتكتب سلسلة اتصال مشفّرة. بعدها تتحول الحالة إلى ACTIVE.
يتطلب طلب مكوّن إضافي أو إزالته صلاحية sites:write. يمكن لأعضاء الفريق ذوي صلاحية القراءة فقط رؤية المكونات الإضافية الموجودة وحالتها، لكن الأزرار تكون مخفية عنهم.
واحد من كل نوع، لكل موقع
يمكن أن يحتوي الموقع على مكوّن إضافي واحد من PostgreSQL ومكوّن إضافي واحد من Redis. إذا طلبت نوعًا ثانيًا من النوع نفسه، يُرفض الطلب برسالة تفيد بأنه موفَّر بالفعل، ويُخفي الكتالوج الخيار بمجرد تثبيته. وعندما يُثبَّت كلاهما، يظهر في قسم الكتالوج النص All available addons are installed.
قراءة الحالة
| الحالة | المعنى |
|---|---|
| PENDING | تم الطلب، في انتظار الدور لدى الموفِّر |
| PROVISIONING | قيد الإنشاء الآن |
| ACTIVE | جاهز للاستخدام |
| FAILED | لم يكتمل التوفير؛ يظهر السبب في الصف |
| DELETED | تمت إزالته، ولم يعد مدرجًا |
يعرض صف FAILED نص الخطأ الفعلي أسفله بدلًا من رسالة عامة. إذا لم يكن السبب شيئًا يمكنك التصرف حياله، فاقتبسه حرفيًا في تذكرة دعم: راجع فتح تذكرة دعم.
الحصول على سلسلة الاتصال
بمجرد أن يصبح المكوّن الإضافي ACTIVE، يعرض صفه سلسلة اتصال مموَّهة تُستبدل فيها كلمة المرور بنقاط، بحيث يمكنك التأكد من المضيف واسم قاعدة البيانات بنظرة سريعة دون كشف بيانات الاعتماد.
انقر على نسخ الاتصال لوضع سلسلة الاتصال الكاملة في الحافظة. تُفَك تشفيرها من جانب الخادم لذلك الطلب الواحد فقط، ولا تُطبع أبدًا على الصفحة، بحيث لا تتسرب عبر مشاركة الشاشة أو لقطات الشاشة. يُسجَّل كل كشف في سجل تدقيق الموقع ويظهر في سجل نشاط الموقع.
السلسلة بالصيغة المعتادة لعنوان URL الخاصة بكل محرك، وتحمل المضيف والمنفذ والمستخدم وكلمة المرور واسم قاعدة البيانات التي أُنشئت لهذا الموقع.
استخدامها في تطبيقك
الصق سلسلة الاتصال في المكان الذي يقرأ منه تطبيقك إعداداته. في موقع Node.js، المكان الصحيح لها هو تبويب Secrets، ضمن مفتاح مثل DATABASE_URL أو REDIS_URL، في بيئة production.
لا تضع سلسلة الاتصال مباشرة في ملف تقوم برفعه (commit). فهي تحتوي على كلمة مرور فعلية. إذا وصلت إلى مستودع git عن بُعد، يجب التعامل معها على أنها متسربة، والحل الحقيقي الوحيد هو حذف المكوّن الإضافي وطلب واحد جديد، لأن بيانات الاعتماد لا يمكن تدويرها في مكانها من لوحة التحكم.
إزالة مكوّن إضافي
انقر على Delete في الصف. يطلب منك KPanel التأكيد، ويوضح بصراحة ما سيحدث: هذا يزيل قاعدة البيانات المُدارة، والبيانات غير قابلة للاسترجاع.
يُعلَّم الصف كمحذوف فورًا، ويزيل الموفِّر قاعدة البيانات والمستخدم الأساسيين في دورته التالية. تُنهى الاتصالات القائمة كجزء من عملية الإزالة هذه.
لا تُؤخذ نسخة احتياطية من مكوّن إضافي مُدار عند حذفه، ولا يوجد تراجع. إذا كان هناك أي شيء فيه تريد الاحتفاظ به، فقم بتفريغه (dump) أولًا باستخدام pg_dump أو redis-cli --rdb بينما لا يزال المكوّن الإضافي نشطًا وسلسلة الاتصال لا تزال تعمل.
الاختيار بين الخيارين
استخدم PostgreSQL عندما يحتاج تطبيقك إلى قاعدة بيانات علائقية وهو مكتوب للعمل مع Postgres: قيود قوية، معاملات، أعمدة JSON، وبحث نصي كامل كان عليك إضافته بطريقة أخرى.
استخدم Redis للأشياء التي يُسمح لها بالاختفاء: الأجزاء المخزنة مؤقتًا، وعدادات تحديد المعدل، وتخزين الجلسات، وقوائم انتظار المهام. تعامل معه كشيء سريع وعابر، لا كنظام سجلات أساسي.
استخدم قاعدة بيانات MySQL المدمجة لمواقع WordPress ولأي شيء مكتوب أصلًا للعمل مع MySQL. إضافة مكوّن Postgres إلى موقع WordPress لا تُجدي نفعًا، لأن WordPress لا يستطيع التواصل معها.
استكشاف الأخطاء وإصلاحها
المكوّن الإضافي عالق في حالة PENDING لفترة طويلة. يعمل الموفِّر وفق جدول زمني وليس فوريًا. اترك الصفحة مفتوحة، لأنها تُحدِّث نفسها، وتحقق لاحقًا. إذا لم يتغير الوضع بعد عدة دورات، افتح تذكرة دعم مع نطاق الموقع ونوع المكوّن الإضافي.
فشل التوفير (FAILED). اقرأ الخطأ في الصف. احذف المكوّن الإضافي الفاشل واطلبه مرة أخرى، وهذا آمن: فالصف الفاشل لم تكن خلفه قط قاعدة بيانات فعلية.
نسخ الاتصال لا يفعل شيئًا. بعض المتصفحات تمنع الكتابة إلى الحافظة عندما لا يكون التبويب نشطًا. انقر على الصفحة أولًا، ثم انقر على الزر مرة أخرى.
التطبيق لا يستطيع الاتصال. تحقق من ثلاثة أمور بالترتيب: أن حالة المكوّن الإضافي ACTIVE، وأنك نسخت السلسلة بدلًا من إعادة كتابتها، وأن تطبيقك يقرأ القيمة التي ضبطتها فعليًا وليس قيمة قديمة من عملية نشر سابقة. عادة ما يلزم إعادة التشغيل قبل أن يُؤخذ الإعداد الجديد بالاعتبار.
تُرفض الاتصالات بعد إعادة النشر. تأكد من أن سلسلة الاتصال في إعداداتك لا تزال مطابقة لتلك الموجودة في هذه الصفحة. حذف مكوّن إضافي وإعادة طلبه ينشئ مستخدمًا جديدًا وكلمة مرور جديدة، لذا لن تعمل السلسلة القديمة.
إلى أين تذهب بعد ذلك
- تخزين أسرار التطبيق لموقع، المكان الصحيح للاحتفاظ بسلسلة الاتصال.
- الاتصال بقاعدة بياناتك عبر نفق SSH لقاعدة بيانات MySQL المدمجة.
- إعدادات الموقع لبقية إعدادات الموقع.