استعِد Immich بعد فشل تحديث الحاوية عبر تجميد الأدلة الحالية، وتثبيت كل خدمات Immich على آخر إصدار معروف بأنه يعمل، واستعادة البيانات فقط إذا تعذّر على التراجع المنسّق تشغيل الحزمة.
قد يغيّر التحديث رمز التطبيق، وتوقعات مخطط قاعدة البيانات، ومتغيرات البيئة، وإصدارات الخدمات المرافقة دفعة واحدة. ويجعل سحب أحدث الإصدارات باستمرار أو خلط الحاويات القديمة بالجديدة حدود الاستعادة أصعب تحديدًا. احفظ ملف Compose والبيئة والسجلات وقاعدة البيانات ومسارات التحميل قبل اتخاذ أي إجراء، ثم اختر بين التراجع عن صورة الحاوية والاستعادة الكاملة لقاعدة البيانات والمكتبة.
جمّد الحالة الفاشلة وحدّد نقطة التحديث
أوقف عمليات إعادة التشغيل التلقائية وسجّل الصور أو المعرّفات الرقمية الدقيقة لخدمات الخادم والتعلّم الآلي وقاعدة البيانات وذاكرة التخزين المؤقت. احفظ سجلات بدء التشغيل وملفات النشر قبل إجراء عملية سحب أخرى. يعني النجاح أنك تستطيع تحديد ما تغيّر؛ أما الفشل فيعني ضرورة إيقاف الاستعادة مؤقتًا إلى أن يمكن تحديد الإصدارات القديمة من سجل النشر أو الصور المحلية.
تحقّق مما إذا كان الخادم يتوقف قبل الاتصال بقاعدة البيانات، أو أثناء عملية ترحيل، أو بعد أن يصبح جاهزًا. يشير خطأ اتصال التبعية إلى ضرورة إصلاح الشبكة أو بيانات الاعتماد أو حالة الصحة؛ بينما يزيد خطأ الترحيل من مخاطر استعادة صورة التطبيق وحدها، لأن قاعدة البيانات ربما تكون قد تغيّرت بالفعل.
يوضح هذا الدليل الإرشادي لتحديثات Immich المرقّمة بالإصدارات سبب أهمية حدود الإصدار وملفات النشر. استخدمه لجرد عملية الانتقال، مع اعتبار سجلاتك ونسخك الاحتياطية المرجع المعتمد للتراجع.
جرّب أولًا التراجع الكامل إلى صورة الإصدار المعروف بأنه يعمل
ثبّت جميع صور تطبيق Immich على الإصدار السابق الدقيق الذي كان يعمل، بدلًا من تغيير خدمة واحدة فقط. أعد إنشاء الحاويات المتأثرة مع إبقاء وحدات التخزين الدائمة دون تغيير. إذا أصبحت الحزمة سليمة ولم تُظهر السجلات عدم توافق في المخطط، ينجح هذا التراجع قليل التغيير.
إذا رفض الخادم القديم مخطط قاعدة البيانات الحالي، فتوقّف. لا تتناوب بين الإصدارات على قاعدة البيانات نفسها، ولا تعدّل جداول الترحيل يدويًا. يعني هذا الفشل أن التحديث تجاوز حدًا متعلقًا بالبيانات، وأن الاستعادة يجب أن تستخدم نسخة احتياطية لقاعدة البيانات يتطابق توقيتها مع إصدار التطبيق المحدد.
يوثّق تقرير عن Immich v1.135.3 فشلًا محددًا في بدء ترحيل قاعدة البيانات بعد تحديث. ويبرر مثال الترحيل المحدود فيه قراءة أول خطأ جسيم بعناية؛ لكنه لا يبرر نسخ أوامر تلك الحالة إلى إصدار آخر.
استعِد قاعدة البيانات والوسائط فقط عندما يتعذّر التراجع
أنشئ نسخة أمان أو لقطة تخزين للحالة الفاشلة قبل الاستعادة. جهّز هدف استعادة نظيفًا، واستعِد النسخة الاحتياطية لقاعدة البيانات، ثم أتح مكتبة التحميل المقابلة وملفات النشر المطلوبة. لا تستبدل المكتبة الحالية الوحيدة بنسخة أقدم لمجرد محاذاة التواريخ.
يجب أن تصف سجلات قاعدة البيانات وملفات الأصول المجموعة نفسها. إذا كانت النسخة الاحتياطية أقدم من أحدث عمليات التحميل، فاحتفظ بهذه الملفات الأحدث منفصلة لإجراء المطابقة لاحقًا. تنجح الاستعادة عند اكتمال عمليات الترحيل، وظهور المستخدمين والأصول المتوقعة، وفتح عينات من الملفات الأصلية دون أخطاء واسعة النطاق بشأن الملفات المفقودة.
يوفر دليل ترحيل Immich من ZimaSpace جردًا مفيدًا لنقل المكونات الدائمة، دون اعتبار صورة الحاوية مكتبة الصور نفسها.
تحقّق من الاستعادة قبل محاولة التحديث مجددًا
اختبر تسجيل الدخول، وتصفح المخطط الزمني، وتنزيل الملفات الأصلية، وإنشاء الصور المصغرة، والبحث الذكي، ومعالجة الوجوه، وتحميلًا جديدًا واحدًا، ونسخة احتياطية واحدة لقاعدة البيانات. أعد تشغيل الحاويات والمضيف مرة واحدة. يتطلب النجاح بقاء الأصول والوظائف نفسها بعد إعادة التشغيل، دون أخطاء ترحيل أو أذونات متكررة.
أبقِ الحالتين الفاشلة والمستعادة مصنّفتين بشكل منفصل حتى انتهاء التحقق. إذا كانت الاستعادة تعتمد على إصدار أقدم، فعطّل عمليات سحب الصور غير المراقبة ووثّق الإصدار المثبّت. أعد محاولة التحديث فقط بعد مراجعة كل إصدار وسيط وأخذ نسخة احتياطية منسّقة جديدة.
ارجع إلى هدف الاستعادة المحفوظ إذا اختفى تحميل جديد، أو تعذّر فتح الملفات الأصلية، أو تعطلت المهام مرارًا. صعّد المشكلة مع إصداري المصدر والهدف، ومعرّفات الصور الرقمية، وأول سجل خطأ جسيم، وتوقيت النسخة الاحتياطية لقاعدة البيانات، وربط التخزين؛ ولا تتخلّص أبدًا من آخر نسخة معروفة بأنها تعمل ما دامت توافقية التحديث غير محسومة.
الدعم والنصائح
المزيد للقراءة

كيفية تحسين اتصالات قاعدة بيانات Immich للحاويات المتزامنة
لا ترفع max_connections أولًا. قِس جلسات Immich، واجمع إجمالي طلبات كل حاوية، وحافظ على هامش احتياطي للمسؤول، واضبط الاختناق المثبت فقط.

كيفية منع تكرار المهام أو عمليات الاستيراد في Immich
افصل المهام المتكررة عن الأصول المكررة. استخدم مسارًا أساسيًا واحدًا للإدخال، وتحكّم في عمليات إعادة المحاولة وتغييرات المسارات، ثم اختبر إعادة الإدخال على مجموعة...

كيفية إصلاح Immich بعد امتلاء وحدة تخزين قاعدة البيانات الخاصة به
لا تحذف سجلات WAL الخاصة بـ PostgreSQL لتحرير المساحة مطلقًا. أوقف عمليات الكتابة في Immich، وحافظ على حالة قاعدة البيانات، وأضف سعة تخزين آمنة،...

