كيفية استعادة Plex بعد فشل تحديث الحاوية

إيفا وونغ هي كاتبة تقنية و ومهندسة هاوية في ZimaSpace. مهووسة بالتكنولوجيا مدى الحياة ولديها شغف بالمختبرات المنزلية والبرمجيات مفتوحة المصدر، تتخصص في تبسيط المفاهيم التقنية المعقدة إلى أدلة عملية وسهلة الفهم. تؤمن إيفا بأن الاستضافة الذاتية يجب أن تكون ممتعة وليست مخيفة. من خلال دروسها، تمكّن المجتمع من تبسيط إعدادات الأجهزة، بدءًا من بناء أول نظام تخزين شبكي NAS وحتى إتقان حاويات Docker.

أوقف حاوية Plex الفاشلة وأداة التحديث التلقائي الخاصة بها قبل سحب صورة أخرى. احفظ السجلات الحالية ومسار إعدادات Plex الحقيقي أولاً؛ يكون الاسترداد أكثر أماناً بكثير عندما لا تستطيع الحاوية المعطلة الاستمرار في استبدال نفسها أو الكتابة إلى حالة التطبيق.

على وحدة تخزين شبكية منزلية، قد يفشل تحديث الحاوية على عدة مستويات مختلفة: فقد لا تبدأ الصورة الجديدة، أو قد تفقد الخدمة المُعاد إنشاؤها وحدة تخزين أو إعداد شبكة، أو قد يتعامل إصدار Plex الجديد مع بيانات التطبيق الموجودة بطريقة مختلفة. الحد المهم هنا هو إعداد Plex الدائم، ولا سيما قاعدة البيانات والبيانات الوصفية ضمن `/config`. يفصل هذا الإجراء بين الصورة وتعريف الحاوية ونقاط الربط وقاعدة البيانات قبل تغيير أي منها، ثم يستعيد أصغر طبقة فاشلة ويتحقق من هوية الخادم الأصلية والمكتبة والتشغيل. إذا أشارت السجلات إلى تلف قاعدة البيانات أو ترحيل لا يمكن التراجع عنه، فتوقف قبل فرض صورة أقدم على النسخة الوحيدة من تلك الحالة.

أوقف حلقة التحديث والتقط حالة الفشل

عطّل أداة التحديث التلقائي لـ Plex وأوقف حلقة إعادة التشغيل السريعة. أبقِ الخدمات السليمة الأخرى قيد التشغيل، ما لم يكن Plex يشارك قاعدة بيانات تتطلب إيقافاً منسقاً. الهدف هو تثبيت حالة الفشل مدة كافية لفحصها، لا إعادة تشغيل مكدس التطبيقات بالكامل ومحو التسلسل الزمني.

سجّل وسم الصورة الدقيق للحاوية الفاشلة، ومعرّف الصورة، وبصمتها الرقمية إن توفرت. احفظ نقاط الربط الفعلية، ومتغيرات البيئة، والمنافذ المنشورة، ووضع الشبكة، والأسماء المستعارة للشبكة، وتعيينات الأجهزة، وإضافات المجموعات، وسياسة إعادة التشغيل، وحالة السلامة. وسم مثل `latest` ليس سجلاً موثوقاً للتراجع بحد ذاته، لأنه قد يشير إلى محتوى مختلف للصورة بمرور الوقت.

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

يمكنك المتابعة عندما يصبح الفشل قابلاً لإعادة الإنتاج وتتمكن من الإجابة عن أربعة أسئلة: ما الصورة التي تم تشغيلها، وما المسارات الدائمة التي استخدمتها، وما إعدادات وقت التشغيل التي تلقتها، وما الخطأ الذي ظهر أولاً. إذا كانت هذه الحقائق لا تزال مجهولة، فإن إجراء سحب أو إعادة تشغيل أخرى سيضيف ضوضاءً من دون أن يجعل الاسترداد أكثر أماناً.

احمِ إعدادات Plex قبل إعادة إنشاء الحاوية

اعتبر الحاوية قابلة للاستبدال، وإعدادات Plex دائمة. توجد الحالة الأساسية عادةً في مسار المضيف أو وحدة التخزين المسماة المركّبة إلى `/config`؛ وينبغي أن تظل مكتبات الوسائط في تركيبات منفصلة. لا تكون إعادة إنشاء الخدمة منخفضة المخاطر إلا عندما تعيد وصلها بالحالة الدائمة نفسها، لا بمجلد فارغ.

افحص التركيب من المضيف ومن سياق مؤقت للقراءة فقط إذا كانت منصتك تدعم ذلك. تأكد من وجود قاعدة البيانات والتفضيلات والبيانات الوصفية وبيانات الإضافات والسجلات المتوقعة. سجّل مصدر التركيب ونظام الملفات والملكية والأذونات والمساحة المتاحة وما إذا أصبح للقراءة فقط. يُعدّ وجود مجلد فارغ في المسار المتوقع تحذيرًا بالتوقف، وليس إذنًا لـ Plex بإنشاء خادم جديد هناك.

أنشئ نسخة احتياطية من مسار الإعداد الكامل المقصود قبل اختبار التراجع، ثم تحقّق من إمكانية سرد محتويات النسخة الاحتياطية أو استعادتها إلى موقع معزول. إذا كان نظام الملفات يدعم اللقطات، فقد تختصر اللقطة وقت الاسترداد، لكنها لا ينبغي أن تكون النسخة الوحيدة عندما يكون جهاز التخزين نفسه عرضة للعطل. احتفظ بالحالة الفاشلة وبآخر نسخة احتياطية معروفة السلامة حتى يتم التحقق من الخادم.

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

حدّد ما إذا كان العطل في الصورة أو التعريف أو التركيب أو قاعدة البيانات

قارن الحاوية الملتقطة بآخر عملية نشر كانت تعمل قبل اختيار الإصلاح. ابدأ بأول سطر قاتل في السجل وبالتعريف الفعلي، ثم صنّف الفشل ضمن أحد الفروع الأربعة: الصورة الجديدة لا يمكنها العمل، أو تغيّر تعريف الحاوية، أو أن مسارًا دائمًا غير متاح، أو أن Plex لا يستطيع استخدام حالة التطبيق الحالية.

عادةً ما يظهر فشل في الصورة أو وقت التشغيل قبل أن يتمكن Plex من فتح `/config`: أخطاء البنية، أو تعليمات المعالج غير المدعومة، أو مكتبات وقت التشغيل المفقودة، أو خروج العملية فورًا مع بقاء تعريف الحاوية دون تغيير. وقد اختفى فشل في التشغيل مرتبط بإصدار معيّن بعد إعادة الخادم إلى صورة Plex أقدم، ما يجعل التراجع أداة مفيدة للتمييز عندما يعمل التعريف نفسه سابقًا ولم يتغير أي تركيب أو إذن.

يظهر فشل في التعريف أو نقطة التثبيت بعد إعادة الإنشاء عندما يبدأ Plex بوسائط مفقودة، أو بخادم فارغ، أو مع رفض الوصول إلى الملفات، أو دون نقطة وصول ويب، أو مع فقدان الوصول إلى العتاد. قارن مصادر وحدات التخزين المحفوظة والفعالة، وUID/GID، والمجموعات، والمنافذ، ووضع الشبكة، والأجهزة، ومتغيرات البيئة. صحّح أول اختلاف مثبت بدلًا من تغيير كل الحقول دفعة واحدة.

تتطلب رسائل قاعدة البيانات والترحيل مسارًا منفصلًا. إذا بدأ الإصدار الجديد تغييرًا في المخطط، فقد لا تتمكن صورة أقدم من قراءة الحالة الناتجة. انسخ الإعداد الحالي احتياطيًا مرة أخرى، واحتفظ بالسجلات، ولا تفرض عمليات بدء متكررة عبر عدة إصدارات. يحتاج هذا المسار إلى صورة متوافقة، أو نسخة احتياطية تم التحقق منها قبل التحديث، أو إصلاح يراعي قاعدة البيانات.

النتيجة المرصودة الفرع الرئيسي الإصلاح الأول
تخرج العملية قبل قراءة `/config` الصورة أو بيئة التشغيل شغّل الصورة القديمة المعروفة بسلامتها باستخدام التعريف غير المعدّل
يبدأ Plex كخادم جديد أو فارغ تعيين `/config` بشكل خاطئ أوقفه واستعد مصدر نقطة التثبيت الأصلي
يُظهر الإعداد أو الوسائط أخطاء في الأذونات ملكية نقطة التثبيت أو حالتها للقراءة فقط استعد UID/GID والمجموعات أو الوصول إلى التخزين المثبتة صلاحيتها
تُظهر السجلات فشلًا في الترحيل أو قاعدة البيانات حالة التطبيق حافظ على الحالة واستخدم صورة متوافقة أو نسخة احتياطية تم التحقق منها

-15% OFF

الرجوع إلى آخر صورة Plex معروفة بأنها سليمة

اختر الصورة نفسها التي عملت بنجاح في المرة الأخيرة. فضّل ملخص صورة محفوظًا، أو مرجع إصدار غير قابل للتغيير، أو معرّف صورة محليًا بدلًا من وسم متغير. عطّل التحديثات التلقائية حتى لا يستبدل برنامج التحديث صورة الاستعادة فور بدء تشغيلها.

أعد إنشاء خدمة Plex فقط من التعريف المحفوظ. حافظ على هوية المشروع أو الحاوية نفسها عندما تؤثر في الشبكات، وعلى مساري `/config` ومصادر الوسائط نفسيهما، والمنافذ نفسها، ووضع الشبكة، ومتغيرات البيئة، وUID/GID، والمجموعات، والأجهزة. لا تحذف وحدات التخزين، ولا تُجرِ تنظيفًا على مستوى النظام قبل اختبار الصورة القديمة.

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

توقف إذا أبلغت الصورة القديمة بأن قاعدة البيانات أحدث أو غير متوافقة أو في منتصف عملية ترحيل. قد يؤدي التبديل المتكرر بين الإصدارات إلى جعل نقطة التعافي أصعب في الفهم. استعد نسخة إعدادات موثقة من قبل التحديث إلى مسار معزول، أو انتقل إلى صورة Plex متوافقة بدلًا من فرض عملية خفض إصدار غير آمنة.

استعد تعريف الحاوي الأصلي عندما لا يكفي التراجع

إذا ظلت صورة الحاوي المعروفة بسلامتها تفشل، فارجع إلى مقارنة التعريف. استعد إعدادًا مفقودًا واحدًا في كل مرة، وأعد تشغيل Plex فقط بعد كل تغيير. يحافظ ذلك على وضوح الأدلة: فعندما يعود الخادم، ستعرف أي تبعية وقت تشغيل كانت مسؤولة.

ابدأ بعمليات تركيب `/config` والوسائط. تأكد من أن الحاوي يرى المسارات المقصودة ويمكنه قراءتها باستخدام المستخدم المُعد. إذا أعاد التحديث إنشاء Plex باستخدام معرّف UID أو GID مختلف، أو مجموعة إضافية، أو سياق أمان مختلف، فاستعد الهوية السابقة العاملة أو صحح ملكية التخزين عمدًا. لا تجعل شجرة appdata بأكملها قابلة للكتابة من الجميع كحل سريع.

بعد ذلك، افحص مسار الويب والأجهزة الاختيارية. استعد شبكة المضيف السابقة أو المنفذ المنشور، والأسماء المستعارة للشبكة، وعضوية الوكيل العكسي قبل تغيير قواعد جدار الحماية. أكد عمل واجهة الويب أولًا عبر مسار الخادم المباشر. أضف جهاز GPU وإمكانية الوصول إلى مجموعة العرض فقط بعد أن يتمكن Plex من البدء وتحميل مكتبته وتقديم بث أساسي متوافق مع البرامج.

تكون عملية إصلاح التعريف الناجحة واضحة المعالم: إذ يرى الحاوي الإعدادات والوسائط المقصودة، ويمكن الوصول إلى نقطة نهاية Plex، ولم تعد السجلات تعرض خطأ التبعية المحدد. إذا استمر خطأ قاعدة البيانات نفسه بعد هذه الفحوصات، فتوقف عن إعادة إنشاء الحاوي وارجع إلى فرع حالة التطبيق المحمي.

تحقق من قاعدة بيانات Plex والمكتبة والتشغيل قبل إعادة تمكين التحديثات

إن تشغيل العملية ليس سوى أول فحص للتعافي. سجّل الدخول عبر نقطة نهاية Plex المباشرة وتأكد من أنه الخادم الأصلي الذي تمت المطالبة به، وليس خادمًا جديدًا أُنشئ باستخدام دليل إعدادات فارغ. افحص سجلات بدء التشغيل بحثًا عن تلف قاعدة البيانات، ومحاولات الترحيل المتكررة، وتهيئة المكتبة غير المتوقعة.

افتح عدة عناصر موجودة في المكتبة وتأكد من وجود الملصقات، والبيانات الوصفية، وحالة المشاهدة، ومسارات الملفات. اختبر الوصول إلى ملف وسائط صغير معروف بسلامته من وحدة التخزين نفسها المستخدمة قبل التحديث. إذا كانت البيانات الوصفية موجودة لكن الوسائط غير متاحة، فقد تكون قاعدة البيانات سليمة بينما لا يزال يلزم إصلاح نقطة تحميل الوسائط أو الأذونات.

شغّل الملف المعروف على عميل محلي واحد، ثم على العميل الذي كشف العطل إن أمكن. سجّل وضع التشغيل وتأكد من عمل التقديم والترجيع. تعامل مع غياب تسريع GPU أو الوصول عن بُعد أو سلوك الترجمة كمسارات متابعة منفصلة إذا نجح التشغيل الأساسي؛ فلا ينبغي أن تعيق هذه الأمور الحفاظ على خادم مُستعاد.

أخيرًا، نفّذ إعادة تشغيل واحدة مضبوطة لخدمة Plex مع إبقاء أداة التحديث معطّلة. لا تنجح الاستعادة إلا عند عودة هوية الخادم نفسها، وقاعدة البيانات، والمكتبات، والبيانات الوصفية، والوصول إلى الوسائط، والتشغيل الأساسي بعد إعادة التشغيل تلك. احتفظ بالسجلات الفاشلة التي جُمعت والنسخة الاحتياطية حتى تصبح هذه النتيجة الكاملة قابلة للتكرار.

اعرف متى تتوقف وتجعل تحديث Plex التالي قابلًا للاستعادة

أوقف إصلاح الحاوية محليًا عندما تُبلغ السجلات مرارًا عن تلف في قاعدة البيانات، أو يعيد نظام ملفات الإعدادات أخطاء إدخال/إخراج، أو تكون النسخة الوحيدة من الحالة قد رُحّلت جزئيًا، أو لا تتمكن أي صورة متوافقة من فتحها. احتفظ بمعرّفات الصورة، والتعريف الفعلي، والسجلات، ونسخة الإعدادات الاحتياطية. عندئذٍ تكون الاستعادة الواعية بقاعدة البيانات أو إصلاح التخزين أكثر أمانًا من مواصلة تغيير الحاويات.

بعد استقرار Plex، وثّق ملخص الصورة المُستعادة، وتعريف الحاوية، والمسارات المستمرة، وهوية وقت التشغيل، ووضع الشبكة، والأجهزة، ونتائج التحقق. وتفيد عملية استعادة الخدمة الواحدة الأوسع عندما يعتمد Plex أيضًا على قواعد بيانات مشتركة أو شبكات وكيلة أو خدمات أخرى في المكدس، لكن لا ينبغي استعادة تلك التبعيات السليمة لمجرد تعطل Plex.

بالنسبة إلى التحديث التالي، أنشئ نسخة احتياطية جديدة من `/config` وتحقق منها، واحتفظ بالصورة الحالية، وعطّل التنظيف التلقائي، وحدّث Plex يدويًا، وكرّر فحوصات الهوية والمكتبة والتشغيل وإعادة التشغيل قبل إعادة تفعيل الأتمتة. لا يكتمل التحديث إلا عندما يحتفظ بهدف تراجع مُختبَر، إلى جانب إصدار جديد يعمل.

الدعم والنصائح

المزيد للقراءة

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.