So stellen Sie Home Assistant nach einem fehlgeschlagenen Container-Update wieder her

Ein fehlgeschlagenes Update des Home-Assistant-Containers sollte normalerweise als Problem beim Ersetzen der Laufzeitumgebung betrachtet werden, nicht als Grund, eine neue Installation zu erstellen. Solange das auf dem Host eingebundene Verzeichnis /config intakt ist, besteht der sicherste Wiederherstellungsweg darin, diesen Zustand zu bewahren, die Volume-Zuordnung zu überprüfen, ein bekannt funktionierendes Image zu starten und die vorhandene Installation zu testen, bevor ein älteres Backup wiederhergestellt wird.

Der gefährliche Schritt besteht darin, einen neuen Container gegen den falschen oder leeren Host-Pfad starten zu lassen. Home Assistant kann dann den Einrichtungsassistenten anzeigen, als sei die Konfiguration verschwunden, obwohl der ursprüngliche Zustand noch an anderer Stelle auf der Festplatte vorhanden ist. Frieren Sie Änderungen zunächst ein, ermitteln Sie das maßgebliche Konfigurationsverzeichnis und löschen Sie den alten Container oder das alte Verzeichnis nicht, bevor die wiederhergestellte Instanz erfolgreich geprüft wurde.

Neue Schreibvorgänge stoppen und den tatsächlichen Pfad von /config ermitteln

Stoppen Sie den fehlgeschlagenen Container und prüfen Sie die Laufzeitdefinition, mit der er erstellt wurde. Bestätigen Sie, welches Host-Verzeichnis oder benannte Volume auf /config gemappt ist, und prüfen Sie diesen Speicherort auf Ihre YAML-Dateien, .storage, benutzerdefinierte Komponenten, Secrets und die Datenbank.

In einem Wiederherstellungsfall aus der Community nach einem Docker-Upgrade stellte sich heraus, dass eine „brandneue“ Home-Assistant-Instanz tatsächlich dadurch verursacht wurde, dass der Container auf den falschen Konfigurationsordner verwies. Die persistenten Daten waren nicht gelöscht worden; die ersetzte Laufzeitumgebung band sie lediglich nicht korrekt ein.

Kopieren oder snapshotten Sie das aktuelle Konfigurationsverzeichnis, bevor Sie Besitzrechte, Pfade oder Datenbankdateien ändern. Selbst ein teilweise beschädigter Zustand ist wertvoll und kann neuere Automatisierungen oder Zugangsdaten enthalten als das letzte Backup.

Die Laufzeitumgebung neu erstellen, ohne die Installation neu zu erstellen

Verwenden Sie denselben Netzwerkmodus, dieselbe Zeitzone, dieselben Gerätezuordnungen, den Zugriff auf USB-Funkadapter, Berechtigungen oder Capabilities sowie dasselbe Host-Mount von /config, das der funktionierende Container vor dem Update verwendet hat. Das Image ist austauschbar; diese Laufzeiteingaben und die persistenten Daten bestimmen, ob der Dienst als dieselbe Home-Assistant-Instanz zurückkehrt.

Die Persistenz eines Containers hängt vom Host-Mount und nicht vom Dateisystem des Containers ab. Ein Beispiel für Home Assistant Container bindet ein persistentes Host-Volume direkt auf /config ein, sodass das Neuerstellen der Laufzeitumgebung nicht die Haushaltskonfiguration neu erstellt. Wenn sich diese Zuordnung während eines Updates ändert, kann ein Ersatzcontainer frisch erscheinen, obwohl der ursprüngliche Zustand weiterhin an anderer Stelle vorhanden ist.

Kopieren Sie nicht das alte Container-Dateisystem in das neue Image. Erstellen Sie die Bereitstellung anhand einer dokumentierten Compose- oder Run-Definition neu und verbinden Sie den persistenten Zustand ausdrücklich.

Das Image zurücksetzen, bevor Sie einen älteren Zustand wiederherstellen

Wenn das Config-Mount korrekt ist, die neue Home-Assistant-Version jedoch nicht startet oder eine wichtige Integration beschädigt, testen Sie das zuvor bekannte funktionierende Image mit demselben bewahrten /config. Dadurch lässt sich unterscheiden, ob die „neue Laufzeitumgebung mit dem aktuellen Zustand inkompatibel“ ist oder ob der Zustand selbst beschädigt wurde.

Der aktuelle Workflow für Home Assistant Container trennt Image und persistente Daten ausdrücklich: zuerst sichern, das Ziel-Image herunterladen, den Container neu erstellen und bei einem erforderlichen Downgrade einen bestimmten älteren Image-Tag verwenden. Diese Wiederherstellungsgrenze sollte erhalten bleiben: Ersetzen Sie die Laufzeitumgebung, während der maßgebliche Konfigurationspfad unverändert bleibt.

Beachten Sie beim Zurücksetzen, dass manche Upgrades Datenstrukturen migrieren. Verwenden Sie ein Backup, das vor einer Migration erstellt wurde, wenn die ältere Version einen vom neueren System bereits aktualisierten Zustand nicht sicher lesen kann. Wechseln Sie nicht wiederholt zwischen Versionen und verwenden Sie dabei nur die einzige Kopie der persistenten Daten.

Featured

ZimaCube 2 Persönliche Cloud Home NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

Ein Backup nur wiederherstellen, wenn der aktuelle Zustand nicht vertrauenswürdig ist

Verwenden Sie ein Backup, wenn die persistente Konfiguration fehlt, beschädigt oder teilweise überschrieben wurde oder nicht mehr mit der Version kompatibel ist, die Sie sicher ausführen können. Stellen Sie es nach Möglichkeit in einem isolierten oder sauberen Ziel wieder her, damit Sie den wiederhergestellten Zustand mit der beschädigten Kopie vergleichen können.

Bewahren Sie das Verschlüsselungspasswort oder das Notfallkit, das zum Öffnen des Backups erforderlich ist, außerhalb des ausgefallenen Hosts auf. Ein Backup, das nur auf derselben Festplatte vorhanden ist oder nicht entschlüsselt werden kann, bietet keinen Wiederherstellungsweg.

Das ZimaSpace-Beispiel der Trennung der Home-Assistant-Wiederherstellung vom Speicherhost selbst bestätigt dieselbe Regel: Anwendungsdaten benötigen einen unabhängigen Wiederherstellungsweg und nicht nur eine gespiegelte Live-Festplatte.

Den wiederhergestellten Container prüfen, bevor Sie etwas löschen

• Bestätigen Sie, dass die erwarteten Benutzer, Dashboards, Integrationen, Automatisierungen, Helfer und Bereiche vorhanden sind.
• Überprüfen Sie einen lokalen Gerätepfad und einen funkbasierten Pfad, falls Zigbee, Z-Wave oder Bluetooth verwendet wird.
• Prüfen Sie den Recorder auf Datenbank- oder Migrationsfehler.
• Starten Sie den wiederhergestellten Container neu und bestätigen Sie, dass derselbe Zustand wiederkehrt.
• Bewahren Sie den alten Image-Tag, eine Kopie der Konfiguration und das letzte bekannte funktionierende Backup auf, bis dieser zweite Start erfolgreich war.

Wenn das alte Image mit der ursprünglichen Konfiguration funktioniert, war das fehlgeschlagene Update hauptsächlich ein Problem der Laufzeitumgebung oder Version. Wenn jedes Image mit demselben Zustand fehlschlägt, gehen Sie zur Reparatur der Konfiguration oder zur Wiederherstellung eines Backups über. Wenn ein sauberer Container nur mit einem leeren /config funktioniert, akzeptieren Sie die neue Einrichtung nicht als „behoben“, bevor Sie verstanden haben, was im persistenten Zustand die Wiederherstellung verhindert.

FAQ

Sollte ich den fehlgeschlagenen Home-Assistant-Container vor der Fehlerbehebung löschen?

Nein. Stoppen Sie ihn zunächst und bewahren Sie seine Laufzeitdefinition sowie den eingebundenen Konfigurationspfad auf. Sie können einen Ersatzcontainer erstellen, ohne den fehlgeschlagenen zu löschen. So bleiben Informationen für ein Zurücksetzen verfügbar, während Sie die neue Laufzeitumgebung überprüfen.

Warum zeigt Home Assistant nach einem Update den Einrichtungsassistenten an?

Der häufigste containerspezifische Grund ist, dass die ersetzte Laufzeitumgebung den ursprünglichen Pfad /config nicht sieht. Überprüfen Sie das Host-Mount, bevor Sie annehmen, dass die Konfiguration gelöscht wurde oder ein älteres Backup über den neueren Zustand wiederherstellen.