İçeriğe geç
HolyArrsDocsHolyArrs.com

Taşınabilir sürüm

Kurulum

HolyArrs’ı Linux ya da Windows’ta Docker olmadan düz bir program olarak çalıştır. Çalıştırmanın ana yolu Docker olarak kalır.

Başlamadan önce

Başlamadan önce bağlantısı
  • Derleme bilgisayarında Python 3, Git ve Docker.
  • Normal bir proje derlemesinden dolu bir Go modül önbelleği ve app/frontend/package-lock.json dosyasından kurulmuş frontend bağımlılıkları.
  • Derlenmiş web uygulaması commit’lenmiş olmalı. Derleme yalnızca commit’lenmiş kaynağı kullanır; commit’lenmemiş değişiklikler dışarıda kalır.

Derle ve çalıştır

Derle ve çalıştır bağlantısı

  1. Checkout klasöründen arşivleri derle:

    Terminal window
    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’un dışında yeni bir çıktı klasörü kullan. Her hedef için bir arşiv ve bir SHA256SUMS dosyası görmelisin.

  2. Arşivi SHA256SUMS ile denetle.

  3. Yeni bir klasöre çıkar. Program ile yapılandırmayı ayrı klasörlerde tut.

  4. Kendi yapılandırma yolunla başlat:

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

    Windows PowerShell’de:

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

  5. http://your-server:6262 adresini aç. İlk açılış sihirbazını görmelisin. Sahip hesabını hemen oluştur; ilk gelen ziyaretçi sahip olur.

Seçenekler

Seçenekler bağlantısı

Kim çalıştırır

Kim çalıştırır bağlantısı

HolyArrs’ı kendi hesabıyla çalıştır; yalnızca yapılandırmaya ve medyana yazma izni olsun.

  • Konteyner dışında root olarak, PUID ve PGID olmadan başlarsa “started as root outside a container” diyerek durur.
  • PUID ve PGID ayarlıysa yapılandırma klasörünü o kullanıcıya devreder ve o kullanıcıya geçer.
  • Windows’ta yapılandırma klasörünü o hesap için bir NTFS izniyle koru.

Yeniden başlatmalar ve limitler

Yeniden başlatmalar ve limitler bağlantısı

Arşiv hiçbir servis kurmaz. Otomatik yeniden başlatmayı ve sert bellek limitlerini kendi servis yöneticinde ayarla (systemd, NSSM, Task Scheduler). Uygulamadan yeniden başlatma ve yedek geri yükleme ikisi de çıkar ve yeniden başlatılmayı bekler.

Güncelle ve geri dön

Güncelle ve geri dön bağlantısı
  1. Uygulamayı durdurmadan önce yeni arşivi denetle.
  2. HolyArrs’ı durdur ve ana anahtar dahil tüm yapılandırma klasörünü kopyala. Ya da uygulamada yedek al ve anahtarını ayrı sakla.
  3. Yeni programı farklı bir klasöre çıkar. Eski programı ve eski yapılandırma kopyasını sakla.
  4. Yeni programı yapılandırmanın üstünde başlat. Giriş yapabilmelisin ve /health running göstermeli.

Bkz. Yedekler.

Çalışmazsa

Çalışmazsa bağlantısı
Belirti Neden Çözüm
“started as root outside a container” Root olarak başlatıldı Kendi kullanıcısıyla çalıştır ya da PUID ve PGID ayarla.
Uygulama geri yüklemeden sonra çıkıyor Geri yükleme veriyi hazırlar ve 75 koduyla çıkar Uygulamak için yeniden başlat. Servis yöneticini yeniden başlatacak şekilde ayarla.
Linux’ta HTTPS çağrıları başarısız oluyor Sistem CA sertifikaları yok Kur.
Derleme çıktının zaten var olduğunu söylüyor Var olan çıktı klasörleri reddedilir Yeni bir klasör seç.

Uzmanlar için

Uzmanlar için bağlantısı
Derleme seçenekleri
Seçenek Ne yapar Varsayılan
--targets Derlenecek alt kümeyi virgülle ayırır linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource Her derleyici konteyner 1 CPU, 2 GiB ve 256 işlem alır; Go paketleri tek tek derler. Paketleme yine host’ta, bu limitlerin dışında çalışır. kapalı

Derleme, projenin sabitlenmiş Go derleyici imajında ve ağ kapalıyken çalışır, bu yüzden hiçbir şey indirmez. Modül önbelleği salt okunur bağlanır. Herhangi bir hedef başarısız olursa çıktı klasörü bırakılmaz. Commit sürüm numarasına eklenir ve programın içine işlenir; uygulama ve yedekleri bunu bildirir.

Bir arşivde ne var

Program, lisans, üçüncü taraf bildirimleri, kılavuzlar, bir kaynak manifesti ve paket kimliği. Ayrı bir kaynak arşivi proje kaynağını ve Go bağımlılıklarını tutar; onu ikili dosyaların yanında sakla.

SHA256SUMS dosyaların eşleştiğini kanıtlar. İmza değildir. Aynı commit, sürüm ve girdiler aynı arşivleri verir, bu yüzden denetlemek için yeniden derleyebilirsin.

Çalışma zamanı notları
Konu Ayrıntı
Yapılandırma yolu Varsayılan /config. Her zaman -config ver, yerel bir diskte olsun.
Bellek hedefi GOMEMLIMIT olmadan 384 MiB. Verdiğin belleğin yaklaşık yüzde 80’ine ayarla. Hedeftir, sert limit değil.
Düşük bellek modu Linux’ta yaklaşık 2.5 GiB ya da altında kendiliğinden açılır; hedef belleğin dörtte birine düşer, 192 ile 384 MiB arasında. HOLYARRS_LOW_MEMORY=1 ya da 0 belirler.
Node Çalıştırmak için gerekmez.
Hardlink’ler İndirme ve Kütüphane klasörlerini tek dosya sisteminde tut.

İlgili

İlgili bağlantısı

HolyArrs ücretsiz. Zamanından tasarruf ettirdiyse GitHub'da yıldızla, sponsor ol ya da bana bir kahve ısmarla.