قبل ترقية حاوية Home Assistant، وثّق مواصفات الحاوية قيد التشغيل، وتحقق من وجود نسخة احتياطية خارج الحاوية، وافحص جاهزية التبعيات، واحتفظ بصورة حاوية سابقة اختُبرت إمكانية الرجوع إليها.
قد تبقى الإعدادات الدائمة بعد إعادة إنشاء الحاوية، بينما قد لا تبقى أجهزة USB اللاسلكية، وخدمات قواعد البيانات، وأنماط الشبكة، والأسرار، والتكاملات المخصصة، أو الحاويات المصاحبة. أنشئ قائمة التحقق من النشر الحالي الدقيق، لا من مثال compose عام. لا تسحب صورة جديدة وتعيد التشغيل قبل إمكانية العثور على النسخة الاحتياطية خارج الحاوية، والتأكد من توفر المساحة الحرة المطلوبة، وإمكانية استعادة مرجع الصورة السابقة.
سجّل مواصفات الحاوية قيد التشغيل
سجّل بصمة صورة Home Assistant أو إصدارها بدقة، ووسائط الحاوية، ونمط الشبكة، والمنافذ المنشورة، ومتغيرات البيئة، وسياسة إعادة التشغيل، والمنطقة الزمنية، وخيارات الأمان، وفحص الصحة، والمسارات المركّبة، وتعيينات الأجهزة. صدّر تعريف compose أو تعريف التنسيق الحالي، وقارنه بالحاوية قيد التشغيل لاكتشاف أي اختلاف.
غالبًا ما تعتمد عمليات ترحيل الحاويات على أكثر من دليل الإعدادات الظاهر. يسلّط أحد المستخدمين في المجتمع الضوء على الانتقال من Home Assistant OS إلى الحاويات مع وجود Zigbee2MQTT والوسيط وتعريفات المكدس بشكل منفصل، موضحًا سبب ضرورة جرد مكدس الحاويات الكامل.
تعني حالة النجاح أن بإمكان مسؤول آخر إعادة إنشاء الحاوية الحالية اعتمادًا على السجل دون تخمين. وتعني حالة الفشل أن وحدة تركيب أو جهازًا أو سرًا أو أمرًا لا يوجد إلا في حالة التشغيل. سوِّ ملف النشر قبل الترقية؛ وإلا فقد تؤدي عملية الرجوع إلى إنشاء بيئة مختلفة.
تحقق من النسخة الاحتياطية خارج الحاوية
أنشئ النسخة الاحتياطية المخطط لها، وانسخها أو خزّنها خارج نظام ملفات الحاوية، ويفضل خارج نطاق فشل المضيف نفسه، ثم سجّل وقت إنشائها وحجمها. تأكد من أنها تتضمن الإعدادات الدائمة، وسجلات التخزين المخفية، والأسرار المطلوبة للاستعادة، وأي نسخة احتياطية لقاعدة بيانات خارجية تحتاج إليها البنية المختارة.
توصي مناقشة حول استعادة Docker صراحةً بالاحتفاظ بالنسخ الاحتياطية خارج الحاوية ونسخ أحدث نسخة احتياطية قبل إزالة المثيل القديم. وتمنع قاعدة النسخ الاحتياطي خارج الحاوية استبدال الحاوية من حذف نسخة الاسترداد الوحيدة.
تعني حالة النجاح أن الملف قابل للقراءة من بيئة الاسترداد، وأن محتوياته أو عملية استعادة اختبارية قد تم التحقق منها. وتعني حالة الفشل أن النسخة الاحتياطية موجودة فقط في وحدة التخزين التي سيجري تغييرها، أو أنها تعتمد على بيانات اعتماد غير موثقة. أوقف الترقية حتى تصبح عملية الاسترداد مستقلة عن الحاوية الجديدة.
افحص تبعيات قاعدة البيانات والتخزين والأجهزة اللاسلكية
سجّل محرك قاعدة البيانات وإصداره، وإصدارات الوسيط والجسر، ومسارات أجهزة USB، وحالة البرامج الثابتة للأجهزة اللاسلكية، وعناوين الشبكة، وأسماء DNS، وحالة كل خدمة مصاحبة مطلوبة. افحص المساحة الحرة الحالية اللازمة لطبقات الصور، وأعمال ترحيل قاعدة البيانات، والسجلات، ونسخة الرجوع.
يحذّر سير عمل عملي لتحديث الحاوية من أن ترحيل مخطط قاعدة البيانات قد يؤخر جاهزية واجهة API، وأن إعادة التشغيل المتكررة قد تقطع التقدم. ويدعم التسلسل الوارد في تحديث Docker مع مراعاة الرجوع تحديد فترة لمراقبة الترحيل قبل المساس بالصورة قيد التشغيل.
تعني حالة النجاح أن كل تبعية سليمة، ويمكن الوصول إليها، ومتوافقة مع الإصدار المستهدف، ومشمولة في خطة الرجوع. وتعني حالة الفشل أن مسار الجهاز اللاسلكي غير مستقر، أو أن قاعدة البيانات غير سليمة أصلًا، أو أن المساحة الحرة محدودة. أصلح خط الأساس أولًا حتى لا تُنسب مشكلة موجودة مسبقًا إلى الترقية.
راجع التكاملات المخصصة ومخاطر الإصدار
أدرج التكاملات المخصصة، وموارد الواجهة الأمامية، والسمات، وأتمتات تستدعي خدمات مهجورة، والمكونات المصاحبة المثبتة على إصدارات محددة. تحقق من حالة صيانتها وتوافقها مع الإصدار المستهدف. لا تعطّل أي شيء افتراضيًا؛ بل حدّد المكوّن الاختياري الذي يمكن عزله أولًا إذا فشل بدء التشغيل.
يتحقق مستخدمو Home Assistant الذين يخططون لترقيات Docker عادةً من خطوات النسخ الاحتياطي والرجوع قبل تغيير إصدار يعمل منذ مدة طويلة. وتوضح مناقشة حول الاستعداد لتحديث الحاوية سبب ضرورة إبقاء الصورة القديمة والبيانات الدائمة متاحتين معًا.
تعني حالة النجاح أن مخاطر التوافق المعروفة لها ترتيب للعزل، وأنه لا يوجد ما يعيق التحكم المحلي الأساسي. وتعني حالة الفشل أن مكوّنًا مخصصًا غير مُصان مطلوب لكنه غير مختبر. أجّل العملية، أو اختبر الصورة المستهدفة على نسخة، أو اقبل وضعًا متدهورًا موثقًا قبل جدولة توقف الخدمة في بيئة الإنتاج.
حدّد بوابة الترقية ومشغّل الرجوع
اكتب ترتيب الإيقاف الدقيق، وخطوات سحب الصورة وإعادة إنشاء الحاوية، وإشارات الترحيل المتوقعة، وقائمة التحقق من الصحة، والحد الأقصى لفترة التوقف، وأمر الرجوع. احتفظ ببصمة الصورة القديمة، ولا تعدّل البيانات الدائمة يدويًا أثناء فترة مراقبة بدء التشغيل الأول. اختر نافذة صيانة يتوفر خلالها تحكم محلي يدوي.
استخدم قائمة التحقق الآمنة للترحيل من ZimaSpace لتضمين الأجهزة اللاسلكية، والتخزين، وإعدادات الشبكة، والتكاملات، وخيار رجوع اختُبرت صلاحيته بما يتجاوز الحاوية نفسها.
تابع فقط عند اجتياز جميع البوابات السابقة. بعد الترقية، تحقق من السجلات، وRecorder، والتكاملات الأساسية، وأتمتة محلية واحدة، ومسار وصول عن بُعد واحد، وإنشاء نسخة احتياطية، وإعادة تشغيل ثانية. ارجع إلى الإصدار السابق عند تكرار أخطاء الترحيل، أو تجاوز التحكم الأساسي حد التوقف المسموح، أو عجز الحاوية الجديدة عن إعادة إنتاج المواصفات المسجلة.
الدعم والنصائح
المزيد للقراءة

يعمل Home Assistant عبر شبكة Wi‑Fi لكنه يفشل عبر Ethernet أو VPN
اختبر كل مسار شبكي على حدة، وتحقق من حالة الواجهة والتوجيه، وميّز بين الاتصال المباشر بعنوان IP والاكتشاف، ثم أصلح الطبقة المتعطلة فقط.

كيفية إيقاف تشغيل Home Assistant نهائيًا دون ترك بيانات غير محمية
أثبت الاستبدال أو الأرشفة، وألغِ كل مسار ثقة، وطهّر كل جهاز يحمل بيانات، واحتفظ فقط بنسخ الاسترداد المحمية والموثقة.

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

