إذا ظل Immich على ZimaOS بإصدار قديم بعد تعديل وسم صورة immich-server فقط، فتوقف عن تغيير حاوية واحدة في كل مرة وحدّد الحزمة/المكدس أولًا. Immich تطبيق متعدد الخدمات؛ ويجب أن تظل مكوّنات الخادم والتعلّم الآلي وقاعدة البيانات وذاكرة التخزين المؤقت متوافقة، كما أن بعض حزم ZimaOS تتولى صيانتها مصادر مختلفة لمتجر التطبيقات.
يوضح موضوع المصدر سبب فشل التحديث في حقل واحد: غيّر المستخدم صورة الخادم، ولاحظ نشاط تنزيل الشبكة، ثم أعاد التشغيل، لكن Immich ظل يعرض الإصدار v2.6.1. وأظهر مستخدم آخر إعدادًا يعمل بالإصدار v3.1.0 مع صور خدمات متطابقة. لذلك فإن الدليل الصحيح هو «أنشئ نسخة احتياطية، وحدّد المكدس، وحدّثه بشكل متناسق، ثم تحقّق منه»، وليس «اكتب رقمًا أحدث في حقل واحد».
الخطوة 1: حدّد حزمة Immich التي ثبّتها
قد تحتوي ZimaOS على حزم رسمية وحزم من متاجر تابعة لجهات خارجية أو المجتمع. افتح إعدادات التطبيق وسجّل صورة كل خدمة، وليس فقط خادم immich.
لاحظ أيضًا مصدر متجر التطبيقات حتى تعرف الجهة التي تتحكم في بيانات التحديث الوصفية.
الخطوة 2: أنشئ نسخةً احتياطية من Immich قبل أي تحديث رئيسي
أنشئ نسخةً احتياطية من مكتبة الصور وقاعدة بيانات PostgreSQL. يوثّق دليل النسخ الاحتياطي والاستعادة الحالي لـ Immich سير عمل تفريغ قاعدة البيانات.
لا تعتبر إعادة إنشاء الحاوية نسخةً احتياطية.
الخطوة 3: تحقّق من إصدارات جميع الخدمات
تضمّنت مقارنة المصدر ما يلي:
- خادم Immich؛
- التعلّم الآلي في Immich؛
- Postgres؛
- Valkey/Redis.
سجّل وسوم الصور الكاملة. إذا كان متجر التطبيقات يحافظ عليها كحزمة مختبرة، ففضّل إجراء التحديث فيه بدلًا من تحديث مكوّن واحد يدويًا قبل بقية المكوّنات.
الخطوة 4: استخدم تحديث متجر التطبيقات عند توفره
تنصّ وثائق ZimaOS الحالية على إمكانية تثبيت أحدث حزمة من Immich من متجر التطبيقات. إذا كان زر التحديث متاحًا، فاستخدمه لكي يتم تحديث تعريف Compose الخاص بصيانة الحزمة معه.
يُعدّ دليل Immich في ZimaOS الحالي نقطة البداية الرسمية الحالية لـ ZimaOS.
لماذا قد يبدو أن تعديل وسم واحد يؤدي إلى التنزيل دون التحديث
قد يجلب مدير التطبيقات صورة جديدة، لكنه قد يعيد إنشاء الخدمة من بيانات وصفية مخزنة، أو قيمة YAML محفوظة أخرى، أو تعريف صورة مختلف. لذلك قد تعود الحاوية قيد التشغيل إلى الوسم القديم.
تحقّق من صورة التشغيل الفعلية باستخدام:
docker ps --format '{.Names} {.Image}'لا تنتقل بين الإصدارات الرئيسية لـ Immich بشكل عشوائي
قد تتضمن إصدارات Immich تغييرات في قاعدة البيانات/المخطط والخدمات. اقرأ ملاحظات الإصدار/الترقية من المشروع الأصلي للإصدارات التي ستنتقل بينها. حدّث الحزمة كوحدة واحدة بدلًا من تخمين التركيبات المتوافقة.
إذا كنت تستخدم حزمة BigBear أو حزمة أخرى من جهة خارجية
يوثّق دليل منفصل من مجتمع ZimaSpace أن تغيير وسوم الصور نجح مع بعض حزم BigBear، بينما وجد مستخدمون لاحقون أن الحيلة نفسها لم تكن عامة على جميع الحزم. حدّد مصدر الحزمة قبل تطبيق هذا الحل البديل.
يوضح دليل تحديث Immich هذا الحد الفاصل الخاص بالحزمة.
تحقّق من التحديث بعد إعادة إنشاء الحزمة
تحقّق من ثلاثة أماكن:
- وسوم صورة Docker قيد التشغيل؛
- عرض إصدار خادم Immich نفسه؛
- سجلات الحاوية بحثًا عن أخطاء الترحيل أو التوافق.
لا تحذف قاعدة البيانات أو مجلد التحميل لفرض التحديث
إزالة وحدات التخزين هي إعادة ضبط مدمّرة، وليست طريقة للتحديث. احتفظ بقاعدة البيانات ومكتبة الصور ما لم تكن لديك نسخة احتياطية مختبرة وتريد تثبيتًا جديدًا عن قصد.
الأسئلة الشائعة
لماذا لا يزال Immich يعرض الإصدار 2.6.1 بعد تغيير وسم الخادم؟
قد يكون التطبيق يعيد إنشاء تعريف الخدمة القديم، أو قد لا تكون الحزمة قد حُدّثت بشكل متسق. تحقّق من صورة التشغيل الفعلية ومصدر الحزمة.
هل يجب أن يتطابق إصدار تعلّم الآلة مع إصدار الخادم تمامًا؟
اتبع الإصدارات المختبرة في تعريف إصدار Immich/Compose الذي تنشره. لا تخترع وسومًا مستقلة لكل خدمة.
هل يمكنني تحديث immich-server فقط؟
تجنّب ذلك كخيار افتراضي. Immich عبارة عن حزمة متعددة الخدمات، وقد تتطلب الترقيات تغييرات منسّقة.
ما الذي ينبغي أن أنشئ له نسخة احتياطية أولًا؟
قاعدة بيانات PostgreSQL وتخزين الوسائط/التحميل لديك. تحقّق من النسخة الاحتياطية قبل إجراء تغييرات على الإصدار الرئيسي.
