Jak sprawdzić, czy Home Assistant używa oczekiwanego pliku konfiguracyjnego

Eva Wong

IceWhale author

Eva Wong jest Technicznym pisarzem i stałym majsterkowiczem w ZimaSpace. Całe życie geek z pasją do homelabów i oprogramowania open-source, specjalizuje się w tłumaczeniu skomplikowanych koncepcji technicznych na przystępne, praktyczne przewodniki. Eva wierzy, że samodzielne hostowanie powinno być zabawą, a nie czymś onieśmielającym. Poprzez swoje samouczki umożliwia społeczności rozwiewanie tajemnic konfiguracji sprzętu, od budowy pierwszego NAS po opanowanie kontenerów Docker.

How to Tell Whether Home Assistant Is Using the Expected Configuration File

Home Assistant korzysta wyłącznie z oczekiwanego pliku konfiguracyjnego wtedy, gdy zgłaszany przez środowisko uruchomieniowe katalog konfiguracji, zamontowana ścieżka hosta i kontrolowany test weryfikacyjny wskazują na ten sam plik.

To nieporozumienie jest częste, gdy katalog /config istnieje wewnątrz kontenera, ale wskazuje na inny katalog na hoście, albo gdy zarówno stare montowanie wiązane, jak i nowo edytowana kopia zawierają plik configuration.yaml. Najpierw zapisz ścieżkę środowiska uruchomieniowego, prześledź jej montowanie bez wprowadzania zmian, porównaj tożsamość pliku i znaczniki czasu, a następnie użyj nieszkodliwego, odwracalnego znacznika, aby potwierdzić, z którego drzewa korzysta uruchomiona instancja.

Zapisz katalog konfiguracji zgłaszany przez uruchomioną instancję

Otwórz Informacje o systemie w uruchomionej instancji Home Assistant i dokładnie zapisz wyświetlony katalog konfiguracji. Zapisz również typ instalacji, wersję Core, nazwę kontenera lub maszyny wirtualnej oraz czas ostatniego pomyślnego ponownego uruchomienia. Dzięki temu ustalisz widok środowiska uruchomieniowego, zanim ścieżki hosta wprowadzą dodatkowe komplikacje.

Wyjaśnienia społeczności pokazują, dlaczego /config może oznaczać ścieżkę wewnętrzną, podczas gdy odpowiadający jej katalog na hoście różni się w zależności od instalacji. Kluczowe jest rozróżnienie między wnętrzem a zewnętrzem kontenera, a nie jedna uniwersalna lokalizacja w systemie plików.

Jeśli zgłoszony katalog zawiera plik edytowany w tej samej przestrzeni nazw środowiska uruchomieniowego, przejdź do sprawdzenia pliku. Jeśli go tam nie ma, przerwij edycję tej kopii. Gdy interfejs użytkownika jest niedostępny, sprawdź uruchomiony proces albo argumenty i montowania kontenera, zamiast zgadywać na podstawie starego poradnika.

Prześledź ścieżkę hosta przez aktywne montowanie

Sprawdź uruchomiony kontener lub usługę Compose i znajdź źródło mapowane na katalog konfiguracji środowiska uruchomieniowego. Ścieżki względne rozwiązuj względem rzeczywistego katalogu projektu Compose. W przypadku instalacji na maszynie wirtualnej lub HAOS rozróżnij ścieżkę gościa od danych widocznych dla hiperwizora.

W zgłoszeniu dotyczącym projektu Home Assistant opisano przypadek, w którym interfejs użytkownika wyświetlał ścieżkę wewnątrz kontenera, podczas gdy rzeczywiste dane hosta HAOS znajdowały się gdzie indziej. Ten przypadek rozbieżności ścieżek hosta i kontenera potwierdza, że należy prześledzić montowanie, a nie kopiować jego dokładnej ścieżki do innej instalacji.

Porównaj aktywne źródło montowania z katalogiem używanym w edytorze lub udostępnianiu plików. Jeśli się różnią, nie scalaj ich jeszcze. Zachowaj oba drzewa, zanotuj ich czasy modyfikacji i rozmiary oraz ustal, które zawiera bieżący rejestr encji, automatyzacje i najnowsze wpisy w logach.

Potwierdź tożsamość pliku za pomocą bezpiecznej, kontrolowanej zmiany

Przed testem uruchom sprawdzanie konfiguracji w tym samym środowisku i wykonaj kopię zapasową aktywnego drzewa. Dodaj do podejrzanego pliku nieszkodliwy, jednoznacznie nazwany komentarz lub inny odwracalny znacznik, zapisz go i potwierdź zmianę znacznika czasu w miejscu wskazywanym przez montowanie środowiska uruchomieniowego.

Użyj standardowej ścieżki sprawdzania konfiguracji, a następnie, jeśli to możliwe, przeładuj tylko odpowiednią domenę obsługującą przeładowanie. Jeśli wymagane jest pełne ponowne uruchomienie, wykonaj je raz po walidacji i sprawdź w logu plik lub integrację, które zostały zmienione. Ponowne uruchomienie bez potwierdzenia ścieżki może po prostu ponownie wczytać niewłaściwy plik.

Powiązany artykuł ZimaSpace o ścieżce danych Home Assistant pomaga odróżnić widoczny stan interfejsu od trwałych plików konfiguracji i rejestrów, które go utworzyły.

-15% OFF

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

Single board computer zimaboard2

Popraw montowanie i sprawdź trwałość danych

Jeśli zamontowane jest niewłaściwe źródło, zatrzymaj Home Assistant, zachowaj oba katalogi i popraw wyłącznie definicję montowania, która odtwarza kontener. Przed uruchomieniem sprawdź właściciela i uprawnienia. Nie kopiuj starszego drzewa na nowszy stan, chyba że jednoznacznie ustaliłeś, które dane mają mieć pierwszeństwo.

Po uruchomieniu ponownie sprawdź ścieżkę środowiska uruchomieniowego, montowanie, znacznik czasu, konfigurację i test znacznika. Pomyślny wynik potwierdza, że odczytywany jest oczekiwany plik, bieżące rejestry pozostają obecne, a to samo mapowanie przetrwa ponowne utworzenie kontenera lub restart hosta.

Przywróć poprzednie montowanie, jeśli Home Assistant uruchomi się bez danych, utraci integracje albo zgłosi błędy uprawnień. Jeśli mapowanie nadal jest niejednoznaczne, przekaż typ instalacji, katalog środowiska uruchomieniowego, źródło i miejsce docelowe montowania oraz zanonimizowany wykaz katalogu; usuwaj zduplikowane drzewa dopiero po niezależnym potwierdzeniu sprawnego odzyskiwania danych.