Portable верзија

Подешавање

Покрени HolyArrs као обичан програм на Linux-у или Windows-у, без Docker-а. Docker остаје главни начин да га покренеш.

Пре него што почнеш

Python 3, Git и Docker на рачунару на ком градиш.
Попуњен Go module cache из нормалне изградње пројекта и frontend зависности инсталиране из app/frontend/package-lock.json.
Изграђена веб апликација је комитована. Изградња користи само комитовани извор; некомитоване измене су изостављене.

Изгради и покрени

Из checkout-а изгради архиве:
Terminal window
```
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
```
Користи нови излазни фолдер ван checkout-а. Требало би да видиш једну архиву по циљу и фајл SHA256SUMS.
Провери архиву према SHA256SUMS.
Распакуј је у нови фолдер. Држи програм и конфигурацију у одвојеним фолдерима.
Покрени га са својом путањом конфигурације:
Terminal window
```
./holyarrs -config /srv/holyarrs/config -addr :6262
```
У Windows PowerShell-у:
Terminal window
```
.\holyarrs.exe -config 'C:\HolyArrs\config' -addr ':6262'
```
Отвори http://your-server:6262. Требало би да видиш чаробњак првог покретања. Одмах направи налог власника; први посетилац постаје власник.

Опције

Који корисник га покреће

Покрени HolyArrs под посебним налогом, са правом уписа само у конфигурацију и твоје медије.

Као root ван контејнера, без PUID и PGID, зауставља се са „started as root outside a container“.
Са постављеним PUID и PGID, даје конфигурациони фолдер том кориснику и прелази на њега.
На Windows-у заштити конфигурациони фолдер NTFS дозволом за тај налог.

Рестарти и ограничења

Архива не инсталира сервис. Подеси аутоматско поновно покретање и чврста ограничења меморије у свом менаџеру сервиса (systemd, NSSM, Task Scheduler). Рестарт из апликације и враћање бекапа оба излазе и очекују да се опет покрену.

Ажурирај и врати назад

Провери нову архиву пре него што зауставиш апликацију.
Заустави HolyArrs и копирај цео конфигурациони фолдер, укључујући главни кључ. Или направи бекап у апликацији и његов кључ чувај одвојено.
Распакуј нови програм у други фолдер. Задржи стари програм и стару копију конфигурације.
Покрени нови програм на својој конфигурацији. Требало би да можеш да се пријавиш, а /health треба да показује running.

Погледај Бекапи.

Ако не ради

Симптом	Узрок	Решење
„started as root outside a container“	Покренут као root	Покрени га као посебног корисника, или постави `PUID` и `PGID`.
Апликација излази после враћања	Враћање припреми податке и изађе са кодом 75	Покрени је поново да се примени. Подеси свој менаџер сервиса да је поново покрене.
HTTPS позиви не успевају на Linux-у	Нема системских CA сертификата	Инсталирај их.
Изградња каже да излаз постоји	Постојећи излазни фолдери се одбијају	Изабери нови фолдер.

За напредне

Опције изградње

Опција	Шта ради	Подразумевано
`--targets`	Подскуп раздвојен зарезима који се гради	`linux-amd64,linux-arm64,linux-armv7,windows-amd64`
`--low-resource`	Сваки контејнер градитеља добија 1 CPU, 2 GiB и 256 процеса; Go гради један пакет одједном. Паковање и даље иде на хосту, ван тих ограничења.	искључено

Изградња иде у фиксираном Go builder слици контејнера пројекта са искљученом мрежом, па ништа не преузима. Module cache је монтиран само за читање. Ако било који циљ не успе, ниједан излазни фолдер не остаје. Комит се додаје броју верзије и уграђује у програм; апликација и њени бекапи га пријављују.

Шта садржи архива

Програм, лиценцу, обавештења трећих страна, водиче, манифест извора и идентитет пакета. Посебна архива извора садржи изворни код пројекта и Go зависности; држи је поред бинарних фајлова.

SHA256SUMS доказује да се фајлови поклапају. Није потпис. Исти комит, верзија и улазни подаци дају исте архиве, па можеш поново да изградиш ради провере.

Напомене о раду

Тема	Детаљ
Путања конфигурације	Подразумевано `/config`. Увек проследи `-config`, на локалном диску.
Циљ меморије	384 MiB без `GOMEMLIMIT`. Постави га на око 80 процената меморије коју даш. Циљ, а не чврсто ограничење.
Режим мале потрошње меморије	На Linux-у се сам укључује на око 2,5 GiB или мање; циљ пада на четвртину меморије, између 192 и 384 MiB. `HOLYARRS_LOW_MEMORY=1` или `0` одлучује.
Node	Није потребан за рад.
Хардлинкови	Држи преузимања и фолдере библиотеке на једном фајл систему.

Повезане странице

HolyArrs је бесплатан. Ако ти је уштедео време, остави звездицу на GitHub-у, постани спонзор или купи ми кафу.