ترقية العلامة التجارية Repovio

تعتبر إعادة التسمية هذه تغييرًا جذريًا في التكوين. قم بتحديث كل متغير بيئة سابق للمنتج إلى البادئة REPOVIO_، بما في ذلك REPOVIO_ENV_FILE، وREPOVIO_VERSION، وREPOVIO_API_PORT، وREPOVIO_WEB_PORT. استخدم واجهة برمجة التطبيقات وصور الويب ضمن ghcr.io/repovio/repovio-api وghcr.io/repovio/repovio-web.

أكمل تغيير العلامة أولًا على الإصدار السابق الذي يستخدم PostgreSQL 17. إعدادات Compose الحالية تستهدف PostgreSQL 18؛ اتبع ترقية PostgreSQL 18 المنفصلة قبل استخدامها. لا تربط ملفات PostgreSQL 17 بخدمة PostgreSQL 18 مطلقًا. الخطوات التالية تستخدم إعدادات PostgreSQL 17 المحفوظة، بما فيها compose.yml وcompose.upgrade.yml. تغيير العلامة وحده لا يحتاج تحويل البيانات؛ ترقية الإصدار الرئيسي عملية منفصلة.

الحفاظ على بيانات PostgreSQL

1. قم بعمل نسخة احتياطية من قاعدة البيانات الموجودة وتأكد من إمكانية استعادة النسخة الاحتياطية قبل تغيير النشر.
2. قم بفحص حاوية PostgreSQL قيد التشغيل باستخدام docker inspect <postgres-container> وقم بتسجيل الحجم المسمى الدقيق المثبت على /var/lib/postgresql/data. قم بإيقاف التطبيق القديم وحاويات PostgreSQL دون حذف وحدات التخزين.
3. قم بتعيين REPOVIO_POSTGRES_VOLUME في بيئة النشر الجديدة على اسم وحدة التخزين بالضبط. تأكد من وجوده باستخدام docker volume inspect <recorded-volume>. الإعداد الافتراضي للتثبيت الجديد هو repovio-postgres؛ ويجب ألا يحل محل وحدة تخزين التثبيت الموجودة عن طريق الخطأ.
4. احتفظ بـ POSTGRES_DB وPOSTGRES_USER وPOSTGRES_PASSWORD وTOKEN_ENCRYPTION_KEY وAUTH_JWT_SECRET دون تغيير. احتفظ بـ PostgreSQL على نفس الإصدار الرئيسي. قم بمراجعة docker compose config على انفراد قبل البدء؛ تحتوي مخرجاتها على أسرار تم حلها ويجب عدم مشاركتها أو الالتزام بها أبدًا.
5. استخدم docker compose -f compose.yml -f compose.upgrade.yml للترقية. يتطلب هذا التجاوز وجود وحدة التخزين المسماة، لذا لا يمكن لوحدة تخزين بها أخطاء إملائية أن تقوم بتهيئة بديل فارغ بصمت. ابدأ تشغيل PostgreSQL أولاً وتحقق من قاعدة البيانات الموجودة، ثم ابدأ خدمة وتطبيق الترحيل. لا تقم مطلقًا بتشغيل docker compose down --volumes أو إزالة وحدة التخزين القديمة أو تهيئة قاعدة بيانات فارغة كجزء من عملية إعادة التسمية هذه.

لا يلزم تحويل البيانات عن طريق العلامة التجارية. تظل بيانات اعتماد قاعدة البيانات ومفتاح التشفير ضرورية لقراءة البيانات الموجودة. يمكن استعادة النشر السابق باستخدام التكوين الخاص به ووحدة التخزين المحتفظ بها؛ تجنب الكتاب المتزامنين.

المصادقة وحالة المتصفح

مُصدر JWT الافتراضي هو الآن repovio؛ قم بتسجيل الدخول مرة أخرى بعد الترقية. يجب أيضًا تحديث المُصدر الذي تم تكوينه بشكل صريح بشكل متعمد. لا يتم استيراد تفضيلات المتصفح الحالية وحالة الإشعارات وملفات تعريف الارتباط ومفاتيح التخزين. حدد لغتك/موضوعك مرة أخرى، وأعد تثبيت PWA إذا لزم الأمر، وأعد تمكين إشعارات المتصفح. تحديث أسماء عرض موفر الهوية وتكوين التطبيقات الخارجية حيثما كان ذلك مناسبًا؛ لا تتغير طرق رد الاتصال. امسح بيانات الموقع القديمة فقط بعد التأكد من عمل التثبيت الجديد.

إبطال الرموز المميزة MCP السابقة وإنشاء بدائل: لا يتم قبول بادئة الرمز المميز المعاد تسميتها كاسم مستعار.