Uuendused

HolyArrs annab teada, kui uus versioon on väljas, ega paigalda seda kunagi ise. Uue image’i tõmbad siis, kui sulle sobib.

Vaata, kas uus versioon on väljas

1. Ava leht Status (olek), aadressil http://your-server:6262/health.
2. Loe jaotist Updates (uuendused). Näed ühte neist:

Teade	Tähendus
“HolyArrs 1.2.0 is out, newer than this one.”	Uuenda, kui valmis oled
“This is the newest version.”	Pole midagi teha
“No HolyArrs release is published yet.”	Voog on tühi. Midagi pole viga
“The last check did not work: …”	Voogu ei saadud kätte, sageli puudub internet
“The update check is off: …”	Seadetes välja lülitatud

3. Kohe kontrollimiseks vajuta Check now (kontrolli kohe) või Check again (kontrolli uuesti). Selleks on vaja õigust Change settings (muuda seadeid).

Uuem versioon näitab end ka tervisehoiatusena. Ebaõnnestunud kontroll on näha ainult jaotises Updates.

Uuenda

1. Tõmba uus image ja käivita uuesti: docker compose pull, seejärel docker compose up -d.
2. HolyArrs käivitub. Kui uus versioon muudab andmete salvestamise viisi, teeb see esmalt varukoopia ja uuendab siis andmed. Näed rakenduse avanemist uues versioonis.

Tip

HolyArrs võtab ebaõnnestunud uuendussammu tagasi ja peatub lehel, mis ütleb, mis juhtus. Sinu andmed enne uuendust jäävad varukoopiana alles.

Mine vanemale versioonile tagasi

HolyArrs ei saa oma image’it muuta, seega käivitad sina vanema image’i ja HolyArrs paneb vanemad andmed tagasi.

Caution

Kõik, mis pärast uuendust muutus, näiteks uued pealkirjad, seaded ja ajalugu, ei ole uuendusele eelnenud varukoopias.

1. Muuda oma compose-failis (või käsus docker run) image’i tag vanemaks, näiteks holyarrs/holyarrs:<older version>.
2. Käivita docker compose up -d.
3. Kui uuendus ei muutnud andmeid, käivitub vanem versioon. Oled valmis.
4. Muidu näitab vanem versioon rakenduse asemel lehte. Vajuta Put back the data from before the update (pane tagasi andmed enne uuendust).
5. Sisesta ühekordne kood. Leia see käsuga docker logs <container>; otsi teksti „one-time code“.
6. HolyArrs kontrollib varukoopiat, paneb selle paika ja peatub. Näed, kuidas konteiner käivitub taaskäivituse poliitika kaudu uuesti nende andmetega. Kui poliitikat pole, käivita see ise.

Ilma lehetta: docker exec <container> /holyarrs restore --pre-update, seejärel docker restart <container>. Ilma Dockerita: peata HolyArrs, käivita holyarrs restore --pre-update, käivita see uuesti.

Midagi ei kustutata. Uuemad andmed liiguvad kausta backups/before-restore-<time>/, nii et saad tagasi võtta. Kui lähed tagasi rohkem kui ühe versiooni võrra, valitakse uusim uuendusele eelnev varukoopia, mida see versioon suudab lugeda.

Valikud

Kõik asuvad lehel Settings > Health checks (seaded > tervisekontrollid). Viimased kolm on kaardi täpsemas osas.

Säte	Vaikimisi	Muuda, kui
Check for a newer HolyArrs (otsi uuemat HolyArrsi)	Sees	Soovid, et väliseid päringuid ei tehtaks üldse
Check for updates every (kontrolli uuendusi iga)	päev	Soovid harvemaid kontrolle: 3, 7, 14 või 30 päeva
Release feed (väljalaskevoog)	Tühi (HolyArrsi versioonid)	Hostid oma voogu
Feed may be on the local network (voog võib olla kohtvõrgus)	Väljas	Sinu voog asub sinu enda võrgus
Include test versions (like 1.2.0-rc1) (kaasa testversioonid)	Väljas	Soovid teavitusi testversioonide kohta

Kui see ei tööta

Sümptom: “The last check did not work.” Põhjus: serveril puudub internet või sinu enda voog asub kohtvõrgus. Lahendus: kontrolli internetiühendust või lülita sisse Feed may be on the local network.

Sümptom: väljalaskevoogu ei saa salvestada. Põhjus: aadress sisaldab nime, parooli, osa ?query või #fragment või ei alga tekstiga http:// või https://. Lahendus: eemalda need osad.

Sümptom: uuendus peatus kettaruumi puudumise tõttu. Põhjus: koopiale ja uuendusele ei jätku ruumi. Lahendus: tee vaba ruumi seal, kus asub seadete kaust, ja käivita uuesti.

Sümptom: tagasimineku leht lükkab sinu koodi tagasi. Põhjus: vana kood või 10 valet koodi pärast viimast käivitust. Lahendus: kopeeri kood uusimalt logireal. Pärast 10 valet katset taaskäivita konteiner ja kasuta uut koodi.

Edasi lükatud funktsioonid

Mõned funktsioonid on selles versioonis vaikimisi välja lülitatud. Lülita need sisse omal vastutusel. Kuni need on edasi lükatud, on nende lehed ja menüükirjed peidetud, nende API marsruudid vastavad „not found“ ja nende tööülesanded ei käivitu. Andmed, mille nende jaoks salvestasid, jäävad alles.

Sisselülitamiseks lisa selle lüliti muutujasse HOLYARRS_FLAGS, komaga eraldatult, ja taaskäivita konteiner:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Väljalülitamiseks eemalda nimi ja taaskäivita. Peidetud seaded tulevad tagasi, kui lülitad selle uuesti sisse.

Lüliti	Funktsioon
row_title_stats	Avasta lehe ridade pealkirjade statistika jaotises Appearance
trakt_lists	Trakti võti, Trakti loendid ja Trakti arvustused. TMDB loendid jäävad sisse lülitatuks
alert_channels_more	Telegrami, ntfy, Gotify, Pushoveri ja webhooki teavitused. Discordi ja e-posti teavitused jäävad sisse lülitatuks
subtitle_sites	Subtiitrite saidid ja subtiitrite otsing. Sinu subtiitrite keel jääb sisse lülitatuks
emby_signin	Emby-ga sisselogimine. Embys meediakogu värskendamine töötab edasi
go_back	Lehe Status paneel Go back (mine tagasi). Jaotise Mine vanemale versioonile tagasi sammud töötavad ka ilma selleta

Midagi ei muutunud pärast lüliti lisamist? Kontrolli kirjapilti (väiketähed, alakriipsud) ja taaskäivita konteiner, mitte ainult lehte.

Asjatundjale

Mida kontroll saadab

Üks päring aadressile api.github.com uusima versiooni kohta, ainult päisega User-Agent: HolyArrs/<version>. Ei mingit kontot, võtit ega meedialoendit. Kui kontroll on väljas, ei tehta päringut üldse.

Viimane vastus salvestatakse, nii et taaskäivitus ei kontrolli enne tähtaega. Üks kontroll ootab kuni 15 s, loeb kuni 512 KB ja järgib kuni 3 ümbersuunamist, kunagi http ja https vahel vahetamata. Väljalaskemärkmete link on näha ainult siis, kui see viib HolyArrsi versioonide lehtedele GitHubis; muidu näidatakse versiooni tavalise tekstina.

Release feed võtab vastu GitHubi stiilis versioonivastuse, versioonide loendi, mis tahes JSON-i väljaga version või lihttekstina versiooni. Pilvemetaandmete aadressid lükatakse alati tagasi. Testversioon loetakse tavaversioonist vanemaks.

Varukoopia enne uuendust

Enne salvestatud andmete muutmist HolyArrs:

1. Kontrollib, kas koopiale ja uuendusele jätkub ruumi. Kui ei, ei muutu midagi. Jäta vahele muutujaga HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Kopeerib iga andmebaasi kausta backups, kontrollib koopiat ja kirjutab selle kõrvale sha256 faili. Pärast 3 ebaõnnestunud kopeerimist ei muutu midagi.
3. Käivitab iga uuendussammu eraldi ja kontrollib seda. Ebaõnnestunud samm võetakse tagasi; lõpetatud sammud jäävad. Käivita sama versioon uuesti, et jätkata ebaõnnestunud sammust sama koopiaga.

Pärast esimest edukat käivitust muutub koopia failiks holyarrs-backup-pre-update-<time>.zip, mille kirjeldus on umbes „before updating from 1.1.0 to 1.2.0“. See on näha lehel Settings > Backups (seaded > varukoopiad) ja käsus holyarrs restore --list. Uusimad 3 jäävad alles; varukoopiate ajakava ei eemalda neid kunagi. Värske paigaldus või uuendus, mis andmeid ei puuduta, ei tee ühtegi.

Kontrolli image'it

Alates versioonist 1.0.3 allkirjastab iga Docker Hubi image’i GitHubi versiooni väljalaskekäivitus. Võtit pole vaja alla laadida. Kontrolli image’it tööriistaga cosign. Pane oma kasutatav versioon, näiteks 1.0.3, kohta, kus on <version>:

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)$'

Näed teksti The cosign claims were validated. Kõik muu tähendab, et image ei pärine HolyArrsi väljalaskekäivitusest: ära seda käivita.

Image’il on ka kirje selle ehitamise kohta ja loend sellest, mis selle sees on (SBOM). Kontrolli neid GitHub CLI-ga:

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

Samad failid on igal GitHubi versioonil: .sigstore.json (allkiri), .intoto.jsonl (ehituskirje) ja .sbom.spdx.json (sisu).

Seotud lehed

• Varukoopiad
• Tervisekontrollid
• Osad ja turvarežiim