Prenosná verzia

Nastavenie

Spusti HolyArrs ako obyčajný program na Linuxe alebo Windowse, bez Dockeru. Docker zostáva hlavným spôsobom spustenia.

Skôr než začneš

Python 3, Git a Docker na počítači, kde zostavuješ.
Naplnená cache modulov Go z bežného zostavenia projektu a závislosti frontendu nainštalované z app/frontend/package-lock.json.
Zostavená webová aplikácia musí byť commitnutá. Zostavenie používa iba commitnutý zdroj; necommitnuté úpravy sa vynechajú.

Zostav a spusti

Z kópie repozitára zostav archívy:

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ži nový výstupný priečinok mimo kópie repozitára. Mal by si vidieť jeden archív pre každý cieľ a súbor SHA256SUMS.

Skontroluj archív podľa SHA256SUMS.
Rozbaľ ho do nového priečinka. Program a konfiguráciu drž v oddelených priečinkoch.

Spusti ho s vlastnou cestou ku konfigurácii:

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

V PowerShelli na Windowse:

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

Otvor http://your-server:6262. Mal by si vidieť sprievodcu prvého spustenia. Účet vlastníka vytvor hneď; prvý návštevník sa stane vlastníkom.

Možnosti

Ktorý používateľ ho spúšťa

Spúšťaj HolyArrs pod vlastným účtom, s prístupom na zápis iba do konfigurácie a tvojich médií.

Ako root mimo kontajnera, bez PUID a PGID, sa zastaví s hláškou „started as root outside a container“.
S nastaveným PUID a PGID odovzdá konfiguračný priečinok tomuto používateľovi a prepne sa naň.
Vo Windowse chráň konfiguračný priečinok oprávnením NTFS pre tento účet.

Reštarty a limity

Archív neinštaluje žiadnu službu. Automatický reštart a pevné limity pamäte nastav vo vlastnom správcovi služieb (systemd, NSSM, Task Scheduler). Reštart z aplikácie aj obnova zálohy ukončia program a očakávajú, že sa spustí znova.

Aktualizuj a vráť sa späť

Skontroluj nový archív skôr, než aplikáciu zastavíš.
Zastav HolyArrs a skopíruj celý konfiguračný priečinok, vrátane hlavného kľúča. Alebo vytvor zálohu v aplikácii a kľúč si ulož osobitne.
Rozbaľ nový program do iného priečinka. Starý program a starú kópiu konfigurácie si ponechaj.
Spusti nový program na svojej konfigurácii. Mal by si sa vedieť prihlásiť a /health by mal ukazovať running.

Pozri Zálohy.

Ak to nefunguje

Príznak	Príčina	Riešenie
„started as root outside a container“	Spustené ako root	Spusti ho pod vlastným používateľom alebo nastav `PUID` a `PGID`.
Aplikácia po obnove skončí	Obnova pripraví dáta a skončí s kódom 75	Spusti ju znova, aby sa použili. Nastav svojho správcu služieb, aby ju reštartoval.
Volania HTTPS na Linuxe zlyhávajú	Chýbajú systémové certifikáty CA	Nainštaluj ich.
Zostavenie hlási, že výstup existuje	Existujúce výstupné priečinky sa zamietajú	Vyber nový priečinok.

Pre expertov

Možnosti zostavenia

Možnosť	Čo robí	Predvolene
`--targets`	Podmnožina na zostavenie, oddelená čiarkami	`linux-amd64,linux-arm64,linux-armv7,windows-amd64`
`--low-resource`	Každý kontajner zostavovača dostane 1 CPU, 2 GiB a 256 procesov; Go zostavuje po jednom balíku. Balenie stále beží na hostiteľovi, mimo týchto limitov.	vypnuté

Zostavenie beží v pripnutom image zostavovača Go projektu s vypnutou sieťou, takže nič nesťahuje. Cache modulov je pripojená iba na čítanie. Ak zlyhá ktorýkoľvek cieľ, nezostane žiadny výstupný priečinok. Commit sa pridá k číslu verzie a zabuduje do programu; hlási ho aplikácia aj jej zálohy.

Čo obsahuje archív

Program, licenciu, oznámenia tretích strán, príručky, manifest zdroja a identitu balíka. Samostatný archív zdroja obsahuje zdrojový kód projektu a závislosti Go; drž ho vedľa binárnych súborov.

SHA256SUMS dokazuje, že súbory sedia. Nie je to podpis. Rovnaký commit, verzia a vstupy dajú rovnaké archívy, takže môžeš zostaviť znova a overiť.

Poznámky k behu

Téma	Detail
Cesta ku konfigurácii	Predvolene `/config`. Vždy zadaj `-config`, na lokálnom disku.
Cieľ pamäte	384 MiB bez `GOMEMLIMIT`. Nastav ho na približne 80 percent pamäte, ktorú dáš. Cieľ, nie pevný limit.
Režim s nízkou pamäťou	Na Linuxe sa zapne sám pri približne 2.5 GiB alebo menej; cieľ klesne na štvrtinu pamäte, medzi 192 a 384 MiB. Rozhodne `HOLYARRS_LOW_MEMORY=1` alebo `0`.
Node	Na spustenie netreba.
Hardlinky	Drž sťahovania a priečinky knižnice na jednom súborovom systéme.

Súvisiace stránky

HolyArrs je zadarmo. Ak ti ušetril čas, daj mu hviezdičku na GitHube, podpor ho alebo kúp mi kávu.