Přenosná verze

Spusť HolyArrs jako obyčejný program na Linuxu nebo Windows, bez Dockeru. Docker zůstává hlavním způsobem provozu.

Upozornění

Přenosné archivy zatím nikdo nezveřejňuje a nejsou podepsané. Sestavíš si je sám ze zdrojů.

Než začneš

• Na počítači, kde sestavuješ, Python 3, Git a Docker.
• Naplněná cache modulů Go z běžného sestavení projektu a závislosti frontendu nainstalované podle app/frontend/package-lock.json.
• Sestavená webová aplikace v commitu. Sestavení používá jen zdroje v commitu; neuložené úpravy se vynechají.

Sestav a spusť

1. Z checkoutu sestav archivy:

   python deploy/release/package.py --ref HEAD --version 1.0.0 --output /srv/holyarrs-archives/1.0.0 --web-node-modules app/frontend/node_modules --module-cache /home/you/go/pkg/mod

   Použij novou výstupní složku mimo checkout. Měl bys vidět jeden archiv pro každý cíl a soubor SHA256SUMS.

2. Zkontroluj archiv podle SHA256SUMS.

3. Rozbal ho do nové složky. Drž program a konfiguraci v samostatných složkách.

4. Spusť ho s vlastní cestou ke konfiguraci:

   ./holyarrs -config /srv/holyarrs/config -addr :6262

   Ve Windows PowerShellu:

   .\holyarrs.exe -config 'C:\HolyArrs\config' -addr ':6262'

5. Otevři http://your-server:6262. Měl bys vidět průvodce prvním spuštěním. Účet vlastníka vytvoř hned; první návštěvník se stane vlastníkem.

Možnosti

Pod jakým uživatelem běží

Spouštěj HolyArrs pod vlastním účtem, který má právo zápisu jen do konfigurace a tvých médií.

• Jako root mimo kontejner, bez PUID a PGID, se zastaví s hláškou „started as root outside a container“.
• S nastaveným PUID a PGID předá konfigurační složku tomuto uživateli a přepne se na něj.
• Ve Windows chraň konfigurační složku oprávněním NTFS pro tento účet.

Restarty a limity

Archiv žádnou službu neinstaluje. Automatický restart a pevné limity paměti nastav ve svém správci služeb (systemd, NSSM, Plánovač úloh). Při restartu z aplikace i při obnově zálohy se program ukončí a čeká, že ho někdo znovu spustí.

Aktualizace a návrat zpět

1. Zkontroluj nový archiv dřív, než zastavíš aplikaci.
2. Zastav HolyArrs a zkopíruj celou konfigurační složku, včetně hlavního klíče. Nebo vytvoř zálohu v aplikaci a klíč si uschovej zvlášť.
3. Rozbal nový program do jiné složky. Starý program i starou kopii konfigurace si nech.
4. Spusť nový program nad svou konfigurací. Měl by ses umět přihlásit a /health by měl ukazovat running.

Nebezpečí

Nikdy nenasměruj starší program na databáze, které změnil novější. Pro návrat nejdřív ulož novější konfiguraci a pak spusť starý program nad jeho odpovídající starou kopií konfigurace.

Viz Zálohy.

Když to nefunguje

Příznak	Příčina	Řešení
„started as root outside a container“	Spuštěno jako root	Spusť ho pod vlastním uživatelem, nebo nastav PUID a PGID.
Aplikace se po obnově ukončí	Obnova připraví data a skončí s kódem 75	Spusť ji znovu, aby se data nasadila. Nastav svůj správce služeb, aby ji restartoval.
Volání HTTPS na Linuxu selhávají	Chybí systémové certifikáty CA	Nainstaluj je.
Sestavení hlásí, že výstup existuje	Existující výstupní složky se odmítají	Vyber novou složku.

Pro pokročilé

Volby sestavení

Volba	Co dělá	Výchozí
--targets	Podmnožina k sestavení, oddělená čárkami	linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource	Každý kontejner s buildery dostane 1 CPU, 2 GiB a 256 procesů; Go sestavuje jeden balíček po druhém. Balení pořád běží na hostiteli, mimo tyto limity.	vypnuto

Sestavení běží v připnutém image Go buildera projektu s vypnutou sítí, takže nic nestahuje. Cache modulů je připojená jen pro čtení. Pokud selže jakýkoli cíl, nezůstane žádná výstupní složka. Commit se přidá k číslu verze a vestaví se do programu; hlásí ho aplikace i její zálohy.

Co archiv obsahuje

Program, licenci, oznámení třetích stran, návody, manifest zdrojů a identitu balíčku. Samostatný archiv se zdroji obsahuje zdrojový kód projektu a závislosti Go; měj ho vedle binárních souborů.

SHA256SUMS dokazuje, že soubory sedí. Není to podpis. Stejný commit, verze a vstupy dají stejné archivy, takže je můžeš sestavit znovu a ověřit.

Poznámky k běhu

Téma	Podrobnost
Cesta ke konfiguraci	Výchozí /config. Vždy zadej -config, na místním disku.
Cíl paměti	384 MiB bez GOMEMLIMIT. Nastav ho na zhruba 80 procent paměti, kterou přidělíš. Je to cíl, ne pevný limit.
Režim s nízkou pamětí	Na Linuxu se zapne sám asi při 2.5 GiB nebo méně; cíl klesne na čtvrtinu paměti, mezi 192 a 384 MiB. Rozhodne HOLYARRS_LOW_MEMORY=1 nebo 0.
Node	Ke spuštění není potřeba.
Hardlinky	Drž stahování a složky knihovny na jednom souborovém systému.

Související

• Instalace
• Části a nouzový režim
• Aktualizace