كيفية استعادة Home Assistant عندما تبدأ خدمته الرئيسية لكن يفشل أحد التبعيات
عندما يبدأ Home Assistant لكن يفشل أحد التبعيات، أبقِ الخدمة الرئيسية قيد التشغيل مدة كافية لتحديد أول تبعية غير متاحة بدلًا من إعادة بناء التثبيت.
قد تكشف العملية السليمة عن نظام غير مكتمل: فقد تصبح كيانات MQTT غير متاحة، أو قد تمنع قاعدة بيانات خارجية سجلّ المحفوظات، أو قد يتسبب مسار تحميل مفقود في تعطيل النسخ الاحتياطية، أو قد يمنع DNS حل نقاط النهاية السحابية والمحلية. سجّل الخطأ الأقدم، واختبر نقطة النهاية المذكورة من بيئة تشغيل Home Assistant، واستعد الخدمات بدءًا من التبعية إلى الخارج.
حدّد أول فشل في التبعية
سجّل أول خطأ بعد بدء التشغيل للتكامل أو الخدمة المتأثرة، بما في ذلك اسم التبعية، ونقطة النهاية، وفئة الاستثناء، وفاصل إعادة المحاولة، والطابع الزمني. غالبًا ما تصف التحذيرات اللاحقة النتيجة—مثل الكيانات غير المتاحة أو فشل الإعداد—بدلًا من فشل الاتصال أو المصادقة أو التحميل أو المخطط الأول.
توضح حالة MQTT الأساسية الفرق بين إعداد التكامل وتوفر وسيط فعلي. ويُعد التمييز بين توفر الوسيط مفيدًا لأنه يمنع إجراء تغييرات متكررة على العميل عندما لا تكون الخدمة المطلوبة موجودة أو لا تكون قيد التشغيل.
إذا ظهر اسم تبعية واحدة قبل جميع الأخطاء الثانوية، فاجعلها هدف الاستعادة. وإذا فشلت عدة تبعيات غير مرتبطة في الوقت نفسه، فاختبر أولًا DNS المشترك أو الشبكة أو التخزين أو بيانات الاعتماد بدلًا من إصلاح كل تكامل على حدة.
اختبر إمكانية الوصول والمصادقة والجاهزية بالترتيب
من الحاوية أو الآلة الافتراضية أو مساحة أسماء المضيف نفسها التي يستخدمها Home Assistant، حلّل اسم مضيف التبعية، وافتح المنفذ المطلوب، وصادق باستخدام الهوية المُعدّة، ونفّذ أصغر فحص جاهزية للقراءة فقط متاح. لا تثبت إمكانية الوصول من جهة المضيف وحدها أن مساحة أسماء التطبيق أو بيانات الاعتماد تعمل.
لا يعادل ترتيب بدء الحاويات جاهزية التطبيق؛ إذ يمكن لتبعية محكومة بفحص الصحة أن تمنع بدء العملاء قبل جاهزية قاعدة البيانات أو الوسيط. ويدعم التمييز الوارد في ترتيب البدء مقابل الجاهزية إضافة فحص صحة فعلي فقط بعد فهم الحالة الفاشلة.
إذا فشل الحل، فأصلح DNS أو اسم الخدمة. وإذا فشل المنفذ، فأعد تشغيل عملية التبعية أو مسار الشبكة. وإذا فشلت المصادقة، فقارن مصدر بيانات الاعتماد المُعدّة من دون طباعة قيمتها. وإذا فشلت الجاهزية بعد نجاح الاتصال، فافحص سجلات التبعية نفسها وحالة التخزين.
استعد التبعية بأقل تغيير تدخّلًا
صحّح الخلل المؤكد فقط: استعد مسار التحميل المفقود، أو شغّل الوسيط، أو أصلح خدمة قاعدة البيانات، أو جدّد مرجع بيانات الاعتماد، أو أصلح الاسم المستعار للشبكة. أعد تشغيل التبعية أولًا وانتظر حتى ينجح فحص جاهزيتها؛ ثم أعد تشغيل Home Assistant مرة واحدة فقط عندما لا يعاود عميله الاتصال تلقائيًا.
عندما تظل العاملات أو التكاملات غير متصلة بعد بدء النواة، استخدم مسار استكشاف أخطاء جاهزية العاملات للتمييز بين بدء التشغيل المتأخر وحدّ تبعية مستمر.
تراجع إذا تعذر على التبعية العودة إلى حالتها الصحية السابقة أو تطلب الإصلاح حذف المخطط أو إعادة إنشاء قاعدة البيانات أو كشف بيانات الاعتماد. استعد آخر إعداد معروف سليمًا، واحتفظ بسجلات الطرفين قبل محاولة استرداد أكثر تدخّلًا.
أعد إنتاج الميزة الأصلية وحدد نقطة التوقف
أعد اختبار الميزة التي فشلت تحديدًا: انشر قيمة MQTT مؤقتة واحدة واستقبلها، أو حمّل نطاقًا حديثًا من السجل، أو أنشئ نسخة احتياطية تجريبية إلى الهدف المقصود، أو شغّل أتمتة متأثرة واحدة. كرر الاختبار بعد إعادة تشغيل التبعية بطريقة مضبوطة للتأكد من إعادة الاتصال، لا من التوفر الفوري فقط.
يتطلب النجاح توافق فحص صحة التبعية، وحالة تكامل Home Assistant، والميزة الظاهرة للمستخدم. فالحاوية التي تعمل مع كيانات غير متاحة لا تعني التعافي؛ كما أن لوحة معلومات خضراء مع فشل عمليات الكتابة لا تعني التعافي أيضًا.
توقف عندما تنجح الميزة الأصلية مرتين ولا تظهر أخطاء تبعية جديدة. صعّد الحالة مع الاستثناء الأول، وفئة نقطة النهاية، ونتيجة الجاهزية، وإصدار التبعية، وخطوات الاسترداد عندما تكون الخدمة قابلة للوصول لكن يظل تفاوض البروتوكول أو المخطط فاشلًا.
سجّل عقد بدء التشغيل بعد التعافي
وثّق المكوّن الذي يملك التبعية، وإشارة جاهزيتها، وسلوك إعادة المحاولة، ومصدر بيانات الاعتماد، واسم الشبكة، ومسار التخزين، وترتيب الاسترداد. يجب أن يتمكن المشغّل التالي من التمييز بين بدء العملية والخدمة القابلة للاستخدام دون إعادة اكتشاف الحادث.
نفّذ إعادة تشغيل مخططة للتبعية خلال نافذة صيانة، وتأكد من أن Home Assistant يعاود الاتصال ضمن الحد الزمني المسجّل. وإذا ظل التدخل اليدوي مطلوبًا، فصنّف هذا القيد بدلًا من اعتبار التبعية مرنة بالكامل.
لا تغلق الحادث إلا بعد أن تتمكن المراقبة من اكتشاف فشل التبعية وتعافي الميزة معًا. فإذا رصدت المراقبة تشغيل العملية الرئيسية فقط، فستُبقي النقطة العمياء نفسها التي تسببت في حالة بدء التشغيل غير المكتملة.
المنتجات الموصى بها
الدعم والنصائح
المزيد للقراءة
كيفية تحسين اتصالات قاعدة بيانات Immich للحاويات المتزامنة
لا ترفع max_connections أولًا. قِس جلسات Immich، واجمع إجمالي طلبات كل حاوية، وحافظ على هامش احتياطي للمسؤول، واضبط الاختناق المثبت فقط.
كيفية منع تكرار المهام أو عمليات الاستيراد في Immich
افصل المهام المتكررة عن الأصول المكررة. استخدم مسارًا أساسيًا واحدًا للإدخال، وتحكّم في عمليات إعادة المحاولة وتغييرات المسارات، ثم اختبر إعادة الإدخال على مجموعة...
كيفية إصلاح Immich بعد امتلاء وحدة تخزين قاعدة البيانات الخاصة به
لا تحذف سجلات WAL الخاصة بـ PostgreSQL لتحرير المساحة مطلقًا. أوقف عمليات الكتابة في Immich، وحافظ على حالة قاعدة البيانات، وأضف سعة تخزين آمنة،...
