Φορητή έκδοση

Τρέξε το HolyArrs ως απλό πρόγραμμα σε Linux ή Windows, χωρίς Docker. Το Docker μένει ο βασικός τρόπος για να το τρέξεις.

Προσοχή

Κανείς δεν δημοσιεύει ακόμα φορητά συμπιεσμένα αρχεία και δεν είναι υπογεγραμμένα. Τα φτιάχνεις εσύ από τον πηγαίο κώδικα.

Πριν ξεκινήσεις

• Python 3, Git και Docker στον υπολογιστή που κάνει το build.
• Μια γεμάτη cache των Go modules από ένα κανονικό build του έργου, και εγκατεστημένες οι εξαρτήσεις του frontend από το app/frontend/package-lock.json.
• Η έτοιμη διαδικτυακή εφαρμογή να είναι committed. Το build χρησιμοποιεί μόνο committed κώδικα· οι αλλαγές χωρίς commit μένουν έξω.

Φτιάξε και τρέξε

1. Από το 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

   Χρησιμοποίησε νέο φάκελο εξόδου έξω από το checkout. Θα πρέπει να δεις ένα αρχείο ανά στόχο και ένα αρχείο SHA256SUMS.

2. Έλεγξε το συμπιεσμένο αρχείο με το SHA256SUMS.

3. Αποσυμπίεσέ το σε νέο φάκελο. Κράτα το πρόγραμμα και τις ρυθμίσεις σε ξεχωριστούς φακέλους.

4. Ξεκίνα το με τη δική σου διαδρομή ρυθμίσεων:

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

   Στο Windows PowerShell:

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

5. Άνοιξε το http://your-server:6262. Θα πρέπει να δεις τον οδηγό της πρώτης εκκίνησης. Φτιάξε αμέσως τον λογαριασμό ιδιοκτήτη· ο πρώτος επισκέπτης γίνεται ο ιδιοκτήτης.

Επιλογές

Ποιος χρήστης το τρέχει

Τρέξε το HolyArrs με δικό του λογαριασμό, με δικαίωμα εγγραφής μόνο στις ρυθμίσεις και στα πολυμέσα σου.

• Ως root έξω από container, χωρίς PUID και PGID, σταματά με το μήνυμα “started as root outside a container”.
• Με ορισμένα PUID και PGID, δίνει τον φάκελο ρυθμίσεων σε αυτόν τον χρήστη και αλλάζει σε αυτόν.
• Στα Windows, προστάτεψε τον φάκελο ρυθμίσεων με δικαίωμα NTFS για αυτόν τον λογαριασμό.

Επανεκκινήσεις και όρια

Το αρχείο δεν εγκαθιστά υπηρεσία. Ρύθμισε την αυτόματη επανεκκίνηση και τα αυστηρά όρια μνήμης στον δικό σου διαχειριστή υπηρεσιών (systemd, NSSM, Task Scheduler). Η επανεκκίνηση από την εφαρμογή και η επαναφορά αντιγράφου κάνουν και οι δύο έξοδο και περιμένουν να ξεκινήσει το πρόγραμμα ξανά.

Ενημέρωση και επιστροφή στην προηγούμενη έκδοση

1. Έλεγξε το νέο συμπιεσμένο αρχείο πριν σταματήσεις την εφαρμογή.
2. Σταμάτα το HolyArrs και αντίγραψε ολόκληρο τον φάκελο ρυθμίσεων, με το κύριο κλειδί. Ή κάνε αντίγραφο ασφαλείας μέσα από την εφαρμογή και κράτα το κλειδί του ξεχωριστά.
3. Αποσυμπίεσε το νέο πρόγραμμα σε διαφορετικό φάκελο. Κράτα το παλιό πρόγραμμα και το παλιό αντίγραφο των ρυθμίσεων.
4. Ξεκίνα το νέο πρόγραμμα πάνω στις ρυθμίσεις σου. Θα πρέπει να μπορείς να συνδεθείς, και το /health θα πρέπει να δείχνει running.

Κίνδυνος

Μην δείχνεις ποτέ παλαιότερο πρόγραμμα σε βάσεις δεδομένων που έχει αλλάξει νεότερο. Για να γυρίσεις πίσω, αποθήκευσε πρώτα τις νεότερες ρυθμίσεις και μετά ξεκίνα το παλιό πρόγραμμα πάνω στο αντίστοιχο παλιό αντίγραφο ρυθμίσεων.

Δες Αντίγραφα ασφαλείας.

Αν δεν δουλεύει

Σύμπτωμα	Αιτία	Λύση
“started as root outside a container”	Ξεκίνησε ως root	Τρέξε το με δικό του χρήστη, ή όρισε PUID και PGID.
Η εφαρμογή κάνει έξοδο μετά από επαναφορά	Η επαναφορά ετοιμάζει τα δεδομένα και κάνει έξοδο με κωδικό 75	Ξεκίνα την ξανά για να εφαρμοστεί. Όρισε τον διαχειριστή υπηρεσιών να την ξαναξεκινά.
Οι κλήσεις HTTPS αποτυγχάνουν σε Linux	Λείπουν τα πιστοποιητικά CA του συστήματος	Εγκατάστησέ τα.
Το build λέει ότι η έξοδος υπάρχει	Οι υπάρχοντες φάκελοι εξόδου απορρίπτονται	Διάλεξε νέο φάκελο.

Για έμπειρους

Επιλογές του build

Επιλογή	Τι κάνει	Προεπιλογή
--targets	Υποσύνολο στόχων που χωρίζονται με κόμμα	linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource	Κάθε container του builder παίρνει 1 CPU, 2 GiB και 256 διεργασίες· το Go χτίζει ένα πακέτο τη φορά. Η συσκευασία τρέχει ακόμα στον host, έξω από αυτά τα όρια.	off

Το build τρέχει στην καρφωμένη image builder Go του έργου με απενεργοποιημένο δίκτυο, οπότε δεν κατεβάζει τίποτα. Η cache των modules συνδέεται μόνο για ανάγνωση. Αν αποτύχει οποιοσδήποτε στόχος, δεν μένει φάκελος εξόδου. Το commit προστίθεται στον αριθμό έκδοσης και ενσωματώνεται στο πρόγραμμα· η εφαρμογή και τα αντίγραφά της το αναφέρουν.

Τι έχει ένα συμπιεσμένο αρχείο

Το πρόγραμμα, την άδεια χρήσης, τις σημειώσεις τρίτων, οδηγούς, ένα manifest του πηγαίου κώδικα και την ταυτότητα του πακέτου. Ένα ξεχωριστό αρχείο πηγαίου κώδικα έχει τον κώδικα του έργου και τις εξαρτήσεις Go· κράτα το δίπλα στα εκτελέσιμα.

Το SHA256SUMS αποδεικνύει ότι τα αρχεία ταιριάζουν. Δεν είναι υπογραφή. Το ίδιο commit, η ίδια έκδοση και οι ίδιες είσοδοι δίνουν τα ίδια αρχεία, οπότε μπορείς να ξαναχτίσεις για έλεγχο.

Σημειώσεις λειτουργίας

Θέμα	Λεπτομέρεια
Διαδρομή ρυθμίσεων	Προεπιλογή /config. Δώσε πάντα το -config, σε τοπικό δίσκο.
Στόχος μνήμης	384 MiB χωρίς GOMEMLIMIT. Όρισέ το στο 80 τοις εκατό περίπου της μνήμης που δίνεις. Στόχος, όχι αυστηρό όριο.
Λειτουργία χαμηλής μνήμης	Σε Linux, ενεργοποιείται μόνη της στα 2.5 GiB ή λιγότερο περίπου· ο στόχος πέφτει στο ένα τέταρτο της μνήμης, ανάμεσα σε 192 και 384 MiB. Το HOLYARRS_LOW_MEMORY=1 ή 0 αποφασίζει.
Node	Δεν χρειάζεται για να τρέξει.
Hardlinks	Κράτα τις λήψεις και τους φακέλους της Βιβλιοθήκης σε ένα σύστημα αρχείων.

Σχετικά

• Εγκατάσταση
• Ενότητες και ασφαλής λειτουργία
• Ενημερώσεις