Binaan mudah alih

Jalankan HolyArrs sebagai program biasa pada Linux atau Windows, tanpa Docker. Docker kekal sebagai cara utama menjalankannya.

Caution

Belum ada sesiapa yang menerbitkan arkib mudah alih, dan ia tidak ditandatangani. Anda membinanya sendiri daripada sumber.

Sebelum bermula

• Python 3, Git dan Docker pada komputer pembinaan.
• Cache modul Go yang sudah terisi daripada binaan projek biasa, dan kebergantungan frontend dipasang daripada app/frontend/package-lock.json.
• App web yang telah dibina sudah di-commit. Pembinaan hanya menggunakan sumber yang di-commit; suntingan yang belum di-commit ditinggalkan.

Bina dan jalankan

1. Daripada checkout, bina arkib:

   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

   Gunakan folder output baharu di luar checkout. Anda akan nampak satu arkib bagi setiap sasaran dan fail SHA256SUMS.

2. Semak arkib dengan SHA256SUMS.

3. Ekstrak ke dalam folder baharu. Simpan program dan konfigurasi dalam folder berasingan.

4. Mulakan dengan laluan konfigurasi anda sendiri:

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

   Pada Windows PowerShell:

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

5. Buka http://your-server:6262. Anda akan nampak wizard larian pertama. Cipta akaun pemilik serta-merta; pelawat pertama menjadi pemilik.

Pilihan

Pengguna mana yang menjalankannya

Jalankan HolyArrs di bawah akaunnya sendiri, dengan kebenaran menulis hanya pada konfigurasi dan media anda.

• Sebagai root di luar kontena, tanpa PUID dan PGID, ia berhenti dengan “started as root outside a container”.
• Dengan PUID dan PGID ditetapkan, ia menyerahkan folder konfigurasi kepada pengguna itu dan bertukar kepadanya.
• Pada Windows, lindungi folder konfigurasi dengan kebenaran NTFS untuk akaun itu.

Mula semula dan had

Arkib tidak memasang sebarang perkhidmatan. Sediakan mula semula automatik dan had memori tegar dalam pengurus perkhidmatan anda sendiri (systemd, NSSM, Task Scheduler). Mula semula daripada app dan pemulihan sandaran kedua-duanya keluar dan menjangka ia dimulakan semula.

Kemas kini dan kembali ke versi lama

1. Semak arkib baharu sebelum anda menghentikan app.
2. Hentikan HolyArrs dan salin seluruh folder konfigurasi, termasuk kunci induk. Atau buat sandaran dalam app dan simpan kuncinya secara berasingan.
3. Ekstrak program baharu ke dalam folder yang berbeza. Simpan program lama dan salinan konfigurasi lama.
4. Mulakan program baharu pada konfigurasi anda. Anda sepatutnya dapat log masuk, dan /health patut menunjukkan running.

Danger

Jangan sekali-kali halakan program yang lebih lama pada pangkalan data yang telah diubah oleh program yang lebih baharu. Untuk kembali ke versi lama, simpan konfigurasi yang lebih baharu dahulu, kemudian mulakan program lama pada salinan konfigurasi lamanya yang sepadan.

Lihat Sandaran.

Jika tidak berfungsi

Gejala	Punca	Penyelesaian
“started as root outside a container”	Dimulakan sebagai root	Jalankan sebagai pengguna sendiri, atau tetapkan PUID dan PGID.
App keluar selepas pemulihan	Pemulihan menyediakan data dan keluar dengan kod 75	Mulakan semula untuk menggunakannya. Tetapkan pengurus perkhidmatan anda untuk memulakannya semula.
Panggilan HTTPS gagal pada Linux	Tiada sijil CA sistem	Pasangnya.
Pembinaan menyatakan output sudah wujud	Folder output yang sedia ada ditolak	Pilih folder baharu.

Untuk pakar

Pilihan pembinaan

Pilihan	Fungsi	Lalai
--targets	Subset dipisahkan koma untuk dibina	linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource	Setiap kontena pembina mendapat 1 CPU, 2 GiB dan 256 proses; Go membina satu pakej sekali gus. Pembungkusan masih berjalan pada hos, di luar had itu.	mati

Pembinaan berjalan dalam imej pembina Go yang dikunci oleh projek dengan rangkaian dimatikan, jadi ia tidak memuat turun apa-apa. Cache modul dilekapkan baca sahaja. Jika mana-mana sasaran gagal, tiada folder output ditinggalkan. Commit ditambah pada nombor versi dan dibina ke dalam program; app dan sandarannya melaporkannya.

Apa yang ada dalam arkib

Program, lesen, notis pihak ketiga, panduan, manifes sumber dan identiti pakej. Arkib sumber yang berasingan mengandungi sumber projek dan kebergantungan Go; simpan di sebelah binari.

SHA256SUMS membuktikan fail itu sepadan. Ia bukan tandatangan. Commit, versi dan input yang sama menghasilkan arkib yang sama, jadi anda boleh membina semula untuk menyemak.

Nota masa jalan

Topik	Butiran
Laluan konfigurasi	Lalai /config. Sentiasa berikan -config, pada cakera setempat.
Sasaran memori	384 MiB tanpa GOMEMLIMIT. Tetapkan kepada kira-kira 80 peratus daripada memori yang anda berikan. Satu sasaran, bukan had tegar.
Mod memori rendah	Pada Linux, hidup sendiri pada kira-kira 2.5 GiB atau kurang; sasaran turun kepada suku memori, antara 192 dan 384 MiB. HOLYARRS_LOW_MEMORY=1 atau 0 menentukannya.
Node	Tidak diperlukan untuk menjalankannya.
Hardlink	Pastikan folder muat turun dan Pustaka pada satu sistem fail.

Berkaitan

• Pasang
• Bahagian dan mod selamat
• Kemas kini