Jak zbudować możliwe do odtworzenia wdrożenie Home Assistant za pomocą kontenerów

Odtwarzalne wdrożenie kontenera Home Assistant traktuje obraz kontenera jako element jednorazowy, a stan, konfigurację, sekrety, mapowania urządzeń, działanie sieci i procedurę przywracania jako właściwy system.

Celem nie jest jedynie sprawienie, by Docker ponownie uruchomił Home Assistant. Chodzi o odbudowanie usługi na czystym hoście po nieudanej aktualizacji, utracie dysku lub wymianie hosta oraz odzyskanie tych samych użytkowników, integracji, automatyzacji, urządzeń radiowych, stanu bazy danych i tożsamości sieciowej w określonym czasie.

Przechowuj trwały stan poza obrazem kontenera

Zamontuj cały katalog konfiguracji Home Assistant w trwałej pamięci hosta i twórz kopie zapasowe wszystkiego, co się w nim znajduje, w tym ukrytych katalogów. Migracje społecznościowe wielokrotnie kończą się niepowodzeniem, gdy operatorzy kopiują widoczne pliki YAML, ale pomijają .storage, w którym przechowywane są encje zarządzane z interfejsu, integracje i inne dane stanu. Jedna z nieudanych migracji kontenera pokazuje, jak rozwijanie wzorców powłoki może po cichu pominąć te ukryte pliki.

Przechowuj plik Compose, szablon zmiennych środowiskowych, strefę czasową, tryb sieci, mapowania urządzeń, ścieżki montowań wiązanych oraz wymagane uprawnienia grup w wersjonowanych notatkach dotyczących infrastruktury. Nie umieszczaj unikalnego stanu gospodarstwa domowego w niestandardowym obrazie, chyba że masz również odtwarzalny proces kompilacji i osobną kopię odzyskiwania.

Kompleksowa topologia serwera Home Assistant w ZimaSpace przedstawia szerszy wzorzec: utrzymuj niewielką ścieżkę sterowania, oddziel trwały stan od masowej pamięci masowej i umieść mechanizmy odzyskiwania poza aktywną domeną awarii, zanim dodasz kolejne zależności usług.

Twórz spójne kopie zapasowe stanu, nie tylko często

Kopia zapasowa jest przydatna tylko wtedy, gdy jej pliki przedstawiają spójny punkt w czasie. W przypadku prostej lokalnej instalacji SQLite łatwo zrozumieć zatrzymanie usługi i skopiowanie trwałego woluminu konfiguracji w oknie serwisowym. W przypadku zewnętrznej bazy danych wykonuj kopię zapasową metodą zapewniającą spójność bazy i zapisuj, z którą kopią konfiguracji Home Assistant należy ją połączyć.

Niedawny proces tworzenia kopii zapasowej woluminu Docker podkreśla konieczność odtworzenia kopii zamiast zakładania, że pomyślne wykonanie polecenia archiwizacji oznacza możliwość odzyskania danych. Przechowuj co najmniej jedną generację poza hostem Docker, aby awaria dysku SSD, systemu plików lub przypadkowe wykonanie polecenia prune nie usunęło jednocześnie usługi i kopii zapasowej.

Zapisuj wiek kopii zapasowej, wersję aplikacji, wersję bazy danych, rozmiar, sumę kontrolną, lokalizację klucza szyfrującego oraz kroki przywracania na czystym hoście. Retencja bez metadanych przywracania tworzy stos archiwów, a nie system odzyskiwania.

Modeluj zależności i gotowość w Compose

Gdy Home Assistant zależy od MQTT, zewnętrznej bazy danych, serwera proxy lub innej usługi lokalnej, kolejność uruchamiania kontenerów nie jest równoznaczna z gotowością usługi. Proces może działać, gdy jego gniazdo, schemat lub punkt końcowy kontroli stanu są nadal niedostępne. Przewodnik po gotowości w Compose pokazuje, jak kontrole stanu i warunki zależności ograniczają wyścigi podczas uruchamiania.

Zapewnij każdej zależności własny sygnał stanu i sposób reagowania na awarie. Home Assistant powinien ponawiać próbę połączenia z uruchamianą bazą danych, ale powtarzająca się niedostępność bazy powinna być widoczna jako usterka, a nie ukryta za niekończącymi się restartami. Używaj zasad restartowania do odzyskiwania po zakończeniu procesu, a kontroli stanu i monitoringu do określania, czy usługa jest faktycznie gotowa.

W miarę możliwości trzymaj usługi opcjonalne poza krytycznym łańcuchem uruchamiania. Uszkodzony moduł renderowania pulpitu, narzędzie multimedialne lub eksporter metryk nie powinien pozostawiać kontrolera automatyzacji w trybie offline.

-15% OFF

ZimaBoard 2 – Mini serwer domowy dla Twojego wielkiego pomysłu

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Wyznaczaj granice zmian i zachowuj parę do wycofania

Przed aktualizacją zapisz bieżący znacznik obrazu Home Assistant, definicję Compose, wersję bazy danych, kopię konfiguracji oraz wersje usług towarzyszących uczestniczących w uruchamianiu. Zmieniaj jedną warstwę naraz. Jeśli aktualizacja się nie powiedzie, wycofanie wyłącznie obrazu kontenera może być niebezpieczne po zmianie konfiguracji lub migracji bazy danych, które zmodyfikowały trwały stan.

Użyj testowego przywracania lub sklonowanego katalogu odzyskiwania, aby przetestować docelową wersję przed dużą migracją hosta lub bazy danych. Zachowaj poprzedni, sprawdzony obraz oraz migawkę stanu utworzoną bezpośrednio przed aktualizacją jako parę. Usuń tę parę dopiero wtedy, gdy nowa wersja przejdzie testy automatyzacji, historii, urządzeń radiowych, pulpitów, powiadomień i ponownego uruchomienia.

Nowszy artykuł o projektowaniu Home Assistant Docker Compose traktuje sieć, trwałą pamięć masową i kopie zapasowe jako jawne decyzje wdrożeniowe. To właściwy model wycofywania zmian: zachowuj stan i definicję wdrożenia potrzebne kontenerowi zastępczemu, a nie sam jednorazowy system plików kontenera.

Odbuduj system na czystym hoście, zanim uznasz wdrożenie za odtwarzalne

Wybierz zapasową maszynę, maszynę wirtualną lub odizolowany katalog testowy i przeprowadź odzyskiwanie bez odczytywania plików z aktywnego systemu plików kontenera. Zainstaluj środowisko uruchomieniowe kontenerów, umieść definicję Compose, przywróć trwały stan, odtwórz sekrety, podłącz urządzenia radiowe za pomocą stabilnych ścieżek urządzeń, uruchom wymagane zależności i uruchom Home Assistant.

Sprawdź właścicieli plików i uprawnienia, zanim uznasz kopię za uszkodzoną. Różnice w uprawnieniach po migracji mogą wyświetlić ekran początkowej konfiguracji, nawet gdy dane istnieją. Przypadek odzyskiwania po migracji Docker pokazuje, jak uprawnienia i ukryty stan mogą niezależnie uniemożliwić wyświetlenie przywróconej instalacji.

1. Zaloguj się za pomocą istniejącego konta administratora.
2. Sprawdź integracje, encje, automatyzacje, pulpity i historię.
3. Potwierdź własność urządzeń Zigbee, Z-Wave, Thread, Bluetooth lub innych urządzeń radiowych.
4. Odłącz internet i uruchom krytyczną automatyzację lokalną.
5. Uruchom ponownie hosta oraz każdą wymaganą zależność.
6. Zmierz całkowity czas przywracania — od pustego hosta do działającego sterowania domem.

Stosuj umowę odzyskiwania dla każdej zależności uruchamianej w kontenerze

Odtwarzalne wdrożenie ma wersjonowaną definicję, stan przechowywany poza hostem, gotowość zależności, parę do wycofania oraz mierzony w czasie proces przywracania na czystym hoście. Po pomyślnym przejściu tych testów kontenery stają się tym, czym powinny być: wymiennymi jednostkami uruchomieniowymi, a nie niezastępowalnymi pupilami.