Een checklist vóór de upgrade voor Home Assistant-containers en afhankelijkheden

Leg de actieve containerconfiguratie vast voordat je Home Assistant Container bijwerkt, controleer of er een back-up buiten de container beschikbaar is, controleer of afhankelijkheden klaar zijn en bewaar een geteste rollback-image.

De permanente configuratie kan een nieuwe containercreatie overleven, maar USB-radio's, databaseservices, netwerkmodi, geheimen, aangepaste integraties en companioncontainers mogelijk niet. Stel de checklist samen op basis van de exacte huidige implementatie, niet van een generiek compose-voorbeeld. Pull en herstart pas wanneer de back-up buiten de container kan worden gevonden, er voldoende vrije ruimte is bevestigd en de vorige imageverwijzing kan worden hersteld.

Leg de actieve containerconfiguratie vast

Leg de exacte image-digest of -versie van Home Assistant, containerargumenten, netwerkmodus, gepubliceerde poorten, omgevingsvariabelen, herstartbeleid, tijdzone, beveiligingsopties, healthcheck, gekoppelde paden en apparaatkoppelingen vast. Exporteer de huidige compose- of orkestratiedefinitie en vergelijk die met de actieve container om afwijkingen vast te stellen.

Containermigraties zijn vaak afhankelijk van meer dan de zichtbare configuratiemap. Een communityverslag over de overstap van Home Assistant OS naar containers noemt afzonderlijke definities voor Zigbee2MQTT, de broker en de stack, en laat zien waarom de volledige containerstack moet worden geïnventariseerd.

PASS betekent dat een andere beheerder de huidige container op basis van het verslag kan reconstrueren zonder te gokken. FAIL betekent dat een koppeling, apparaat, geheim of opdracht alleen in de runtime-status bestaat. Breng het implementatiebestand vóór de upgrade op één lijn; anders kan een rollback een andere omgeving creëren.

Controleer de back-up buiten de container

Maak de geplande back-up, kopieer of bewaar die buiten het bestandssysteem van de container en bij voorkeur buiten hetzelfde storingsdomein van de host, en noteer vervolgens de tijdstempel en grootte. Controleer of de back-up de permanente configuratie, verborgen opslaggegevens, voor herstel vereiste geheimen en eventuele externe databaseback-up bevat die de gekozen architectuur nodig heeft.

In een Docker-herstelbespreking wordt nadrukkelijk aanbevolen back-ups buiten de container te bewaren en de nieuwste back-up te kopiëren voordat de oude instantie wordt verwijderd. Die regel voor back-ups buiten de container voorkomt dat het vervangen van de container de enige herstelkopie verwijdert.

PASS betekent dat het bestand vanuit de herstelomgeving leesbaar is en dat de inhoud of een testherstel is gecontroleerd. FAIL betekent dat de back-up alleen bestaat in het volume dat wordt gewijzigd of afhankelijk is van ongedocumenteerde toegangsgegevens. Stop de upgrade totdat het herstel onafhankelijk is van de nieuwe container.

Controleer database-, opslag- en radioafhankelijkheden

Leg de database-engine en -versie, broker- en bridgeversies, USB-apparaatpaden, firmwarestatus van de radio, netwerkadressen, DNS-namen en de status van elke vereiste companionservice vast. Controleer de actuele vrije ruimte voor imagelagen, database-migratiewerkzaamheden, logs en de rollbackkopie.

Een praktische workflow voor het bijwerken van containers waarschuwt dat een databaseschemamigratie de gereedheid van de API kan vertragen en dat herhaaldelijk herstarten de voortgang kan onderbreken. De volgorde in een rollbackbewuste Docker-update ondersteunt het instellen van een observatievenster voor migraties voordat de actieve image wordt vervangen.

PASS betekent dat elke afhankelijkheid gezond en bereikbaar is, compatibel is met de doelrelease en in de rollbackplanning is opgenomen. FAIL betekent dat een radiopad instabiel is, een database al ongezond is of de vrije ruimte krap is. Herstel eerst de uitgangssituatie, zodat een bestaande fout niet aan de upgrade wordt toegeschreven.

-15% OFF

ZimaBoard 2 - Mini-thuisserver voor jouw grote idee

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Beoordeel aangepaste integraties en releaserisico

Maak een lijst van aangepaste integraties, frontendbronnen, thema's, automatiseringen die verouderde services aanroepen en companioncomponenten met een vastgepinde versie. Controleer hun onderhoudsstatus en compatibiliteit met de doelversie. Schakel standaard niets uit; bepaal in plaats daarvan welke optionele component als eerste kan worden geïsoleerd als het opstarten mislukt.

Home Assistant-gebruikers die Docker-upgrades plannen, controleren vaak eerst back-up- en rollbackstappen voordat ze een langlopende versie wijzigen. Een bespreking over voorbereiding op containerupdates laat zien waarom de oude image en de permanente gegevens samen beschikbaar moeten blijven.

PASS betekent dat bekende compatibiliteitsrisico's een isolatievolgorde hebben en dat niets essentiële lokale bediening blokkeert. FAIL betekent dat een niet-onderhouden aangepast component vereist maar niet getest is. Stel de upgrade uit, test de doelimage tegen een kopie of accepteer vóór het plannen van productiestilstand een gedocumenteerde beperkte werking.

Definieer de upgradepoort en rollbacktrigger

Schrijf de exacte stopvolgorde, stappen voor het pullen van de image en het opnieuw creëren van de container, verwachte migratiesignalen, validatiechecklist, maximale uitvaltijd en rollbackopdracht op. Bewaar de digest van de oude image en wijzig de permanente gegevens niet handmatig tijdens de observatieperiode van de eerste start. Kies een onderhoudsvenster waarin lokale handmatige bediening beschikbaar is.

Gebruik de veilige migratiechecklist van ZimaSpace om radio's, opslag, netwerkinstellingen, integraties en een geteste fallback buiten de container zelf op te nemen.

Ga alleen verder wanneer alle eerdere poorten zijn gepasseerd. Controleer na de upgrade de logs, Recorder, essentiële integraties, één lokale automatisering, één extern pad, het maken van een back-up en een tweede herstart. Voer een rollback uit wanneer migratiefouten zich herhalen, essentiële bediening de uitvaltijdlimiet overschrijdt of de nieuwe container de vastgelegde configuratie niet kan reproduceren.