Portatīvā versija

Palaid HolyArrs kā parastu programmu Linux vai Windows sistēmā, bez Docker. Docker joprojām ir galvenais veids, kā to palaist.

Uzmanību

Portatīvos arhīvus vēl neviens nepublicē, un tie nav parakstīti. Tu tos izveido pats no pirmkoda.

Pirms sāc

• Python 3, Git un Docker būvēšanas datorā.
• Aizpildīts Go moduļu kešs no parastas projekta būvēšanas un frontend atkarības, uzstādītas no app/frontend/package-lock.json.
• Uzbūvētā tīmekļa lietotne ir iekomitēta. Būvēšana izmanto tikai iekomitēto pirmkodu; neiekomitētās izmaiņas tiek izlaistas.

Būvē un palaid

1. No checkout izveido arhīvus:

   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

   Izmanto jaunu izvades mapi ārpus checkout. Tev vajadzētu redzēt vienu arhīvu katram mērķim un failu SHA256SUMS.

2. Pārbaudi arhīvu pret SHA256SUMS.

3. Izvelc to jaunā mapē. Programmu un konfigurāciju glabā atsevišķās mapēs.

4. Palaid to ar savu konfigurācijas ceļu:

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

   Windows PowerShell:

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

5. Atver http://your-server:6262. Tev vajadzētu redzēt pirmās palaišanas vedni. Izveido īpašnieka kontu uzreiz; pirmais apmeklētājs kļūst par īpašnieku.

Izvēles

Kurš lietotājs to palaiž

Palaid HolyArrs zem sava konta, ar rakstīšanas atļauju tikai konfigurācijai un tavai multividei.

• Kā root ārpus konteinera, bez PUID un PGID, tas apstājas ar „started as root outside a container”.
• Ja PUID un PGID ir iestatīti, tas nodod konfigurācijas mapi šim lietotājam un pārslēdzas uz to.
• Windows vidē aizsargā konfigurācijas mapi ar NTFS atļauju šim kontam.

Restartēšana un limiti

Arhīvs neuzstāda nevienu pakalpojumu. Automātisko restartēšanu un stingros atmiņas limitus iestati savā pakalpojumu pārvaldniekā (systemd, NSSM, Task Scheduler). Restartēšana no lietotnes un dublējuma atjaunošana abas izbeidz darbu un sagaida, ka tās tiks palaistas atkal.

Atjaunini un atgriezies

1. Pārbaudi jauno arhīvu, pirms aptur lietotni.
2. Aptur HolyArrs un nokopē visu konfigurācijas mapi, ieskaitot galveno atslēgu. Vai izveido dublējumu lietotnē un glabā tā atslēgu atsevišķi.
3. Izvelc jauno programmu citā mapē. Saglabā veco programmu un vecās konfigurācijas kopiju.
4. Palaid jauno programmu ar savu konfigurāciju. Tev vajadzētu varēt pieteikties, un /health vajadzētu rādīt running.

Bīstamība

Nekad nepalaid vecāku programmu ar datubāzēm, ko mainījusi jaunāka. Lai atgrieztos, vispirms saglabā jaunāko konfigurāciju, tad palaid veco programmu ar tai atbilstošo veco konfigurācijas kopiju.

Skaties Dublējumi.

Ja tas nedarbojas

Simptoms	Cēlonis	Risinājums
„started as root outside a container”	Palaists kā root	Palaid to kā savu lietotāju vai iestati PUID un PGID.
Lietotne izbeidz darbu pēc atjaunošanas	Atjaunošana sagatavo datus un izbeidz darbu ar kodu 75	Palaid to vēlreiz, lai tos pielietotu. Iestati savu pakalpojumu pārvaldnieku, lai tas to restartē.
HTTPS izsaukumi Linux neizdodas	Nav sistēmas CA sertifikātu	Uzstādi tos.
Būvēšana paziņo, ka izvades mape jau pastāv	Esošās izvades mapes tiek noraidītas	Izvēlies jaunu mapi.

Pieredzējušiem

Būvēšanas opcijas

Opcija	Ko dara	Noklusējums
--targets	Ar komatiem atdalīta apakškopa, ko būvēt	linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource	Katrs būvētāja konteiners saņem 1 CPU, 2 GiB un 256 procesus; Go būvē vienu pakotni vienlaikus. Iepakošana joprojām darbojas resursdatorā, ārpus šiem limitiem.	izslēgts

Būvēšana darbojas projekta piespraustajā Go būvētāja attēlā ar izslēgtu tīklu, tāpēc tā neko nelejupielādē. Moduļu kešs tiek piemontēts tikai lasāmā režīmā. Ja kāds mērķis neizdodas, izvades mape netiek atstāta. Komits tiek pievienots versijas numuram un iebūvēts programmā; lietotne un tās dublējumi to ziņo.

Ko satur arhīvs

Programmu, licenci, trešo pušu paziņojumus, rokasgrāmatas, pirmkoda manifestu un pakotnes identitāti. Atsevišķs pirmkoda arhīvs satur projekta pirmkodu un Go atkarības; glabā to blakus bināriem failiem.

SHA256SUMS pierāda, ka faili atbilst. Tas nav paraksts. Tas pats komits, versija un ievaddati dod tos pašus arhīvus, tāpēc vari pārbūvēt, lai pārbaudītu.

Darbības piezīmes

Tēma	Detaļas
Konfigurācijas ceļš	Noklusējums /config. Vienmēr norādi -config, vietējā diskā.
Atmiņas mērķis	384 MiB bez GOMEMLIMIT. Iestati to uz apmēram 80 procentiem no atmiņas, ko dod. Mērķis, nevis stingrs limits.
Zemas atmiņas režīms	Linux vidē ieslēdzas pats pie apmēram 2.5 GiB vai mazāk; mērķis samazinās līdz ceturtdaļai atmiņas, starp 192 un 384 MiB. To nosaka HOLYARRS_LOW_MEMORY=1 vai 0.
Node	Darbināšanai nav vajadzīgs.
Hardlink	Glabā lejupielādes un bibliotēkas mapes vienā failu sistēmā.

Saistītais

• Uzstādīšana
• Daļas un drošais režīms
• Atjauninājumi