Så återställer du Home Assistant efter en misslyckad containeruppdatering

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

En misslyckad uppdatering av en Home Assistant-container bör vanligtvis ses som ett problem med att ersätta körningsmiljön, inte som ett skäl att skapa en ny installation. Om den värdmonterade katalogen /config är intakt är den säkraste återställningsvägen att bevara dess innehåll, verifiera volymmappningen, starta en välfungerande avbildning och testa den befintliga installationen innan du återställer en äldre säkerhetskopia.

Det farliga är att låta en ny container starta med en felaktig eller tom sökväg på värden. Home Assistant kan då visa introduktionsflödet som om konfigurationen hade försvunnit, medan det ursprungliga tillståndet fortfarande finns någon annanstans på disken. Frys ändringarna först, hitta den rätta konfigurationskatalogen och radera inte den gamla containern eller katalogen förrän den återställda instansen har klarat testerna.

Stoppa nya skrivningar och hitta den verkliga sökvägen till /config

Stoppa den felande containern och granska körningsdefinitionen som skapade den. Kontrollera vilken värdkatalog eller namngiven volym som är mappad till /config och granska sedan den platsen efter dina YAML-filer, .storage, anpassade komponenter, hemligheter och databasen.

Ett återställningsfall i communityn efter en Docker-uppgradering visade att en ”helt ny” Home Assistant-instans i själva verket berodde på att containern pekade på fel konfigurationsmapp. De beständiga data hade inte raderats; den ersättande körningsmiljön monterade dem helt enkelt inte korrekt.

Kopiera eller ta en ögonblicksbild av den aktuella konfigurationskatalogen innan du ändrar ägarskap, sökvägar eller databasfiler. Även ett delvis trasigt tillstånd är värdefullt underlag och kan innehålla nyare automatiseringar eller inloggningsuppgifter än den senaste säkerhetskopian.

Återskapa körningsmiljön utan att återskapa installationen

Använd samma nätverksläge, tidszon, enhetsmappningar, USB-radioåtkomst, behörigheter eller funktioner och samma värdmappning av /config som den fungerande containern använde före uppdateringen. Avbildningen kan bytas ut; det är dessa körningsinställningar och beständiga data som avgör om tjänsten återkommer som samma Home Assistant-instans.

Beständigheten i containrar beror på värddatorns monteringspunkt, inte på containerfilsystemet. Ett exempel med Home Assistant Container monterar en beständig värdvolym direkt på /config, så när körtidsmiljön återskapas behöver inte hemmets konfiguration skapas på nytt. Om den kopplingen ändras vid en uppdatering kan en ersättningscontainer se nyinstallerad ut, medan det ursprungliga tillståndet fortfarande finns någon annanstans.

Kopiera inte det gamla containerfilsystemet till den nya avbilden. Återskapa driftsättningen utifrån en dokumenterad Compose- eller kördefinition och anslut det beständiga tillståndet uttryckligen.

Återställ avbilden innan du återställer ett äldre tillstånd

Om konfigurationsmonteringen är korrekt men den nya Home Assistant-versionen inte startar eller gör att en kritisk integrering slutar fungera, testa den tidigare, beprövade avbilden mot samma bevarade /config. Då kan du skilja mellan ”den nya körtidsmiljön är inte kompatibel med det aktuella tillståndet” och ”själva tillståndet är skadat”.

Det aktuella arbetsflödet för Home Assistant Container skiljer uttryckligen avbilden från det beständiga tillståndet: gör först en säkerhetskopia, hämta målbilden, återskapa containern och använd en specifik äldre bildtagg när en nedgradering krävs. Det är den återställningsgräns som ska bevaras: byt ut körtidsmiljön samtidigt som den auktoritativa konfigurationssökvägen behålls intakt.

Tänk på att vissa uppgraderingar migrerar datastrukturer när du återställer en tidigare version. Använd en säkerhetskopia från före migreringen om den äldre versionen inte kan läsa data som redan har uppgraderats av den nyare versionen på ett säkert sätt. Växla inte upprepade gånger mellan versioner med den enda kopian av beständiga data.

Återställ en säkerhetskopia endast när det aktuella tillståndet inte är tillförlitligt

Använd en säkerhetskopia om den beständiga konfigurationen saknas, är skadad, delvis överskriven eller inte längre är kompatibel med den version som du tryggt kan köra. Återställ om möjligt till en isolerad eller ren målmiljö så att du kan jämföra det återställda tillståndet med den skadade kopian.

Förvara krypteringslösenordet eller nödåterställningspaketet som behövs för att öppna säkerhetskopian utanför den felande värden. En säkerhetskopia som bara finns på samma disk eller inte kan dekrypteras ger ingen återställningsväg.

ZimaSpace-exemplet med att separera återställningen av Home Assistant från själva lagringsvärden bekräftar samma regel: applikationstillstånd behöver en oberoende återställningsväg, inte bara en speglad aktiv disk.

Verifiera den återställda containern innan du tar bort något

  • Bekräfta att förväntade användare, instrumentpaneler, integreringar, automatiseringar, hjälpare och områden finns.
  • Verifiera en lokal enhetssökväg och en radiobaserad sökväg om Zigbee, Z-Wave eller Bluetooth används.
  • Kontrollera Recorder efter databas- eller migreringsfel.
  • Starta om den återställda containern och bekräfta att samma tillstånd återkommer.
  • Behåll den gamla avbildningstaggen, konfigurationskopian och den senast fungerande säkerhetskopian tills den andra uppstarten har godkänts.

Om den gamla avbildningen med den ursprungliga konfigurationen fungerar var uppdateringsfelet främst ett problem med körmiljön eller versionen. Om alla avbildningar misslyckas med samma tillstånd, gå vidare till att reparera konfigurationen eller återställa en säkerhetskopia. Om en ren container bara fungerar med en tom /config, ska du inte betrakta den nya konfigurationen som ”åtgärdad” förrän du förstår vad i det beständiga tillståndet som hindrar återställningen.

Vanliga frågor

Ska jag ta bort Home Assistant-containern som inte fungerar innan jag felsöker?

Nej. Stoppa den först och bevara dess körningsdefinition och monterade konfigurationssökväg. Du kan skapa en ersättningscontainer utan att ta bort den som inte fungerar, så att information för återställning finns kvar medan du testar den nya körmiljön.

Varför visar Home Assistant introduktionsguiden efter en uppdatering?

Den vanligaste orsaken som är specifik för containrar är att den ersättande körmiljön inte ser den ursprungliga sökvägen /config. Kontrollera värdsystemets monteringspunkt innan du antar att konfigurationen har raderats eller återställer en äldre säkerhetskopia över nyare data.

Support och tips

Mer att läsa

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.