Portabel udgave

Kør HolyArrs som et almindeligt program på Linux eller Windows, uden Docker. Docker er stadig den primære måde at køre den på.

Bemærk

Ingen udgiver portable arkiver endnu, og de er ikke signerede. Du bygger dem selv fra kildekoden.

Før du begynder

• Python 3, Git og Docker på den computer, der bygger.
• Et udfyldt Go-modulcache fra et normalt build af projektet, og frontend-afhængigheder installeret fra app/frontend/package-lock.json.
• Den byggede webapp skal være committet. Buildet bruger kun committet kildekode; ændringer, der ikke er committet, bliver udeladt.

Byg og kør

1. Byg arkiverne fra dit checkout:

   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

   Brug en ny outputmappe uden for dit checkout. Du bør kunne se ét arkiv for hvert mål og en SHA256SUMS-fil.

2. Tjek arkivet mod SHA256SUMS.

3. Pak det ud i en ny mappe. Hold programmet og konfigurationen i hver sin mappe.

4. Start det med din egen konfigurationssti:

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

   I Windows PowerShell:

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

5. Åbn http://your-server:6262. Du bør kunne se guiden ved første start. Lav ejerkontoen med det samme; den første besøgende bliver ejer.

Valg

Hvilken bruger skal køre det

Kør HolyArrs under sin egen konto med skriveadgang kun til konfigurationen og dine medier.

• Som root uden for en container, uden PUID og PGID, stopper den med “started as root outside a container”.
• Med PUID og PGID sat giver den konfigurationsmappen til den bruger og skifter til den.
• På Windows skal du beskytte konfigurationsmappen med en NTFS-rettighed til den konto.

Genstarter og grænser

Arkivet installerer ingen tjeneste. Sæt automatisk genstart og faste hukommelsesgrænser op i din egen tjenestestyring (systemd, NSSM, Task Scheduler). Genstart fra appen og en gendannelse af backup afslutter begge programmet og forventer, at det bliver startet igen.

Opdater og gå tilbage

1. Tjek det nye arkiv, før du stopper appen.
2. Stop HolyArrs og kopier hele konfigurationsmappen, hovednøglen med. Eller tag en backup i appen og gem dens nøgle for sig.
3. Pak det nye program ud i en anden mappe. Behold det gamle program og den gamle kopi af konfigurationen.
4. Start det nye program på din konfiguration. Du bør kunne logge ind, og /health bør vise running.

Advarsel

Peg aldrig et ældre program på databaser, som et nyere har ændret. For at gå tilbage skal du først gemme den nyere konfiguration og derefter starte det gamle program på den tilhørende gamle kopi af konfigurationen.

Se Backups.

Hvis det ikke virker

Symptom	Årsag	Løsning
“started as root outside a container”	Startet som root	Kør det som sin egen bruger, eller sæt PUID og PGID.
Appen afslutter efter en gendannelse	En gendannelse gør dataene klar og afslutter med kode 75	Start den igen for at anvende dem. Sæt din tjenestestyring til at genstarte den.
HTTPS-kald fejler på Linux	Ingen CA-certifikater i systemet	Installer dem.
Buildet siger, at outputtet findes	Eksisterende outputmapper bliver afvist	Vælg en ny mappe.

For erfarne

Byggeindstillinger

Indstilling	Hvad den gør	Standard
--targets	Kommasepareret delmængde, der skal bygges	linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource	Hver byggecontainer får 1 CPU, 2 GiB og 256 processer; Go bygger én pakke ad gangen. Pakningen kører stadig på hosten, uden for disse grænser.	fra

Buildet kører i projektets fastlåste Go-builder-image uden netværk, så den downloader ingenting. Modulcachen er monteret skrivebeskyttet. Hvis et mål fejler, bliver der ikke efterladt nogen outputmappe. Committen bliver føjet til versionsnummeret og bygget ind i programmet; appen og dens backups oplyser den.

Hvad et arkiv indeholder

Programmet, licensen, tredjepartsmeddelelser, vejledninger, et kildemanifest og pakkens identitet. Et separat kildearkiv indeholder projektets kildekode og Go-afhængigheder; gem det ved siden af binærfilerne.

SHA256SUMS beviser, at filerne passer. Det er ikke en signatur. Den samme commit, version og de samme input giver de samme arkiver, så du kan bygge igen for at kontrollere.

Noter om kørsel

Emne	Detalje
Konfigurationssti	Standard /config. Angiv altid -config, på en lokal disk.
Hukommelsesmål	384 MiB uden GOMEMLIMIT. Sæt den til omkring 80 procent af den hukommelse, du giver. Et mål, ikke en fast grænse.
Tilstand til lav hukommelse	På Linux slår den sig selv til ved cirka 2,5 GiB eller mindre; målet falder til en fjerdedel af hukommelsen, mellem 192 og 384 MiB. HOLYARRS_LOW_MEMORY=1 eller 0 bestemmer.
Node	Behøves ikke for at køre.
Hardlinks	Hold downloads og biblioteksmapper på ét filsystem.

Se også

• Installation
• Dele og fejlsikret tilstand
• Opdateringer