Hordozható build

Futtasd a HolyArrsot egyszerű programként Linuxon vagy Windowson, Docker nélkül. A Docker marad a fő futtatási mód.

Figyelem

Hordozható archívumokat még senki nem tesz közzé, és nincsenek aláírva. Magad építed őket a forrásból.

Mielőtt elkezdenéd

• Python 3, Git és Docker az építő gépen.
• Egy feltöltött Go modul-gyorsítótár egy normál projektépítésből, és a frontend-függőségek telepítve az app/frontend/package-lock.json alapján.
• A lebuildelt webapp commitolva. Az építés csak a commitolt forrást használja; a nem commitolt módosítások kimaradnak.

Építés és futtatás

1. A checkoutból építsd az archívumokat:

   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

   Használj új kimeneti mappát a checkouton kívül. Célonként egy archívumot és egy SHA256SUMS fájlt kell látnod.

2. Ellenőrizd az archívumot a SHA256SUMS fájllal.

3. Csomagold ki egy új mappába. A programot és a konfigurációt tartsd külön mappákban.

4. Indítsd el a saját konfigurációs útvonaloddal:

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

   Windows PowerShellben:

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

5. Nyisd meg a http://your-server:6262 címet. Az első indítás varázslóját kell látnod. Azonnal hozd létre a tulajdonosi fiókot; az első látogató lesz a tulajdonos.

Lehetőségek

Melyik felhasználó futtatja

Futtasd a HolyArrsot saját fiók alatt, amelynek csak a konfigurációhoz és a médiádhoz van írási joga.

• Containeren kívül rootként, PUID és PGID nélkül leáll ezzel: „started as root outside a container”.
• Beállított PUID és PGID esetén átadja a konfigurációs mappát annak a felhasználónak, és átvált rá.
• Windowson védd a konfigurációs mappát NTFS jogosultsággal arra a fiókra.

Újraindítások és korlátok

Az archívum nem telepít szolgáltatást. Az automatikus újraindítást és a kemény memóriakorlátokat a saját szolgáltatáskezelődben állítsd be (systemd, NSSM, Task Scheduler). Az appból indított újraindítás és a backup-visszaállítás is kilép, és arra számít, hogy újra elindítják.

Frissítés és visszatérés a korábbira

1. Ellenőrizd az új archívumot, mielőtt leállítod az appot.
2. Állítsd le a HolyArrsot, és másold le a teljes konfigurációs mappát, a főkulccsal együtt. Vagy készíts appon belüli backupot, és a kulcsát tartsd külön.
3. Csomagold ki az új programot egy másik mappába. Tartsd meg a régi programot és a régi konfigurációs másolatot.
4. Indítsd el az új programot a konfigurációdon. Be kell tudnod jelentkezni, és a /health oldalnak running állapotot kell mutatnia.

Veszély

Soha ne irányíts régebbi programot olyan adatbázisokra, amelyeket egy újabb módosított. A visszatéréshez előbb mentsd el az újabb konfigurációt, aztán indítsd el a régi programot a hozzá tartozó régi konfigurációs másolaton.

Lásd: Backupok.

Ha nem működik

Tünet	Ok	Megoldás
„started as root outside a container”	Rootként indítottad	Futtasd saját felhasználóként, vagy állítsd be a PUID és PGID értékét.
Az app visszaállítás után kilép	A visszaállítás előkészíti az adatot, és a 75-ös kóddal kilép	Indítsd el újra, hogy érvénybe lépjen. Állítsd be a szolgáltatáskezelődet, hogy újraindítsa.
A HTTPS-hívások elbuknak Linuxon	Nincsenek rendszer CA-tanúsítványok	Telepítsd őket.
Az építés azt mondja, hogy a kimenet már létezik	A létező kimeneti mappákat elutasítja	Válassz új mappát.

Haladóknak

Építési beállítások

Beállítás	Mit csinál	Alapértelmezett
--targets	Vesszővel elválasztott részhalmaz az építéshez	linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource	Minden építő container 1 CPU-t, 2 GiB-ot és 256 folyamatot kap; a Go egyszerre egy csomagot épít. A csomagolás továbbra is a gazdagépen fut, ezeken a korlátokon kívül.	ki

Az építés a projekt rögzített Go builder image-ében fut kikapcsolt hálózattal, így semmit nem tölt le. A modul-gyorsítótár csak olvashatóan van csatolva. Ha bármelyik cél elbukik, nem marad kimeneti mappa. A commit hozzáadódik a verziószámhoz, és beépül a programba; az app és a backupjai jelentik.

Mi van egy archívumban

A program, a licenc, a harmadik felek közleményei, az útmutatók, egy forrás-manifest és a csomag azonosítója. Egy külön forrásarchívum tartalmazza a projekt forrását és a Go függőségeket; tartsd a binárisok mellett.

A SHA256SUMS azt igazolja, hogy a fájlok egyeznek. Nem aláírás. Ugyanaz a commit, verzió és bemenet ugyanazokat az archívumokat adja, így újraépítéssel ellenőrizheted.

Futásidejű megjegyzések

Téma	Részlet
Konfigurációs útvonal	Alapértelmezett /config. Mindig add meg a -config kapcsolót, helyi lemezen.
Memória-célérték	384 MiB GOMEMLIMIT nélkül. Állítsd a megadott memória nagyjából 80 százalékára. Célérték, nem kemény korlát.
Kevés memóriás mód	Linuxon magától bekapcsol nagyjából 2,5 GiB-nál vagy kevesebbnél; a célérték a memória negyedére csökken, 192 és 384 MiB között. A HOLYARRS_LOW_MEMORY=1 vagy 0 dönt.
Node	A futtatáshoz nem kell.
Hardlinkek	Tartsd a letöltéseket és a médiatár-mappákat egy fájlrendszeren.

Kapcsolódó oldalak

• Telepítés
• Részek és biztonságos mód
• Frissítések