Migrace HomeAssistanta z Ubuntu na Debian v modifikaci Armbian

🎙 Poslední aktualizace článku 21.2.2021. Pokud najdete nějaké rozdíly v aktuálním stavu, dejte vědět v komentářích, díky.

V květnu loňského roku je rozproudila velká debata ohledně plánováno ukončení obecné podpory platformy Linux, která nakonec vyústila až v pozastavení tohoto kroku. Jedinou podporovanou distribucí by měl být Debian. Otázka jak dlouho bude trvat než tento krok bude opět na stole.

Navíc mě už poměrně dlouho dráždila červená hláška v supervisoru, že mé Ubuntu není v seznamu podporovaných instalací (i když zrovna Ubuntu má k Debianu velmi blízko) a tak jsem se rozhodl, že je čas na upgrade.

V dnešním článku si tak ukážeme jak postupovat pokud chceme na stejném počítači rozchodit HomeAssistant ne jiném operačním systému tak, abychom na konci nic nepoznali a měli úplně stejné prostředí jen na Debianu.

Celý proces nakonec nebude až tak složitý jak by se možná mohl zdát, ale připravte si na něj alespoň jedno dopoledne.

Budou nás čekat následující kroky:

1. Vytvoření aktuální plné zálohy HomeAssistanta
2. Záloha vše ostatního co máme na Ubuntu (nebo jiné distribuci)
3. Stažení image Armbianu založeného na Debianu
4. Nahrání image na SD kartu a nabootování
5. Přesun systému z SD karty na eMMC nebo NVME SSD
6. Instalace Dockeru
7. Instalace HomeAssistanta
8. Obnova ze zálohy

NanoPC-T4 – můj HW jako ukázka migrace

Ještě než se do jednotlivých kroků pustíme rád bych vám představil minipočítač na kterém to vše provedeme. Jedná se stroj s označením NanoPC-T4 pod značkou FriendlyElec s 6-ti jádry čipu Rockchip RK3399, 4GB operační paměti a integrovaných eMMC úložištěm o velikosti 16GB. Kromě interního úložiště můžete navíc připojit i NVME SSD, což jsem u využil.

Já používám tenhle stroj momentálně téměř 2 roky a jsem velmi spokojený. Je zároveň fér říct, že v té době nebyl dostupný Raspberry PI 4 (AliExpress, Alza) a určitě bych mezi těmito dvěmi váhal. Do budoucna bude zajímavé sledovat i Odroid N2+ v HomeAssistant variantě, který je teď ale už poměrně dlouho vyprodaný.

Jediným problémem, které je společný pro všechny desky používající čip RK3399 je chlazení, jelikož topí opravdu hodně. Pokud použijete dodávaný pasivní chladič, tak je vše víceméně vpořádku dokud nezavřete desku do krabičky a stroj nezatížíte. Pak teploty velice často atakují 80°C nicméně nestalo se mi, že mi se někdy systém zasekl.

To jsem chtěl vyřešit zakoupením chladiče s větrákem, který se měl automaticky spouštět podle teploty CPU nicméně v předešlém Armbianu na Ubuntu to nefungovalo. O to více mě potěšilo, že nyní už vše jede jak má a chladič se sám zapíná a navíc reguluje i otáčky, takže ho často neuslyšíte i když poběží – další důvod k upgradu.

A nyní už se pojďme vrhnout do migrace. Podotýkám, že postup by měl být velice podobný i pro jiné desky a bude potřeba zřejmě jen pokud máte jinou Linux distribuci než Debian.

1. Vytvoření aktuální plné zálohy HomeAssistanta

Přihlásíme se do HomeAssistanta a v menu Supervisor klikneme na záložku Snapshots, vyplníme název zálohy – víceméně cokoliv a je důležité zvolit volbu Full snapshot. Nakonec klikneme na volbu Create a čekáme.

Bohužel neuvidíme žádný rozumný indikátor procesu tvorby zálohy a záloha může trvat opravdu dlouho – klidně i půl hodiny – hodně záleží na množství používaných Addonů a rychlosti disku.

Mě se osvědčilo koukat do záložky System v Supervisoru a v dolní sekci logu uvidíme něco jako:

21-02-21 09:38:37 INFO (MainThread) [supervisor.snapshots] Creating new full-snapshot with slug 2e0efd54
21-02-21 09:38:37 INFO (MainThread) [supervisor.snapshots] Snapshotting 2e0efd54 store Add-ons
21-02-21 09:38:37 INFO (MainThread) [supervisor.addons.addon] Building snapshot for add-on a0d7b954_ide
21-02-21 09:38:37 INFO (MainThread) [supervisor.addons.addon] Finish snapshot for addon a0d7b954_ide
21-02-21 09:38:37 INFO (MainThread) [supervisor.addons.addon] Building snapshot for add-on a0d7b954_grafana
21-02-21 09:38:37 INFO (MainThread) [supervisor.addons.addon] Finish snapshot for addon a0d7b954_grafana

… což nám dává alespoň nějakou představu jak daleko záloha, resp. co už bylo dokončeno. Konec pak poznáte podle tohoto logu:

21-02-21 09:54:18 INFO (SyncWorker_0) [supervisor.snapshots.snapshot] Snapshot folder media
21-02-21 09:54:18 INFO (SyncWorker_0) [supervisor.snapshots.snapshot] Snapshot folder media done
21-02-21 09:54:23 INFO (MainThread) [supervisor.snapshots] Creating full-snapshot with slug 2e0efd54 completed

A teď to nejdůležitější – jakmile je záloha hotová stáhneme si ji k sobě na disk 🚨 pomocí volby Download snapshot po kliknutí na příslušnou zálohu.

Pokud byste si chtěli o zálohách přečíst více pak jsem nedávno napsal poměrně podrobný článek na toto téma.

2. Záloha vše ostatního co máme na Ubuntu (nebo jiné distribuci)

Tuhle část zde zmiňuju pro jistotu, abyste se zamysleli, zda nepotřebujete zálohovat ještě něco dalšího – obecně pokud pouze využíváte addony HomeAssistantu tak vše najdete v záloze HomeAssistanta. Pokud jste si však např. v Dockeru zprovozňovali cokoliv dalšího mimo Supervisor pak je nyní čas si to zálohovat také.

Pokud nic mimo Supervisor nemáte můžete směle pokračovat rovnou dalším krokem.

3. Stažení image Armbianu založeného na Debianu

Já už dlouhodobě používám modifikace Linuxových systémů pro ARMy s označením Armbian.

Pokud však máte například Raspberry Pi pak je postup velice podobný, jen je potřeba si stáhnout image Raspbianu a s největší pravděpodobností už tento systém máte.

Na webu Armbianu si najdeme naší desku – v mém případě NanoPC-T4 a jelikož základní nabízené verze jsou desktopové klikneme na volbu Check other download options.

V seznamu bohužel není zřejmé co je Ubuntu a co Debian, takže si musíme nejprve najít správné označení. V době psaní tohoto článku nese poslední verze Debianu označení Buster a my si tak stáhneme tu na třetím řádku – jedná se o nedesktopovou verzi s 5tkovým Linux kernelem.

4. Nahrání image na SD kartu a nabootování

Do počítače si zasunume SD kartu a spustíme aplikaci balenaEtcher, která slouží pro nahrávání image na SD karty.

Použití aplikace je poměrně jednoduché – najdeme stáhnutou image, vybereme jako cíl SD kartu a klikneme na Flash!

Kartu vložíme do minipočítače a nabootujeme z ní.

Pokud už ale operační systém na minipočítači na jiném disku máte pak bude potřeba velmi pravděpodobně vynutit boot z SD karty, což bude velmi rozdílná v závilosti na konkrétním modelu desky.

V případě NanoPC-T4 je potřeba držet tlačítko Boot při zapnutí a to najdeme na pravé straně.

Po prvotním startu budeme potřebovat ještě nastavit root heslo a můžeme pokračovat dalším krokem.

 _   _                   ____   ____   _____ _  _
| \ | | __ _ _ __   ___ |  _ \ / ___| |_   _| || |
|  \| |/ _` | '_ \ / _ \| |_) | |       | | | || |_
| |\  | (_| | | | | (_) |  __/| |___    | | |__   _|
|_| \_|\__,_|_| |_|\___/|_|    \____|   |_|    |_|

Welcome to Armbian 21.02.1 Buster with Linux 5.10.12-rockchip64

System load:   3%           	Up time:       6 days 16:56
Memory usage:  40% of 3.71G  	Zram usage:    14% of 1.85G  	IP:            10.2.1.2
CPU temp:      58°C           	Usage of /:    4% of 458G

5. Přesun systému z SD karty na eMMC nebo NVME SSD

Tenhle krok je opět nepovinný a záleží na konkrétní desce zda má kromě SD uložiště i nějakou další možnost.

Pokud máte k dispozici eMMC tak určitě doporučuji systém přesunout z SD karty tam, pokud navíc máte možnost připojení NVME SSD a nebo i klasických disků s nějakou rozumnou rychlostí přenosu pak to udělejte také.

V případě Armbianu se situace zjednoduší díky příkazu nand-sata-install a nebo si ji najdeme v armbian-config aplikaci v sekci System -> Install.

6. Instalace Dockeru

Nejprve si nainstaluje balíčky, které je potřeba mít ještě před instalací Dockeru:

sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common

.. stáhneme si APT klíč pro repozitář dockeru:

curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -

… přidáme si nový repozitář:

sudo add-apt-repository \
   "deb [arch=arm64] https://download.docker.com/linux/debian \
   $(lsb_release -cs) \
   stable"

… provedeme refresh seznamu balíčků

sudo apt-get update

… a konečně nainstalujeme samotný docker:

sudo apt-get install docker-ce docker-ce-cli containerd.io

Funkční instalaci si můžeme ověřit pomocí příkazu docker version:

Client: Docker Engine - Community
 Version:           20.10.3
 API version:       1.41
 Go version:        go1.13.15
 Git commit:        48d30b5
 Built:             Fri Jan 29 14:33:52 2021
 OS/Arch:           linux/arm64
 Context:           default
 Experimental:      true

Server: Docker Engine - Community
 Engine:
  Version:          20.10.3
  API version:      1.41 (minimum version 1.12)
  Go version:       go1.13.15
  Git commit:       46229ca
  Built:            Fri Jan 29 14:32:07 2021
  OS/Arch:          linux/arm64
  Experimental:     false
 containerd:
  Version:          1.4.3
  GitCommit:        269548fa27e0089a8b8278fc4fc781d7f65a939b
 runc:
  Version:          1.0.0-rc92
  GitCommit:        ff819c7e9184c13b7c2607fe6c30ae19403a7aff
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

7. Instalace HomeAssistanta

Ještě než se vrhneme na instalační skript HomeAssistanta bude potřeba doinstalovat jeden balíček:

sudo apt-get install apparmor

Nyní by již mělo být vše připraveno ale pro jistotu ještě uvedenu seznam všeho potřebného:

• Docker CE >= 19.03
• Systemd >= 239
• NetworkManager >= 1.14.6
• AppArmor == 2.13.x (built into the kernel)
• Debian Linux Debian 10 aka Buster (no derivatives)

Nejprve si stáhneme instalační skript (více info najdete v Git repozitáři):

curl -Lo installer.sh https://raw.githubusercontent.com/home-assistant/supervised-installer/master/installer.sh

… a instalátor spustíme pomocí:

bash installer.sh -m <TYP_DESKY>

Za <TYP_DESKY> je potřeba dosadit správnou hodnotu v závislosti na vaší desce. V našem případě máme obecný ARM 64bit takže použijeme volbu qemuarm-64

tj. příkaz pak bude vypadat takto:

bash installer.sh -m qemuarm-64

Seznam všech možných hodnot je aktuálně:

• intel-nuc
• odroid-c2
• odroid-n2
• odroid-xu
• qemuarm
• qemuarm-64
• qemux86
• qemux86-64
• raspberrypi
• raspberrypi2
• raspberrypi3
• raspberrypi4
• raspberrypi3-64
• raspberrypi4-64
• tinker

Po spuštění skriptu je potřeba nejprve 10 sekund počkat a pak se ještě instalátor zeptá zda chceme přepsat síťové interfaces – já dávám ano, ale vlastně si nejsem jistý zda je to nutné.

[warn]
[warn] If you want more control over your own system, run
[warn] Home Assistant as a VM or run Home Assistant Core
[warn] via a Docker container.
[warn]
[warn] If you want to abort, hit ctrl+c within 10 seconds...
[warn]
[info] Creating NetworkManager configuration
[warn] Changes are needed to the /etc/network/interfaces file
[info] If you have modified the network on the host manualy, those can now be overwritten
[info] If you do not overwrite this now you need to manually adjust it later
[info] Do you want to proceed with overwriting the /etc/network/interfaces file? [N/y]
[info] Replacing /etc/network/interfaces
[info] Restarting NetworkManager
...

Instalátor pak skončí

[info] Start Home Assistant Supervised
[info] Installing the 'ha' cli
[info]
[info] Home Assistant supervised is now installed
[info] First setup will take some time, when it's ready you can reach it here:
[info] http://10.2.1.2:8123
[info]

… čím nám dává najevo, že ještě rozhodně není hotovo a měli bychom ještě čekat.

Po pár minutách doporučuji se už kouknout na uvedenou adresu, kde byste měli vidět něco jako:

Je potřeba vydržet a brzy byste měli vidět obrazovku s možnosti vytvoření účtu do HomeAssistanta a nebo obnovením ze zálohy a to je to co potřebujeme.

8. Obnova ze zálohy

Vybereme proto volbu restore from a previous snaphost a podstrčíme zálohu, kterou máme na disku:

Tak jako samotná tvorba zálohy byla poměrně pomalá tak obnova bude zřejmě ještě pomalejší. Je potřeba být proto trpěliví, ale já mám vyzkoušeno, že nakonec se systém obnoví skutečně do stavu v jakém jsme ho měli dříve.

Hotovo!

Do HomeAssistanta byste měli být schopní se nyní přihlásit stejným uživatelem jako dříve a pokud se podíváme do informací o supervisoru tak vidíme, že ona otravná červená hláška je konečně pryč 🙂

Já musím říct, že až na pomalost tvorby a obnovy záloh se podařilo systém na jiné distribuci poměrně jednoduše rozchodit.

Je to příslibem poměrně jednoduchého obnovení v případě kolabsu systému – tedy za předpokladu, že budete mít zálohu a budete schopní se k ní dostat. Dokonce i celá Zigbee síť se chytla hned napoprvé bez nutnosti cokoliv přepárovat.

A jakou distribuci Linuxu / Windows používáte vy pro HomeAssistant a proč?