انقل بيانات Home Assistant مع الحفاظ على حالة التطبيق كاملة، وأبقِ النسخة القديمة دون تغيير حتى تجتاز النسخة البديلة عملية تحقق شاملة.
لا تقتصر المستخدمون والإعدادات على ملفات YAML الظاهرة، كما أن السجل لا يُعاد إنشاؤه بمجرد نسخ لوحة تحكم. يجب أن تحافظ عملية الترحيل على دليل إعداد Home Assistant بالكامل أو على نسخة احتياطية مدعومة، وقاعدة بيانات Recorder عندما يكون السجل مهمًا، ووحدة التخزين المخفية، والأسرار، والمكونات المخصصة، وعمليات ربط الأجهزة والشبكة الخاصة ببيئة التشغيل المحيطة بها. التسلسل الأكثر أمانًا هو الجرد، ثم النسخ المتسق، ثم التشغيل المعزول، ثم التحقق، وأخيرًا إيقاف المصدر.
جرد الحالة الدائمة والاعتماديات الخارجية قبل النقل
في تثبيت قائم على الحاويات، تعامل مع دليل إعداد Home Assistant المركّب بالكامل باعتباره وحدة الاسترداد الأساسية، بدلًا من اختيار بعض الملفات المألوفة. يمكن أن توجد الحالة المخفية ضمن .storage، وبيانات المصادقة، وسجلات التكاملات، ولوحات التحكم، والأتمتة، وقاعدة بيانات Recorder الافتراضية أسفل ذلك المسار. يجب إدراج MariaDB الخارجية، وMQTT، وبوابات Zigbee، ومخازن الأسرار، أو نقاط تركيب NAS كلٌّ على حدة.
يوضح النقل الكامل لدليل الإعداد في دليل ترحيل حاوية Home Assistant سبب كونه أكثر أمانًا من إعادة بناء الحالة ملفًا بعد ملف، كما يؤكد ضرورة إيقاف الحاوية القديمة قبل إجراء نسخة مباشرة من نظام الملفات.
أنشئ بيانًا يتضمن المسار المصدر، والمسار الهدف، ومعرّفَي المالك UID/GID، وموقع قاعدة البيانات، وأجهزة USB أو الأجهزة التسلسلية، ووضع الشبكة، والمنافذ المنشورة، والخدمات الخارجية، وإصدار Home Assistant الحالي. إذا كانت أي تبعية غير موثقة، فلا تحذف النسخة القديمة. لا يكون الترحيل جاهزًا حتى يتمكن المضيف الجديد من إعادة إنتاج تلك التبعية استنادًا إلى معلومات مكتوبة.
أنشئ نقطة تراجع متسقة قبل نسخ البيانات
استخدم النسخة الاحتياطية المدمجة أو طريقة أخرى تراعي التطبيق عندما يدعمها تثبيتك. إذا كنت تجري نسخة مباشرة لحاوية، فأوقف Home Assistant قبل نسخ قاعدة بيانات الإعداد النشطة والملفات المرتبطة بها. قد تلتقط النسخة المباشرة العادية ملفات التطبيق في لحظات مختلفة، وهذا عكس الترحيل المنضبط تمامًا.
وسّع تحسين النسخ الاحتياطي في Home Assistant دعم الاستعادة عبر طرق التثبيت، ما يجعل النسخة الاحتياطية المدعومة حدًا قويًا لقابلية النقل عند تغيير بيئة التشغيل. والدرس العملي من استعادة النسخة الاحتياطية بين عمليات التثبيت هو أن بيئة التشغيل الجديدة يمكن أن تتغير، بينما تظل حالة التطبيق حد الاستمرارية.
احتفظ بنسختين: نقطة استرداد أصلية غير ممسوسة قبل النقل، ونسخة عمل تُستخدم في الترحيل. لا تسمح ببدء نسخة Home Assistant الجديدة باستخدام نسخة المصدر الوحيدة السليمة. إذا أجرى الهدف عملية ترحيل أو كتب حالة جديدة لسجل الأجهزة، فيجب أن يظل لديك مسار نظيف للعودة إلى الإصدار القديم والمضيف القديم.
أعد إنشاء عمليات ربط الأجهزة والشبكة الخاصة ببيئة التشغيل بشكل منفصل
لا تعيد بيانات التطبيق تلقائيًا إنشاء مسارات أجهزة المضيف. قد تظهر وحدات USB المنسقة لـ Zigbee أو Z-Wave تحت اسم جهاز مختلف، وقد يختلف الوصول إلى Bluetooth، ويمكن أن تتغير آلية اكتشاف الأجهزة عند استخدام شبكة المضيف، كما قد تُحل قواعد البيانات الخارجية أو وسطاء MQTT عبر عناوين مختلفة. أعد بناء هذه الواجهات صراحةً قبل اعتبار التكامل غير المتاح فقدانًا للبيانات.
يوضح دليل مستقل لترحيل Home Assistant من الحاوية إلى HAOS أن استعادة حالة Home Assistant Core لا تعيد تلقائيًا إنشاء الخدمات المرافقة مثل MQTT وZigbee2MQTT وNode-RED. كما يتحقق تسلسل ترحيل إعادة ربط الخدمات المرافقة من استمرارية سجل Recorder، والوصول إلى منسق USB، وإبقاء المجموعة القديمة متوقفة وسليمة لتكون مسار التراجع.
شغّل الهدف عبر مسار LAN مضبوط، وتجنب تشغيل النسختين باستخدام أجهزة الراديو نفسها أو خطافات الويب أو الحسابات السحابية أو الأتمتة نفسها، إلا إذا عزلتها عمدًا. قد ترسل نسختان نشطتان من Home Assistant إجراءات مكررة أو تتنافسان على المنسق نفسه، ما يجعل عملية ترحيل بيانات صحيحة تبدو معطلة.
تحقق من المستخدمين والسجل والإعدادات والتحكم بالأجهزة قبل التحويل
سجّل الدخول باستخدام حساب موجود غير إداري، وتأكد من وجود حساب مسؤول، وافتح الرسوم البيانية التاريخية التي تسبق النقل، وافحص التكاملات، وشغّل أتمتة نموذجية، وتحقق من جهاز واحد لكل بروتوكول مهم. ثم أعد تشغيل Home Assistant وأعد تشغيل المضيف الهدف لإثبات أن الحالة المستعادة تصمد أمام أحداث دورة الحياة العادية.
يوفر شرح ZimaSpace المرتبط حول أدوار البيانات الدائمة في Home Assistant حد الاسترداد المفيد: ينبغي التعامل مع الهوية والإعدادات والسجل الدائم بشكل مختلف عن ملفات التخزين المؤقت أو الملفات المؤقتة أثناء النقل.
حوّل DNS أو الوكيل أو الوصول عن بُعد فقط بعد اجتياز الاختبارات المحلية. أبقِ المضيف القديم قيد الإيقاف، لكن قابلًا للاسترداد، خلال دورة استخدام عادية واحدة على الأقل. لا تتخلص منه إلا عندما تعمل المستخدمون والسجل والإعدادات والأتمتة وأجهزة الراديو والخدمات الخارجية وإنشاء النسخ الاحتياطية وإعادة التشغيل كما هو متوقع؛ فنجاح تحميل لوحة التحكم لأول مرة ليس دليلًا كافيًا لمحو مسار التراجع.
الدعم والنصائح
المزيد للقراءة

كيفية تحسين اتصالات قاعدة بيانات Home Assistant للحاويات المتزامنة
اضبط قاعدة بيانات Recorder الخارجية استنادًا إلى الاتصالات النشطة وزمن الاستجابة المُقاسَين، وليس عبر زيادة الحد الأقصى للاتصالات أو نسخ تجمّع اتصالات مضيف آخر.

كيفية منع تكرار المهام أو عمليات الاستيراد في Home Assistant
استخدم سجلات التتبّع ومفاتيح العمليات الفريدة لجعل عمليات الأتمتة والاستيراد آمنة عند إعادة المحاولة، من دون إنشاء إجراءات أو سجلات مكررة.

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

