En checklista inför uppgradering av Home Assistant-containrar och beroenden

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.

Innan du uppgraderar Home Assistant Container ska du dokumentera den körande containerns konfiguration, verifiera en säkerhetskopia utanför containern, kontrollera att beroendena är redo och spara en testad återställningsavbildning.

Den beständiga konfigurationen kan överleva när containern återskapas, medan USB-radior, databastjänster, nätverkslägen, hemligheter, anpassade integrationer eller kompletterande containrar kanske inte gör det. Skapa checklistan utifrån den exakta aktuella driftsättningen, inte ett generiskt compose-exempel. Hämta inte avbildningen och starta om innan säkerhetskopian kan hittas utanför containern, tillräckligt med ledigt utrymme har bekräftats och referensen till den tidigare avbildningen kan återställas.

Dokumentera den körande containerns konfiguration

Dokumentera den exakta Home Assistant-avbildningens digest eller version, containerargument, nätverksläge, publicerade portar, miljövariabler, omstartspolicy, tidszon, säkerhetsalternativ, hälsokontroll, monterade sökvägar och enhetsmappningar. Exportera den aktuella compose- eller orkestreringsdefinitionen och jämför den med den körande containern för att upptäcka avvikelser.

Vid containermigreringar krävs ofta mer än den synliga konfigurationskatalogen. En användares redogörelse för flytten från Home Assistant OS till containrar lyfter fram separata definitioner för Zigbee2MQTT, broker och stack, vilket visar varför hela containerstacken måste inventeras.

GODKÄNT betyder att en annan administratör kan återskapa den aktuella containern utifrån dokumentationen utan att behöva gissa. MISSLYCKAT betyder att en monteringspunkt, enhet, hemlighet eller ett kommando bara finns i körningstillståndet. Stäm av driftsättningsfilen innan uppgraderingen; annars kan en återställning återskapa en annan miljö.

Verifiera säkerhetskopian utanför containern

Skapa den planerade säkerhetskopian, kopiera eller lagra den utanför containerns filsystem och helst utanför samma värdmiljö som kan drabbas av ett fel. Anteckna sedan tidsstämpel och storlek. Kontrollera att den innehåller den beständiga konfigurationen, dolda lagringsposter, hemligheter som krävs för återställning och eventuell extern databassäkerhetskopia som behövs för den valda arkitekturen.

I en diskussion om Docker-återställning rekommenderas uttryckligen att säkerhetskopior förvaras utanför containern och att den senaste säkerhetskopian kopieras innan den gamla instansen tas bort. Den regeln om säkerhetskopior utanför containern förhindrar att en ersättning av containern raderar den enda återställningskopian.

GODKÄNT betyder att filen är läsbar från återställningsmiljön och att innehållet eller en teståterställning har verifierats. MISSLYCKAT betyder att säkerhetskopian bara finns på volymen som ändras eller är beroende av odokumenterade inloggningsuppgifter. Avbryt uppgraderingen tills återställningen är oberoende av den nya containern.

Kontrollera databaser, lagring och radioberoenden

Dokumentera databasmotor och version, versioner för mäklare och bryggor, sökvägar till USB-enheter, radioprogramvarans status, nätverksadresser, DNS-namn och status för alla nödvändiga kompletterande tjänster. Kontrollera hur mycket ledigt utrymme som finns för avbildningslager, databasmigrering, loggar och återställningskopian.

En praktisk arbetsgång för containeruppdatering varnar för att migrering av databasschemat kan fördröja API:ets tillgänglighet och att upprepade omstarter kan avbryta förloppet. Stegen i en Docker-uppdatering med återställning i åtanke hjälper dig att fastställa en observationsperiod för migreringen innan den körande avbildningen ändras.

GODKÄNT innebär att alla beroenden fungerar, går att nå, är kompatibla med målversionen och ingår i planen för återställning. UNDERKÄNT innebär att en radioanslutning är instabil, en databas redan är i dåligt skick eller det tillgängliga diskutrymmet är knappt. Åtgärda grundläget först, så att ett redan befintligt fel inte tillskrivs uppgraderingen.

Single board computer zimaboard2

Granska anpassade integrationer och versionsrisker

Lista anpassade integrationer, frontend-resurser, teman, automatiseringar som anropar föråldrade tjänster och versionslåsta kompletterande komponenter. Kontrollera att de underhålls och är kompatibla med målversionen. Inaktivera inget som standard; ta i stället reda på vilken valfri komponent som först kan isoleras om starten misslyckas.

Home Assistant-användare som planerar Docker-uppgraderingar kontrollerar ofta stegen för säkerhetskopiering och återställning innan de ändrar en version som körts länge. En diskussion om förberedelser inför containeruppdatering visar varför den gamla avbildningen och de beständiga uppgifterna måste finnas tillgängliga samtidigt.

GODKÄNT innebär att kända kompatibilitetsrisker har en plan för isolering och att ingen av dem hindrar viktig lokal styrning. UNDERKÄNT innebär att en icke-underhållen anpassad komponent krävs men inte har testats. Skjut upp uppgraderingen, testa målversionens avbildning mot en kopia eller godta ett dokumenterat begränsat läge innan du planerar driftstopp i produktionsmiljön.

Definiera uppgraderingsvillkor och utlösare för återställning

Skriv ned den exakta ordningen för avstängning, stegen för att hämta avbildningen och återskapa containern, förväntade migreringssignaler, valideringschecklistan, den maximala avbrottstiden och kommandot för återställning. Spara den gamla avbildningens digest och ändra inte beständiga data manuellt under observationsperioden vid första starten. Välj ett underhållsfönster då lokal manuell styrning är tillgänglig.

Använd ZimaSpaces checklista för säker migrering för att ta med radiokommunikation, lagring, nätverksinställningar, integrationer och en testad reservplan utöver själva containern.

Fortsätt endast när alla tidigare kontrollpunkter är godkända. Efter uppgraderingen kontrollerar du loggarna, Recorder, viktiga integrationer, en lokal automatisering, en fjärranslutning, att en säkerhetskopia har skapats och att systemet startas om en andra gång. Återställ när migreringsfel upprepas, viktig styrning överskrider avbrottsgränsen eller den nya containern inte kan återskapa det dokumenterade funktionsavtalet.

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.