Portable útgáfa

Keyrðu HolyArrs sem venjulegt forrit á Linux eða Windows, án Docker. Docker er áfram aðalleiðin til að keyra það.

Caution

Enginn gefur út portable skjalasöfn enn og þau eru ekki undirrituð. Þú byggir þau sjálf úr frumkóðanum.

Áður en þú byrjar

• Python 3, Git og Docker á byggingartölvunni.
• Fylltan Go module cache úr venjulegri byggingu verkefnisins, og frontend-pakkar uppsett úr app/frontend/package-lock.json.
• Vefforritið byggt og commit-að. Byggingin notar aðeins commit-aðan frumkóða; óvistaðar breytingar eru skildar eftir.

Byggðu og keyrðu

1. Byggðu skjalasöfnin úr checkout-inu:

   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

   Notaðu nýja úttaksmöppu utan checkout-sins. Þú ættir að sjá eitt skjalasafn fyrir hvert markmið og skrána SHA256SUMS.

2. Berðu skjalasafnið saman við SHA256SUMS.

3. Taktu það út í nýja möppu. Hafðu forritið og stillingarnar í aðskildum möppum.

4. Ræstu það með þinni eigin stillingaslóð:

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

   Í Windows PowerShell:

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

5. Opnaðu http://your-server:6262. Þú ættir að sjá töframann fyrstu ræsingar. Búðu til eigandareikninginn strax; fyrsti gesturinn verður eigandi.

Valkostir

Hvaða notandi keyrir það

Keyrðu HolyArrs undir sínum eigin reikningi, með skrifaðgang aðeins að stillingunum og margmiðlunarefninu þínu.

• Sem root utan container, án PUID og PGID, stöðvast það með „started as root outside a container“.
• Með PUID og PGID stillt afhendir það stillingamöppuna þeim notanda og skiptir yfir í hann.
• Á Windows skaltu vernda stillingamöppuna með NTFS-heimild fyrir þann reikning.

Endurræsingar og takmörk

Skjalasafnið setur ekki upp neina þjónustu. Settu upp sjálfvirka endurræsingu og föst minnistakmörk í þinni eigin þjónustustjórnun (systemd, NSSM, Task Scheduler). Endurræsing úr forritinu og endurheimt backup enda bæði keyrsluna og búast við að það sé ræst aftur.

Uppfærðu og farðu aftur

1. Athugaðu nýja skjalasafnið áður en þú stöðvar forritið.
2. Stöðvaðu HolyArrs og afritaðu alla stillingamöppuna, aðallykilinn með. Eða taktu backup í forritinu og geymdu lykilinn þess sér.
3. Taktu nýja forritið út í aðra möppu. Haltu gamla forritinu og gamla afritinu af stillingunum.
4. Ræstu nýja forritið á stillingunum þínum. Þú ættir að geta skráð þig inn og /health ætti að sýna running.

Danger

Beindu aldrei eldra forriti að gagnagrunnum sem nýrra forrit hefur breytt. Til að fara aftur skaltu vista nýrri stillingarnar fyrst og ræsa svo gamla forritið á samsvarandi gömlu afriti af stillingunum.

Sjá Backup.

Ef það virkar ekki

Einkenni	Orsök	Lausn
„started as root outside a container“	Ræst sem root	Keyrðu það sem sinn eigin notanda, eða stilltu PUID og PGID.
Forritið hættir eftir endurheimt	Endurheimt undirbýr gögnin og hættir með kóðanum 75	Ræstu það aftur til að virkja hana. Láttu þjónustustjórnunina endurræsa það.
HTTPS-köll mistakast á Linux	Engin CA-skírteini kerfisins	Settu þau upp.
Byggingin segir að úttakið sé til	Núverandi úttaksmöppum er hafnað	Veldu nýja möppu.

Fyrir sérfræðinga

Byggingarvalkostir

Valkostur	Hvað hann gerir	Sjálfgefið
--targets	Kommuaðskilin hlutmengi til að byggja	linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource	Hver byggingar-container fær 1 CPU, 2 GiB og 256 ferli; Go byggir einn pakka í einu. Pökkun keyrir enn á hýslinum, utan þessara takmarka.	slökkt

Byggingin keyrir í föstu Go-byggingar-image verkefnisins án nettengingar, svo hún sækir ekkert. Module cache er tengdur skrifvarinn. Ef eitthvert markmið mistekst er engin úttaksmappa skilin eftir. Commit-ið er bætt við útgáfunúmerið og byggt inn í forritið; forritið og backup þess tilgreina það.

Hvað skjalasafn geymir

Forritið, leyfið, tilkynningar um hugbúnað þriðju aðila, leiðbeiningar, frumkóðaskrá og auðkenni pakkans. Sérstakt frumkóðaskjalasafn geymir frumkóða verkefnisins og Go-pakkar; hafðu það við hlið binary-skránna.

SHA256SUMS sannar að skrárnar passa. Það er ekki undirskrift. Sama commit, útgáfa og inntak gefa sömu skjalasöfn, svo þú getur byggt aftur til að sannreyna.

Athugasemdir um keyrslu

Efni	Nánar
Stillingaslóð	Sjálfgefið /config. Gefðu alltaf -config, á staðbundnum diski.
Minnismarkmið	384 MiB án GOMEMLIMIT. Stilltu það á um 80 prósent af minninu sem þú gefur. Markmið, ekki hörð takmörk.
Lágminnishamur	Á Linux kveikist hann sjálfkrafa við um 2,5 GiB eða minna; markmiðið fellur í fjórðung af minninu, milli 192 og 384 MiB. HOLYARRS_LOW_MEMORY=1 eða 0 ræður.
Node	Ekki þörf til að keyra.
Hardlinks	Hafðu niðurhal og safnmöppur á einu skráakerfi.

Tengt efni

• Uppsetning
• Hlutar og öruggur hamur
• Uppfærslur