Obrazy pro zařízení
Kromě ISO pro počítače vydává UFLinux i nainstalované GPT diskové obrazy .img.zst pro
konkrétní desky a pro virtuální stroje. Narozdíl od ISO se rovnou zapisují na celý disk a
systém na nich už je nainstalovaný — instalátor nespouštíte. Není na nich squashfs modloop,
účet live ani live relace.
Obrazy pro zařízení jsou doplňkové. Vydání se řídí obrazy ISO; obraz pro desku, který se nepodařilo sestavit, vydání nezdrží — a žádný z nich zatím nemá automatický test při startu. Berte je jako náhled.
Dostupné obrazy
Sekce “Dostupné obrazy”| Id | Desky | Architektura | Jádro | Start | Kořen | Stav |
|---|---|---|---|---|---|---|
rpi |
Raspberry Pi 3, 4 a 5 | aarch64 |
linux-rpi |
firmware VideoCore | f2fs | Podporováno |
vm |
QEMU, KVM a další hypervize | x86_64, aarch64 |
linux-virt |
UEFI + systemd-boot | XFS | Podporováno |
qcs6490 |
Arrow Dragon Q6A a podobné | aarch64 |
Nura linux-postmarketos-qcom-sc7280 |
firmware desky + systemd-boot | f2fs | Experimentální |
spacemit-k1 |
Orange Pi RV2, Orange Pi R2S, BananaPi-F3 | riscv64 |
linux-lts |
distro boot U-Bootu | f2fs | Experimentální |
Stav podpory jednotlivých zařízení je na jejich stránkách: Raspberry Pi, Qualcomm RB5 a RB3 Gen 2, SpacemiT K1, Virtuální stroje.
Jednodeskové cíle používají f2fs, protože ten je stavěný na rovnoměrné opotřebení a chování
při malých zápisech na kartách SD a eMMC. Obraz vm používá XFS, tedy stejný souborový systém
jako nainstalovaný systém z ISO — virtuální disk žádná z těch omezení nemá.
Společná struktura
Sekce “Společná struktura”Každý obraz má stejné GPT rozdělení o dvou oddílech: zaváděcí ESP (FAT32, název UFLINUX) a
kořen (f2fs na deskách, XFS u vm, název UFLINUX_ROOT), který zabývá zbytek disku.
Nekomprimovaný obraz má 6144 MiB (u vm 5120 MiB), takže stačí jakákoli větší karta a kořenový
oddíl se při prvním startu roztáhne na celý zbytek.
Příkazový řádek jádra používá root=UUID=<UUID souborového systému ROOT> rootwait rootfstype=<fs> rootflags=ro. Formátovače nastaví UUID souborového systému na stejné GUID jako
kořenový oddíl a Alpine initramfs předává root příkazu BusyBox mount, který umí rozluštit
UUID= a LABEL=, ale ne PARTUUID=. Explicitní typ souborového systému znamená, že initramfs
nese jen ten jeden modul, který potřebuje.
Zápis obrazu
Sekce “Zápis obrazu”zstd -d < uflinux-0.1.0-rpi-aarch64.img.zst | doas dd of=/dev/sdX bs=8M oflag=direct status=progresssyncNejdřív zkontrolujte přiložený kontrolní součet:
sha256sum -c uflinux-0.1.0-rpi-aarch64.img.zst.sha256Zápis maže všechno na cílovém zařízení. U Raspberry Pi se zapisuje na kartu, u Qualcomm desek do úložiště v režimu flash — detaily jsou na stránkách zařízení. Obrazy se publikují komprimované Zstandardem na úroveň 12.
První přihlášení
Sekce “První přihlášení”Každý obraz pro zařízení obsahuje běžný účet user / user. U grafické přihlašovací obrazovky
vyberte relaci UFLinux, nebo tento účet použijte na textové či sériové konzoli. Účet je ve
skupinách wheel, audio, video, input, netdev a až na výjimky také render, a sudo
i doas po zadání jeho hesla povolují správcovské příkazy. Heslo změníte po přihlášení:
passwdCo je při startu jinak
Sekce “Co je při startu jinak”- Žádný instalátor. Systém je nainstalovaný; po nastavení sítě si založte účet a nastavte heslo.
- Kořen se roztáhne jednou. Služba
uflinux-device— z balíčkuuflinux-device, který se publikuje v repozitáři vydání, ale v live ISO se nenachází — oddíl prodlouží při prvním startu, zařadí se po kontrolu souborových systémů a před přeponovení kořene, a pak se už neopakuje. - Přenosná konzole. Getty je zapnuté na rozhraní, které deska používá — u Pi
tty1, u Qualcomm a SpacemiT desek sériová konzole.
Aktualizace na desce
Sekce “Aktualizace na desce”Nainstalovaný /etc/apk/repositories obsahuje publikovaný repozitář UFLinux, Alpine a na
architekturách, které indexuje, také repozitář aplikací, takže apk update funguje, jakmile je
vydání veřejné. Repozitář aplikací nese uflinux-files, na který meta balíček pracovního
prostředí závisí; jeho samostatný klíč uflinux3.ec384.pub se při stavbě pro zařízení stáhne,
ověří proti build locku a nainstaluje pod přesně tímto názvem, a uflinux-release nese stejný
soubor i v nainstalovaném systému.
Výjimkou je qcs6490. Jeho jádro a EFI ovladač dtbloader pocházejí z Nury, distribuce
postmarketOS, a stahují se a rozbalují místo instalace — Nura má vlastní náhradu mkinitfs,
která je v konfliktu s alpine verzí, takže apk nesmí řešit závislosti přes oba repozitáře
naráz. Nura se v /etc/apk/repositories nikdy neobjeví. Cenou za to je, že rozbalené balíčky
nedostávají triggery a nejde aktualizovat přes apk — nahradí se nově napáleným obrazem.
Jak číst stav zařízení
Sekce “Jak číst stav zařízení”Stavební fáze pro zařízení má testy geometrie disku, identifikátorů, množiny balíčků, zaváděcí konfigurace a ověření hotového disku, a každé jméno balíčku se kontroluje proti živému indexu Alpine a proti určenému indexu Nura. Dva ze čtyř cílů jsou označené jako experimentální a žádný z obrazů nekryjí testy startu v QEMU, které ISO dostávají. Viz Ověření na fyzickém hardwaru.
Derived from docs/device-images.md inUFlinux-project/uflinux3(b4f4817). Report documentation problems inUFlinux-project/docs.