Päivitykset

HolyArrs kertoo, kun uusi versio on ulkona, mutta ei koskaan asenna sitä itse. Vedät uuden imagen, kun se sopii sinulle.

Katso, onko uusi versio ulkona

1. Avaa sivu Status (tila) (http://your-server:6262/health).
2. Lue kohta Updates (päivitykset). Näet jonkin näistä:

Viesti	Merkitys
“HolyArrs 1.2.0 is out, newer than this one.”	Päivitä, kun sopii
“This is the newest version.”	Ei tehtävää
“No HolyArrs release is published yet.”	Julkaisusyöte on tyhjä. Mikään ei ole vialla
“The last check did not work: …”	Syötteeseen ei saatu yhteyttä, usein internet puuttuu
“The update check is off: …”	Poistettu käytöstä asetuksissa

3. Jos haluat kysyä heti, napsauta Check now (tarkista nyt) tai Check again (tarkista uudelleen). Se vaatii oikeuden Change settings (muuta asetuksia).

Uudempi versio näkyy myös kuntovaroituksena. Epäonnistunut tarkistus näkyy vain kohdassa Updates.

Päivitä

1. Vedä uusi image ja käynnistä uudelleen: docker compose pull, sitten docker compose up -d.
2. HolyArrs käynnistyy. Jos uusi versio muuttaa tietojen tallennustapaa, se tekee ensin varmuuskopion ja päivittää sitten tiedot. Sovelluksen pitäisi avautua uudessa versiossa.

Vinkki

Epäonnistunut päivitysvaihe perutaan, ja HolyArrs pysähtyy sivulle, joka kertoo, mitä tapahtui. Tietosi ennen päivitystä säilyvät varmuuskopiona.

Palaa vanhaan versioon

HolyArrs ei voi vaihtaa omaa imageaan, joten ajat vanhemman imagen ja HolyArrs laittaa vanhemmat tiedot takaisin.

Varoitus

Mikään päivityksen jälkeen muuttunut, kuten uudet nimikkeet, asetukset ja historia, ei ole päivitystä edeltävässä varmuuskopiossa.

1. Vaihda compose-tiedostossasi (tai docker run -komennossa) image-tagi vanhempaan, esimerkiksi holyarrs/holyarrs:<older version>.
2. Suorita docker compose up -d.
3. Jos päivitys ei muuttanut tietoja, vanhempi versio käynnistyy. Olet valmis.
4. Muussa tapauksessa vanhempi versio näyttää sovelluksen sijaan sivun. Valitse Put back the data from before the update (laita takaisin tiedot ennen päivitystä).
5. Kirjoita kertakäyttökoodi. Löydät sen komennolla docker logs <container>; etsi rivi, jossa lukee “one-time code”.
6. HolyArrs tarkistaa varmuuskopion, laittaa sen paikalleen ja pysähtyy. Containerin pitäisi käynnistyä uudelleen näillä tiedoilla uudelleenkäynnistyskäytännön ansiosta. Jos sitä ei ole, käynnistä se itse.

Ilman sivua: docker exec <container> /holyarrs restore --pre-update, sitten docker restart <container>. Ilman Dockeria: pysäytä HolyArrs, suorita holyarrs restore --pre-update ja käynnistä se.

Mitään ei poisteta. Uudemmat tiedot siirtyvät kansioon backups/before-restore-<time>/, joten voit perua palautuksen. Jos palaat useamman kuin yhden version taaksepäin, valitaan uusin päivitystä edeltävä varmuuskopio, jonka kyseinen versio osaa lukea.

Vaihtoehdot

Kaikki ovat kohdassa Settings > Health checks (asetukset > kuntotarkistukset). Kolme viimeistä ovat kortin lisäasetuksissa.

Asetus	Oletus	Muuta, kun
Check for a newer HolyArrs	On	Et halua mitään ulkopuolelle lähtevää pyyntöä
Check for updates every	day	Haluat harvempia tarkistuksia: 3, 7, 14 tai 30 päivää
Release feed	Empty (HolyArrs releases)	Ylläpidät omaa syötettä
Feed may be on the local network	Off	Syötteesi on omassa verkossasi
Include test versions (like 1.2.0-rc1)	Off	Haluat ilmoituksia testiversioista

Jos se ei toimi

Oire: “The last check did not work.” Syy: palvelimella ei ole internetiä, tai oma syötteesi on paikallisessa verkossa. Ratkaisu: tarkista internetyhteys tai ota käyttöön Feed may be on the local network.

Oire: julkaisusyöte ei tallennu. Syy: osoitteessa on nimi, salasana, ?query tai #fragment, tai se ei ala merkeillä http:// tai https://. Ratkaisu: poista nuo osat.

Oire: päivitys pysähtyi levytilan puutteeseen. Syy: kopiolle ja päivitykselle ei ole tilaa. Ratkaisu: vapauta tilaa levyltä, jolla asetuskansio on, ja käynnistä uudelleen.

Oire: palautussivu hylkää koodisi. Syy: koodi on vanha, tai viimeisimmän käynnistyksen jälkeen on annettu 10 väärää koodia. Ratkaisu: kopioi koodi uusimmalta lokiriviltä. 10 väärän yrityksen jälkeen käynnistä container uudelleen ja käytä uutta koodia.

Myöhemmäksi jätetyt ominaisuudet

Jotkin ominaisuudet ovat tässä versiossa oletuksena pois päältä. Voit ottaa ne käyttöön omalla vastuullasi. Kun ominaisuus on pidätetty, sen sivut ja valikkokohdat ovat piilossa, sen API-reitit vastaavat “not found” eivätkä sen tehtävät ajaudu. Sitä varten tallentamasi tiedot säilyvät.

Ota ominaisuus käyttöön lisäämällä sen kytkin muuttujaan HOLYARRS_FLAGS pilkuilla erotettuna ja käynnistä container uudelleen:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Poista nimi ja käynnistä uudelleen, niin ominaisuus poistuu käytöstä. Piilotetut asetukset palaavat, kun otat ominaisuuden uudelleen käyttöön.

Kytkin	Ominaisuus
row_title_stats	Explore-rivien nimiketilastot kohdassa Appearance
trakt_lists	Trakt-avain, Trakt-listat ja Trakt-arvostelut. TMDB-listat pysyvät käytössä
alert_channels_more	Telegram-, ntfy-, Gotify-, Pushover- ja webhook-ilmoitukset. Discord ja sähköposti pysyvät käytössä
subtitle_sites	Tekstitysten sivustot ja tekstityshaku. Tekstityskielesi pysyy käytössä
emby_signin	Kirjautuminen Embyllä. Embyn kirjastopäivitys toimii silti
go_back	Paneeli Go back (palaa) sivulla Status. Kohdan Go back vaiheet toimivat ilman sitä

Eikö kytkimen lisäämisen jälkeen tapahtunut mitään? Tarkista kirjoitusasu (pienet kirjaimet, alaviivat) ja käynnistä container uudelleen, älä pelkkää sivua.

Asiantuntijoille

Mitä tarkistus lähettää

Yksi pyyntö osoitteeseen api.github.com uusimman version selvittämiseksi, ja mukana on vain User-Agent: HolyArrs/<version>. Ei tiliä, avainta eikä medialuetteloa. Kun tarkistus on pois päältä, pyyntöjä ei lähde lainkaan.

Viimeisin vastaus tallennetaan, joten uudelleenkäynnistys ei tarkista ennen kuin on sen aika. Yksi tarkistus odottaa enintään 15 s, lukee enintään 512 KB ja seuraa enintään 3 uudelleenohjausta vaihtamatta koskaan http:n ja https:n välillä. Julkaisutietojen linkki näkyy vain, jos se osoittaa HolyArrsin julkaisusivuille GitHubissa; muuten versio näkyy pelkkänä tekstinä.

Release feed hyväksyy GitHub-tyylisen julkaisuvastauksen, julkaisulistan, minkä tahansa JSONin, jossa on version, tai pelkän tekstin, jossa on versio. Pilvipalvelun metadataosoitteet hylätään aina. Testiversio lasketaan vanhemmaksi kuin vastaava tavallinen versio.

Varmuuskopio ennen päivitystä

Ennen tallennettujen tietojen muuttamista HolyArrs:

1. Tarkistaa, että kopiolle ja päivitykselle on tilaa. Jos ei ole, mikään ei muutu. Ohita asetuksella HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Kopioi jokaisen tietokannan kansioon backups, tarkistaa kopion ja kirjoittaa sen viereen sha256-tiedoston. 3 epäonnistuneen kopioinnin jälkeen mikään ei muutu.
3. Ajaa jokaisen päivitysvaiheen erikseen ja tarkistaa sen. Epäonnistunut vaihe perutaan; valmiit vaiheet jäävät. Käynnistä sama versio uudelleen, niin työ jatkuu epäonnistuneesta vaiheesta samalla kopiolla.

Ensimmäisen onnistuneen käynnistyksen jälkeen kopiosta tulee holyarrs-backup-pre-update-<time>.zip, ja sen kuvaus on esimerkiksi “before updating from 1.1.0 to 1.2.0”. Se näkyy kohdassa Settings > Backups (asetukset > varmuuskopiot) ja komennossa holyarrs restore --list. Uusimmat 3 säilytetään; varmuuskopioaikataulu ei poista niitä koskaan. Uusi asennus tai päivitys, joka jättää tiedot ennalleen, ei tee yhtään.

Varmista image

Versiosta 1.0.3 alkaen jokainen Docker Hubin image on allekirjoitettu GitHubin julkaisuajolla. Ladattavaa avainta ei ole. Tarkista image cosignilla. Laita käyttämäsi versio, kuten 1.0.3, kohtaan <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äkyviin pitäisi tulla The cosign claims were validated. Mikä tahansa muu tarkoittaa, ettei image tullut HolyArrsin julkaisuajosta: älä aja sitä.

Imagen mukana on myös tieto siitä, miten se on rakennettu, ja luettelo sen sisällöstä (SBOM). Tarkista ne GitHub CLI:llä:

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

Samat tiedostot ovat jokaisessa GitHub-julkaisussa: .sigstore.json (allekirjoitus), .intoto.jsonl (rakennustiedot) ja .sbom.spdx.json (sisältö).

Aiheesta lisää

• Varmuuskopiot
• Kuntotarkistukset
• Osat ja vikasietotila