Preskoči na sadržaj
HolyArrsDocsHolyArrs.com

Ažuriranja

Novi si ovdje

HolyArrs ti javi kad je izašla nova verzija, ali je nikad ne instalira sam. Novi image povučeš kad ti odgovara.

Vidi je li izašla nova verzija

Poveznica na Vidi je li izašla nova verzija
  1. Otvori stranicu Status (http://your-server:6262/health).
  2. Pročitaj Updates (ažuriranja). Vidjet ćeš jednu od ovih poruka:
Poruka Značenje
“HolyArrs 1.2.0 is out, newer than this one.” Ažuriraj kad ti odgovara
“This is the newest version.” Ne treba ništa raditi
“No HolyArrs release is published yet.” Feed je prazan. Sve je u redu
“The last check did not work: …” Feed nije dostupan, često zbog interneta
“The update check is off: …” Isključeno u postavkama
  1. Za provjeru odmah klikni na Check now (provjeri sada) (ili Check again, provjeri ponovno). Treba ti dozvola Change settings (promjena postavki).

Novija verzija prikazuje se i kao upozorenje o stanju. Neuspjela provjera prikazuje se samo pod Updates.

Ažuriraj

Poveznica na Ažuriraj
  1. Povuci novi image i ponovno pokreni: docker compose pull, zatim docker compose up -d.
  2. HolyArrs se pokreće. Ako nova verzija mijenja način spremanja podataka, prvo napravi backup, a zatim ažurira podatke. Vidjet ćeš kako se aplikacija otvara na novoj verziji.

Vrati se na stariju verziju

Poveznica na Vrati se na stariju verziju

HolyArrs ne može promijeniti vlastiti image, pa pokreneš stariji image, a HolyArrs vrati starije podatke.

  1. U svojoj compose datoteci (ili u docker run) promijeni image tag u stariji, na primjer holyarrs/holyarrs:<older version>.
  2. Izvrši docker compose up -d.
  3. Ako ažuriranje nije mijenjalo podatke, starija verzija se pokrene. Gotovo.
  4. U suprotnom starija verzija prikazuje stranicu umjesto aplikacije. Klikni na Put back the data from before the update (vrati podatke od prije ažuriranja).
  5. Unesi jednokratni kod. Pronađi ga s docker logs <container>; traži “one-time code”.
  6. HolyArrs provjeri backup, vrati ga na mjesto i stane. Vidjet ćeš da se container ponovno pokrene na tim podacima zahvaljujući pravilu ponovnog pokretanja. Bez njega ga pokreni sam.

Bez te stranice: docker exec <container> /holyarrs restore --pre-update, zatim docker restart <container>. Bez Dockera: zaustavi HolyArrs, izvrši holyarrs restore --pre-update, pokreni ga.

Ništa se ne briše. Novije podatke HolyArrs premješta u backups/before-restore-<time>/, pa možeš poništiti. Ako se vraćaš za više od jedne verzije, odabire se najnoviji backup prije ažuriranja koji ta verzija može pročitati.

Izbori

Poveznica na Izbori

Sve je u Settings > Health checks (Postavke > Provjere stanja). Zadnje tri nalaze se u naprednom dijelu kartice.

Postavka Zadano Promijeni kad
Check for a newer HolyArrs On Ne želiš nikakav vanjski zahtjev
Check for updates every day Želiš rjeđe provjere: 3, 7, 14 ili 30 dana
Release feed Empty (HolyArrs releases) Imaš vlastiti feed
Feed may be on the local network Off Tvoj feed je u tvojoj mreži
Include test versions (like 1.2.0-rc1) Off Želiš obavijesti o probnim verzijama

Ako ne radi

Poveznica na Ako ne radi

Simptom: “The last check did not work.” Uzrok: server nema internet ili je tvoj feed u lokalnoj mreži. Rješenje: provjeri pristup internetu ili uključi Feed may be on the local network.

Simptom: release feed se ne sprema. Uzrok: adresa sadrži ime, lozinku, ?query ili #fragment, ili ne počinje s http:// ili https://. Rješenje: ukloni te dijelove.

Simptom: ažuriranje je stalo zbog nedostatka prostora na disku. Uzrok: nema mjesta za kopiju i ažuriranje. Rješenje: oslobodi prostor tamo gdje je mapa s konfiguracijom, pa pokreni ponovno.

Simptom: stranica za povratak odbija tvoj kod. Uzrok: star kod ili 10 pogrešnih kodova od zadnjeg pokretanja. Rješenje: kopiraj kod iz najnovijeg retka loga. Nakon 10 pogrešnih pokušaja ponovno pokreni container i koristi novi kod.

Zadržane značajke

Poveznica na Zadržane značajke

Neke značajke u ovoj verziji prema zadanim postavkama su isključene. Uključi ih na vlastitu odgovornost. Dok su zadržane, njihove stranice i stavke izbornika skrivene su, njihove API rute odgovaraju “not found”, a njihovi zadaci ne rade. Spremljeni podaci za njih ostaju.

Da uključiš jednu, dodaj njezin prekidač u HOLYARRS_FLAGS, odvojen zarezima, i ponovno pokreni container:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Ukloni ime i ponovno pokreni da je isključiš. Skrivene postavke vraćaju se kad je opet uključiš.

Prekidač Značajka
row_title_stats Statistika naslova u redovima Istraži u Appearance
trakt_lists Trakt ključ, Trakt popisi i Trakt recenzije. TMDB popisi ostaju uključeni
alert_channels_more Obavijesti preko Telegrama, ntfy-ja, Gotifyja, Pushovera i webhooka. Discord i e-pošta ostaju uključeni
subtitle_sites Stranice s titlovima i pretraga titlova. Tvoj jezik titlova ostaje uključen
emby_signin Prijava s Embyjem. Osvježavanje Emby biblioteke i dalje radi
go_back Panel Go back na stranici Status. Koraci iz Vrati se na stariju verziju rade i bez njega

Ništa se nije promijenilo nakon dodavanja prekidača? Provjeri pravopis (mala slova, podcrte) i ponovno pokreni container, ne samo stranicu.

Za napredne

Poveznica na Za napredne
Što provjera šalje

Jedan zahtjev na api.github.com za najnoviju verziju, samo sa zaglavljem User-Agent: HolyArrs/<version>. Bez računa, ključa ili popisa medija. Kad je provjera isključena, nema nikakvog zahtjeva.

Zadnji odgovor se sprema, pa ponovno pokretanje ne provjerava prije nego što je potrebno. Jedna provjera čeka najviše 15 s, čita najviše 512 KB i prati najviše 3 preusmjeravanja, nikad ne prelazeći između http i https. Poveznica na bilješke o verziji prikazuje se samo kad vodi na stranice HolyArrs verzija na GitHubu; inače se verzija prikazuje kao običan tekst.

Release feed prihvaća odgovor u GitHub stilu, popis verzija, bilo koji JSON s version ili običan tekst s verzijom. Adrese cloud metapodataka uvijek se odbijaju. Probna verzija računa se kao starija od obične verzije.

Backup prije ažuriranja

Prije promjene spremljenih podataka HolyArrs:

  1. Provjerava ima li mjesta za kopiju i ažuriranje. Ako nema, ništa se ne mijenja. Preskoči s HOLYARRS_SKIP_SPACE_CHECK=yes.
  2. Kopira svaku bazu podataka u backups, provjerava kopiju i pored nje piše sha256 datoteku. Nakon 3 neuspjela kopiranja ništa se ne mijenja.
  3. Izvršava svaki korak ažuriranja zasebno i provjerava ga. Neuspjeli korak se poništava; gotovi koraci ostaju. Pokreni istu verziju ponovno da nastaviš od neuspjelog koraka s istom kopijom.

Nakon prvog uspješnog pokretanja kopija postaje holyarrs-backup-pre-update-<time>.zip, s opisom poput “before updating from 1.1.0 to 1.2.0”. Vidi se u Settings > Backups i u holyarrs restore --list. Čuva se najnovijih 3; raspored backupa nikad ih ne uklanja. Nova instalacija ili ažuriranje koje ne dira podatke ne stvara nijedan.

Provjeri image

Od 1.0.3 svaki image na Docker Hubu potpisuje proces izdavanja verzije na GitHubu. Nema ključa za preuzimanje. Provjeri image s cosign. Na mjesto <version> stavi verziju koju koristiš, na primjer 1.0.3:

Terminal window
cosign verify holyarrs/holyarrs:<version> \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp '^https://github.com/HolyArrs/HolyArrs/\.github/workflows/sign\.yml@refs/(tags/[0-9.]+|heads/main)$'

Vidjet ćeš The cosign claims were validated. Sve drugo znači da image ne dolazi iz procesa izdavanja verzije HolyArrs: ne pokreći ga.

Image nosi i zapis o tome kako je izgrađen te popis onoga što sadrži (SBOM). Provjeri ih s GitHub CLI-jem:

Terminal window
gh attestation verify oci://docker.io/holyarrs/holyarrs:<version> --repo HolyArrs/HolyArrs

Iste datoteke nalaze se na svakoj GitHub verziji: .sigstore.json (potpis), .intoto.jsonl (zapis izgradnje) i .sbom.spdx.json (sadržaj).

Povezane stranice

Poveznica na Povezane stranice

HolyArrs je besplatan. Ako ti je uštedio vrijeme, daj mu zvjezdicu na GitHubu, podrži ga ili počasti me kavom.