En checklista inför uppgradering av Home Assistant-behållare och beroenden

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 bevara en testad återställningsavbild.

Den beständiga konfigurationen kan överleva när containern återskapas, medan USB-radioenheter, databastjänster, nätverkslägen, hemligheter, anpassade integrationer och kompletterande containrar inte behöver göra det. Bygg checklistan utifrån den exakta aktuella driftsättningen, inte ett generiskt compose-exempel. Hämta inte den nya avbilden och starta om förrän säkerhetskopian kan hittas utanför containern, tillräckligt ledigt utrymme har bekräftats och referensen till den tidigare avbilden kan återställas.

Dokumentera den körande containerns konfiguration

Dokumentera den exakta Home Assistant-avbildens 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.

Containermigreringar är ofta beroende av mer än den synliga konfigurationskatalogen. En community-användares beskrivning av en flytt 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. UNDERKÄNT betyder att en monterad sökväg, enhet, hemlighet eller ett kommando endast finns i körningstillståndet. Synkronisera 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 felområde på värddatorn, och dokumentera dess tidsstämpel och storlek. Bekräfta att den innehåller den beständiga konfigurationen, dolda lagringsposter, hemligheter som krävs för återställning samt eventuell extern databassäkerhetskopia som behövs för den valda arkitekturen.

En diskussion om återställning i Docker rekommenderar uttryckligen att säkerhetskopior förvaras utanför containern och att den senaste säkerhetskopian kopieras innan den gamla instansen tas bort. Denna regel om säkerhetskopiering utanför containern förhindrar att containerersättningen tar bort den enda återställningskopian.

GODKÄNT betyder att filen kan läsas från återställningsmiljön och att innehållet eller en teståterställning har verifierats. UNDERKÄNT betyder att säkerhetskopian endast finns i den volym som ändras eller är beroende av odokumenterade autentiseringsuppgifter. Avbryt uppgraderingen tills återställningen är oberoende av den nya containern.

Kontrollera databas-, lagrings- och radio­beroenden

Dokumentera databasmotor och version, broker- och bryggversioner, USB-enheternas sökvägar, radions firmwarestatus, nätverksadresser, DNS-namn och status för varje nödvändig kompletterande tjänst. Kontrollera aktuellt ledigt utrymme för avbildslager, databasmigrering, loggar och återställningskopian.

Ett praktiskt arbetsflöde för uppdatering av containrar varnar för att migrering av databasschemat kan fördröja API:ets tillgänglighet och att upprepade omstarter kan avbryta förloppet. Sekvensen i en Docker-uppdatering med fokus på återställning stöder att man definierar ett observationsfönster för migreringen innan den körande avbilden ändras.

GODKÄNT betyder att varje beroende är friskt, nåbart, kompatibelt med målversionen och inkluderat i återställningsplaneringen. UNDERKÄNT betyder att en radioväg är instabil, att en databas redan är felaktig eller att det lediga utrymmet är knappt. Åtgärda baslinjen först så att ett redan befintligt fel inte tillskrivs uppgraderingen.

-15% OFF

ZimaBoard 2 - Minihemmserver för din stora idé

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Granska anpassade integrationer och versionsrisker

Lista anpassade integrationer, frontendresurser, teman, automationer som anropar föråldrade tjänster samt versionslåsta kompletterande komponenter. Kontrollera deras underhållsstatus och kompatibilitet med målversionen. Inaktivera inget som standard; identifiera i stället vilken valfri komponent som först kan isoleras om starten misslyckas.

Home Assistant-användare som planerar Docker-uppgraderingar brukar verifiera säkerhetskopierings- och återställningsstegen innan de ändrar en version som har körts länge. En diskussion om förberedelser inför containeruppdatering visar varför den gamla avbilden och den beständiga datan måste finnas kvar tillsammans.

GODKÄNT betyder att kända kompatibilitetsrisker har en isoleringsordning och att ingen av dem blockerar nödvändig lokal styrning. UNDERKÄNT betyder att en oanpassad komponent krävs men inte har testats. Skjut upp uppgraderingen, testa målavbilden mot en kopia eller acceptera ett dokumenterat begränsat driftläge innan produktionsavbrottet schemaläggs.

Definiera uppgraderingsgrinden och utlösaren för återställning

Skriv ner den exakta stoppordningen, stegen för att hämta avbilden och återskapa containern, förväntade migreringssignaler, valideringschecklista, maximala avbrottstid och återställningskommando. Bevara den gamla avbildens digest och ändra inte beständig data manuellt under den första observationsperioden efter starten. Välj ett underhållsfönster där lokal manuell styrning är tillgänglig.

Använd ZimaSpaces säkra migreringschecklista för att inkludera radioenheter, lagring, nätverksinställningar, integrationer och en testad reservlösning som sträcker sig längre än själva containern.

Fortsätt endast när alla tidigare grindar är godkända. Efter uppgraderingen ska du verifiera loggar, Recorder, nödvändiga integrationer, en lokal automation, en fjärrväg, skapande av säkerhetskopia och en andra omstart. Återställ när migreringsfel upprepas, nödvändig styrning överskrider avbrottsgränsen eller den nya containern inte kan återskapa den dokumenterade konfigurationen.