Build portabel

Jalankan HolyArrs sebagai program biasa di Linux atau Windows, tanpa Docker. Docker tetap cara utama untuk menjalankannya.

Perhatian

Belum ada yang menerbitkan arsip portabel, dan arsipnya tidak ditandatangani. Kamu membuatnya sendiri dari source.

Sebelum mulai

• Python 3, Git, dan Docker di komputer untuk build.
• Cache modul Go yang terisi dari build proyek biasa, dan dependensi frontend yang terpasang dari app/frontend/package-lock.json.
• Aplikasi web hasil build sudah di-commit. Build hanya memakai source yang di-commit; perubahan yang belum di-commit tidak ikut.

Build dan jalankan

1. Dari checkout, buat arsipnya:

   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

   Pakai folder output baru di luar checkout. Kamu akan melihat satu arsip per target dan file SHA256SUMS.

2. Periksa arsip dengan SHA256SUMS.

3. Ekstrak ke folder baru. Pisahkan folder program dan folder konfigurasi.

4. Mulai dengan path konfigurasi kamu sendiri:

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

   Di Windows PowerShell:

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

5. Buka http://your-server:6262. Kamu akan melihat wizard pertama kali dijalankan. Buat akun pemilik segera; pengunjung pertama menjadi pemilik.

Pilihan

Pengguna mana yang menjalankannya

Jalankan HolyArrs dengan akunnya sendiri, dengan izin tulis hanya ke konfigurasi dan media kamu.

• Sebagai root di luar container, tanpa PUID dan PGID, HolyArrs berhenti dengan pesan “started as root outside a container”.
• Dengan PUID dan PGID disetel, folder konfigurasi diserahkan ke pengguna itu dan HolyArrs beralih ke dia.
• Di Windows, lindungi folder konfigurasi dengan izin NTFS untuk akun itu.

Restart dan batas

Arsip tidak memasang layanan. Atur auto-restart dan batas memori keras di pengelola layanan kamu sendiri (systemd, NSSM, Task Scheduler). Mulai ulang dari aplikasi dan pemulihan backup sama-sama menghentikan program dan mengandalkan pengelola layanan untuk memulainya lagi.

Update dan kembali ke versi sebelumnya

1. Periksa arsip baru sebelum menghentikan aplikasi.
2. Hentikan HolyArrs dan salin seluruh folder konfigurasi, termasuk kunci utama. Atau buat backup di aplikasi dan simpan kuncinya terpisah.
3. Ekstrak program baru ke folder yang berbeda. Simpan program lama dan salinan konfigurasi lama.
4. Mulai program baru dengan konfigurasi kamu. Kamu seharusnya bisa masuk, dan /health menampilkan running.

Bahaya

Jangan pernah mengarahkan program yang lebih lama ke database yang sudah diubah oleh yang lebih baru. Untuk kembali ke versi sebelumnya, simpan dulu konfigurasi yang baru, lalu mulai program lama dengan salinan konfigurasi lama yang cocok.

Lihat Backup.

Kalau tidak berhasil

Gejala	Penyebab	Solusi
“started as root outside a container”	Dimulai sebagai root	Jalankan dengan pengguna sendiri, atau setel PUID dan PGID.
Aplikasi keluar setelah pemulihan	Pemulihan menyiapkan data lalu keluar dengan kode 75	Mulai lagi untuk menerapkannya. Setel pengelola layanan kamu untuk memulainya ulang.
Panggilan HTTPS gagal di Linux	Tidak ada sertifikat CA sistem	Pasang sertifikatnya.
Build bilang output sudah ada	Folder output yang sudah ada ditolak	Pilih folder baru.

Untuk yang mahir

Opsi build

Opsi	Fungsinya	Bawaan
--targets	Subset yang dibuat, dipisah koma	linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource	Setiap container builder mendapat 1 CPU, 2 GiB, dan 256 proses; Go membangun satu paket sekali jalan. Pengemasan tetap berjalan di host, di luar batas itu.	nonaktif

Build berjalan di image builder Go yang dikunci proyek dengan jaringan mati, jadi tidak mengunduh apa pun. Cache modul di-mount hanya-baca. Kalau ada target yang gagal, tidak ada folder output yang tersisa. Commit ditambahkan ke nomor versi dan dibangun ke dalam program; aplikasi dan backup-nya melaporkannya.

Isi sebuah arsip

Program, lisensi, pemberitahuan pihak ketiga, panduan, manifes source, dan identitas paket. Arsip source terpisah berisi source proyek dan dependensi Go; simpan di samping binary-nya.

SHA256SUMS membuktikan file cocok. Itu bukan tanda tangan. Commit, versi, dan input yang sama menghasilkan arsip yang sama, jadi kamu bisa membangun ulang untuk memeriksa.

Catatan runtime

Topik	Detail
Path konfigurasi	Bawaan /config. Selalu berikan -config, di disk lokal.
Target memori	384 MiB tanpa GOMEMLIMIT. Setel ke sekitar 80 persen dari memori yang kamu berikan. Target, bukan batas keras.
Mode memori rendah	Di Linux, aktif sendiri pada sekitar 2.5 GiB atau kurang; targetnya turun ke seperempat memori, antara 192 dan 384 MiB. HOLYARRS_LOW_MEMORY=1 atau 0 yang menentukan.
Node	Tidak dibutuhkan untuk menjalankannya.
Hardlink	Simpan unduhan dan folder pustaka di satu sistem file.

Terkait

• Pemasangan
• Bagian dan mode aman
• Update