إذا فشل تطبيق Paperless-ngx من جهة خارجية لأن ملف Compose الخاص به يشير إلى صورة Tika غير صحيحة، فأصلح تعريف التطبيق أو استخدم حزمة تتم صيانتها بدلًا من إعادة تثبيت ملف Compose المعطوب نفسه مرارًا. في النقاش الأصلي، كانت حزمة Coolstore تشير إلى صورة Tika اعتقد المستخدم أنها غير صحيحة، بينما ثُبّتت حزمة BigBear بنجاح في النهاية بعد عدة محاولات.
لم يحدد النقاش سبب فشل محاولات BigBear السابقة، لذلك سيكون من غير الدقيق القول إن تغيير قسم IP وحده حل شامل. النهج المستدام هو مقارنة ملف Compose من جهة خارجية بمتطلبات Paperless-ngx الحالية من المصدر الأساسي.
Tika خدمة اختيارية في Paperless
يوضح مرجع إعداد Paperless-ngx الحالي أن Tika وGotenberg خدمتان اختياريتان تُستخدمان لمعالجة مستندات Office ورسائل البريد الإلكتروني. يجب إعداد Paperless باستخدام نقاط نهاية يمكن الوصول إليها عند تفعيل هذا التكامل.
وهذا يعني أن صورة خدمة Tika المعطوبة قد تؤدي إلى فشل التثبيت الذي يفعّل التكامل، حتى إذا كان تعريف حاوية Paperless الأساسي سليمًا بخلاف ذلك.
تعامل مع Coolstore وBigBear على أنهما حزمتان من جهات خارجية
أشار أحد أفراد المجتمع بشكل صحيح إلى أن Coolstore مصدر تطبيقات من جهة خارجية. وينبغي الإبلاغ عن مرجع الصورة المعطوب في تلك الحزمة إلى الجهة المسؤولة عن صيانتها، بدلًا من اعتباره خللًا في نواة ZimaOS.
إذا كانت إحدى حزم المتجر قديمة، فقارنها بأمثلة Paperless Docker من المصدر الأساسي أو بحزمة أخرى تتم صيانتها. احتفظ بمسارات بياناتك الحالية قبل تغيير الحزم.
عدّل ملف Compose أو أعد استيراده بحذر
يمكن لإصدار ZimaOS الحالي استيراد تعريفات Docker Compose مخصصة. يُعد دليل استكشاف أخطاء Compose المخصص وإصلاحها المسار الأكثر أمانًا عندما يحتوي تعريف أحد التطبيقات في المتجر على صورة غير صحيحة أو حقل غير مدعوم.
يسرد ZimaOS 1.7.1 أيضًا تحسينات في توافق حفظ YAML ضمن ملاحظات الإصدار الحالية. ولا يعمل هذا التحسين على إصلاح مرجع صورة غير صحيح في مستودع تابع لجهة خارجية تلقائيًا.
قبل إعادة تثبيت Paperless مرة أخرى
- انسخ احتياطيًا بيانات Paperless وملفات الوسائط ومواقع قاعدة البيانات.
- تأكد من وجود كل مرجع صورة ومن استمرار صيانته.
- أبقِ Paperless وقاعدة بياناته وRedis وTika وGotenberg على شبكات Compose المقصودة.
- غيّر مصدرًا واحدًا للفشل في كل مرة حتى تتمكن من تحديد الإصلاح الناجح.
إذا نجح التثبيت فجأة بعد عدة محاولات، كما حدث في النقاش، فلا تخترع سببًا لذلك. احتفظ بالنتيجة موصوفة بأنها نجاح تحقّق منه المستخدم، مع بقاء سبب الفشل الأصلي غير محسوم.
