RomM
⏳ Doba čtení: ~6 min (801 slov)Romm.app
RomM (Rom Manager) je to v podstatě “Jellyfin pro retro hry”. Je to self-hosted webový herní manažer zaměřený na retro hry (ROMky). Funguje to tak, že mu ukážete složku s hrami a on z ní udělá krásnou, prohledávatelnou knihovnu v prohlížeči.
RomM (ROM Manager) je naprosto fantastický kus softwaru pro správu knihovny retro her s integrovaným EmulatorJS pro hraní přímo v prohlížeči. Multi-uživatelský přístup: Můžete vytvořit účet i kamarádům, aby si mohli zahrát retro klasiky na vašem serveru. Nasadit ho ale do existujícího homelabu, kde se infrastruktura řídí přes Ansible a data leží na vzdáleném SMB sdílení, nebyla taková procházka růžovým sadem, jak by se z oficiální dokumentace mohlo zdát.
Tady jsou tři hlavní infrastrukturní pasti, do kterých jsem při nasazování spadl, a jejich sysadmin řešení.
Iluze linuxových práv a SMB/CIFS mounty
Největší zásek přišel hned po úspěšném startu stacku. RomM sice hry našel a zaindexoval, ale při pokusu o spuštění emulátoru v prohlížeči konzole vyhodila chybu a Nginx log kontejneru hlásil 13: Permission denied.
Přirozený instinkt zavelel k opravě práv na hostitelském Debianu:
# Attempt to fix permissions recursively
sudo chown -R 1110:2000 /mnt/data/RomM/roms/
sudo chmod -R a+rX /mnt/data/RomM/roms/
Příkazy proběhly bez jediné chybové hlášky, ale Nginx hru stále nepřečetl. Proč? Protože data fyzicky leží na vzdáleném filesystému připojeném přes CIFS. CIFS klient sice linuxové příkazy chmod/chown přijme, ale filesystém je na pozadí tiše ignoruje a dál vynucuje masku definovanou při připojení disku.
Zatímco jiné kontejnery (třeba Audiobookshelf) běžící pod mým GID 2000 fungovaly bez potíží, Nginx uvnitř RomM spouští své worker procesy pod vlastním neprivilegovaným uživatelem. Z pohledu SMB sdílení spadá do kategorie “ostatní”, která měla v mém mountu defaultně odepřený přístup (0770).
Řešení:
Oprava se nesmí dít ručně na filesystému, ale přímo v definici SMB mountu v Ansible. Přidáním práv pro “ostatní” (dir_mode: "0775" a file_mode: "0664") dostal Nginx konečně přístup ke čtení souborů.
# Ansible SMB mount configuration snippet
smb_shares:
- name: "Data"
mount_point: "/mnt/data"
share_path: "//192.168.1.100/data"
uid: "root"
gid: "media_shared"
# Allow read and execute for Nginx worker process
dir_mode: "0775"
file_mode: "0664"
Past bind mountů a adresářové struktury
Jelikož v Ansible definuji cesty striktně, nechtěl jsem mapovat celý kořen RomM složky, ale poslat kontejneru rovnou složku s ROMkami: library_path: /mnt/data/RomM/roms.
Výsledek? Hry v knihovně kompletně zmizely.
RomM má totiž ve svém kódu natvrdo definovanou logiku. Očekává, že do kontejneru na cestu /romm/library namapujete kořen, uvnitř kterého si sám vyhledá (nebo vytvoří) složky roms/, bios/, saves/ a states/.
Když jsem mu jako kořen podstrčil rovnou složku roms, nenašel v ní to, co hledal, a tak si vytvořil absurdní vnořenou strukturu, která se na filesystému opsala jako /mnt/data/RomM/roms/roms/.
Řešením bylo zachovat v Ansible čisté mapování o úroveň výš a na sdíleném disku přizpůsobit strukturu logice RomM. Zároveň je dobré přejmenovat složky platforem na standardizované zkratky (např. gba místo Game Boy Advance), se kterými má integrovaný ScreenScraper mnohem méně práce.
Docker SIGKILL vs MariaDB tc.log
Během ladění výše zmíněných problémů jsem kontejnerový stack několikrát restartoval. Najednou RomM odmítl nastartovat s tím, že selhala migrace databáze. Pohled do logů MariaDB odhalil fatální chybu:
[ERROR] Bad magic header in tc log a Crash recovery failed.
Když restartujete službu (ať už přes Ansible playbook, nebo restartem celého VM), Docker pošle kontejnerům signál SIGTERM a začne odpočítávat 10 vteřin. MariaDB začne splachovat data a uzavírat transakce. Pokud to do 10 vteřin nestihne, Docker proces nemilosrdně ukončí pomocí SIGKILL. Pokud se to stane přesně ve chvíli zápisu do transakčního logu, poškodí se jeho hlavička a databáze odmítne nastartovat.
Nejprve záchrana: stačí smazat poškozený soubor a databáze si při dalším startu vygeneruje nový:
# Stop stack to prevent restart loops
sudo systemctl stop romm.service
# Remove corrupted log
sudo rm /opt/docker-stacks/romm/db/tc.log
sudo systemctl start romm.service
A následně systémová prevence v šabloně docker-compose.yml.j2. Přidáním parametru stop_grace_period dáte databázi dostatek času na čisté ukončení:
romm-db:
image: mariadb:11
container_name: romm-db
# Override default 10s kill timeout
stop_grace_period: 60s
volumes:
- /opt/docker-stacks/romm/db:/var/lib/mysql