Atjauninājumi

HolyArrs pasaka, kad iznākusi jauna versija, un nekad to neuzstāda pats. Jauno attēlu (image) ielādē, kad tev ir ērti.

Pārbaudi, vai ir jauna versija

1. Atver lapu Status (statuss) (http://your-server:6262/health).
2. Izlasi Updates (atjauninājumi). Tev vajadzētu redzēt vienu no šiem:

Ziņojums	Nozīme
“HolyArrs 1.2.0 is out, newer than this one.”	Atjaunini, kad esi gatavs
“This is the newest version.”	Nekas nav jādara
“No HolyArrs release is published yet.”	Feed ir tukšs. Nekas nav salauzts
“The last check did not work: …”	Feed nav sasniedzams, bieži vien nav interneta
“The update check is off: …”	Izslēgts iestatījumos

3. Lai pajautātu tūlīt, noklikšķini uz Check now (pārbaudīt tagad) (vai Check again (pārbaudīt vēlreiz)). Tam vajadzīga atļauja Change settings (mainīt iestatījumus).

Jaunāka versija parādās arī kā veselības brīdinājums. Neizdevusies pārbaude redzama tikai sadaļā Updates.

Atjaunini

1. Ielādē jauno attēlu un restartē: docker compose pull, tad docker compose up -d.
2. HolyArrs palaižas. Ja jaunā versija maina datu glabāšanu, tā vispirms izveido dublējumu, tad atjaunina datus. Tev vajadzētu redzēt, ka lietotne atveras jaunajā versijā.

Padoms

Neizdevies atjaunināšanas solis tiek atcelts, un HolyArrs apstājas lapā, kas pasaka, kas notika. Tavi dati no pirms atjauninājuma paliek kā dublējums.

Atgriezies pie iepriekšējās versijas

HolyArrs nevar mainīt savu attēlu, tāpēc tu palaid iepriekšējo attēlu, un HolyArrs ieliek atpakaļ iepriekšējos datus.

Uzmanību

Viss, kas mainīts pēc atjauninājuma, piemēram, jauni nosaukumi, iestatījumi un vēsture, nav dublējumā pirms atjauninājuma.

1. Savā compose failā (vai docker run) nomaini attēla birku uz iepriekšējo, piemēram, holyarrs/holyarrs:<older version>.
2. Izpildi docker compose up -d.
3. Ja atjauninājums datus nemainīja, palaižas iepriekšējā versija. Esi pabeidzis.
4. Pretējā gadījumā iepriekšējā versija lietotnes vietā rāda lapu. Noklikšķini uz Put back the data from before the update (atjaunot datus no pirms atjauninājuma).
5. Ieraksti vienreizējo kodu. Atrodi to ar docker logs <container>; meklē “one-time code”.
6. HolyArrs pārbauda dublējumu, ieliek to vietā un apstājas. Tev vajadzētu redzēt, ka konteiners no jauna palaižas ar šiem datiem, pateicoties savai restartēšanas politikai. Ja tās nav, palaid to pats.

Bez lapas: docker exec <container> /holyarrs restore --pre-update, tad docker restart <container>. Bez Docker: aptur HolyArrs, izpildi holyarrs restore --pre-update, palaid to.

Nekas netiek dzēsts. Jaunākie dati pārvietojas uz backups/before-restore-<time>/, tāpēc vari atcelt. Ja atgriezies vairāk nekā par vienu versiju, tiek izvēlēts jaunākais dublējums pirms atjauninājuma, ko šī versija spēj nolasīt.

Izvēles

Viss atrodas sadaļā Settings > Health checks (Iestatījumi > Veselības pārbaudes). Pēdējie trīs ir kartītes paplašinātajā daļā.

Iestatījums	Noklusējums	Maini, kad
Check for a newer HolyArrs (pārbaudīt, vai ir jaunāks HolyArrs)	Ieslēgts	Tu negribi nevienu ārēju pieprasījumu
Check for updates every (pārbaudīt atjauninājumus ik pēc)	diena	Tu gribi retākas pārbaudes: 3, 7, 14 vai 30 dienas
Release feed (versiju feed)	Tukšs (HolyArrs versijas)	Tu uztur savu feed
Feed may be on the local network (feed drīkst būt vietējā tīklā)	Izslēgts	Tavs feed ir tavā tīklā
Include test versions (like 1.2.0-rc1) (iekļaut testa versijas)	Izslēgts	Tu gribi paziņojumus par testa versijām

Ja tas nedarbojas

Simptoms: “The last check did not work.” Cēlonis: serverim nav interneta, vai tavs feed atrodas vietējā tīklā. Risinājums: pārbaudi interneta piekļuvi vai ieslēdz Feed may be on the local network.

Simptoms: versiju feed nesaglabājas. Cēlonis: adresē ir vārds, parole, ?query vai #fragment, vai tā nesākas ar http:// vai https://. Risinājums: noņem šīs daļas.

Simptoms: atjauninājums apstājās brīvas vietas trūkuma dēļ. Cēlonis: nav vietas kopijai un atjauninājumam. Risinājums: atbrīvo vietu tur, kur atrodas konfigurācijas mape, un palaid vēlreiz.

Simptoms: atgriešanās lapa noraida tavu kodu. Cēlonis: vecs kods, vai 10 nepareizi kodi kopš pēdējās palaišanas. Risinājums: nokopē kodu no jaunākās žurnāla rindas. Pēc 10 nepareiziem mēģinājumiem restartē konteineru un izmanto jauno kodu.

Aizturētās funkcijas

Dažas funkcijas šajā versijā pēc noklusējuma ir izslēgtas. Ieslēdz tās uz savu risku. Kamēr tās ir aizturētas, to lapas un izvēlnes vienumi ir paslēpti, to API maršruti atbild “not found” un to uzdevumi nedarbojas. Dati, ko esi tām saglabājis, paliek.

Lai vienu ieslēgtu, pievieno tās slēdzi pie HOLYARRS_FLAGS, atdalot ar komatiem, un restartē konteineru:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Lai izslēgtu, noņem nosaukumu un restartē. Paslēptie iestatījumi atgriežas, kad ieslēdz atkal.

Slēdzis	Funkcija
row_title_stats	Izpētes rindu nosaukumu statistika sadaļā Appearance (izskats)
trakt_lists	Trakt atslēga, Trakt saraksti un Trakt atsauksmes. TMDB saraksti paliek ieslēgti
alert_channels_more	Telegram, ntfy, Gotify, Pushover un webhook paziņojumi. Discord un e-pasts paliek ieslēgti
subtitle_sites	Subtitru vietnes un subtitru meklēšana. Tava subtitru valoda paliek ieslēgta
emby_signin	Pieteikšanās ar Emby. Emby bibliotēkas atsvaidzināšana joprojām darbojas
go_back	Panelis Go back (atgriezties) lapā Status. Soļi sadaļā Go back darbojas arī bez tā

Pēc slēdža pievienošanas nekas nemainījās? Pārbaudi pareizrakstību (mazie burti, pasvītras) un restartē konteineru, ne tikai lapu.

Pieredzējušiem

Ko sūta pārbaude

Viens pieprasījums uz api.github.com pēc jaunākās versijas, ar vienīgo galveni User-Agent: HolyArrs/<version>. Bez konta, atslēgas vai multivides saraksta. Ja pārbaude ir izslēgta, pieprasījuma nav vispār.

Pēdējā atbilde tiek saglabāta, tāpēc restartēšana nepārbauda pirms laika. Viena pārbaude gaida ne ilgāk par 15 s, nolasa ne vairāk par 512 KB un seko ne vairāk par 3 pāradresācijām, nekad nepārslēdzoties starp http un https. Saite uz versijas piezīmēm parādās tikai tad, ja tā ved uz HolyArrs versiju lapām GitHub; citādi versija tiek rādīta kā vienkāršs teksts.

Release feed pieņem GitHub veida versijas atbildi, versiju sarakstu, jebkuru JSON ar version vai vienkāršu tekstu ar versiju. Mākoņa metadatu adreses vienmēr tiek noraidītas. Testa versija tiek uzskatīta par vecāku nekā parastā versija.

Dublējums pirms atjauninājuma

Pirms maina glabātos datus, HolyArrs:

1. Pārbauda, vai ir vieta kopijai un atjauninājumam. Ja nav, nekas nemainās. Izlaid ar HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Nokopē katru datubāzi uz backups, pārbauda kopiju un blakus ieraksta sha256 failu. Pēc 3 neveiksmīgām kopijām nekas nemainās.
3. Izpilda katru atjaunināšanas soli atsevišķi un to pārbauda. Neizdevies solis tiek atcelts; pabeigtie soļi paliek. Palaid to pašu versiju vēlreiz, lai turpinātu no neizdevušā soļa ar to pašu kopiju.

Pēc pirmās sekmīgās palaišanas kopija kļūst par holyarrs-backup-pre-update-<time>.zip, ar aprakstu, piemēram, “before updating from 1.1.0 to 1.2.0”. Tā redzama sadaļā Settings > Backups (Iestatījumi > Dublējumi) un holyarrs restore --list. Tiek paturēti jaunākie 3; dublēšanas grafiks tos nekad neizdzēš. Jauna uzstādīšana vai atjauninājums, kas datus neaiztiek, tādu neveido.

Pārbaudi attēlu

Sākot ar 1.0.3, katru attēlu Docker Hub paraksta versijas izlaišanas darbs GitHub. Nav jālejupielādē nekāda atslēga. Pārbaudi attēlu ar cosign. Ieraksti versiju, ko palaid, piemēram, 1.0.3, tur, kur rakstīts <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)$'

Tev vajadzētu redzēt The cosign claims were validated. Jebkas cits nozīmē, ka attēls nav nācis no HolyArrs versijas izlaišanas darba: nepalaid to.

Attēlam līdzi ir arī ieraksts par to, kā tas būvēts, un saraksts ar to, kas tajā atrodas (SBOM). Pārbaudi tos ar GitHub CLI:

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

Tie paši faili ir pie katras GitHub versijas: .sigstore.json (paraksts), .intoto.jsonl (būvēšanas ieraksts) un .sbom.spdx.json (saturs).

Saistītais

• Dublējumi
• Veselības pārbaudes
• Daļas un drošais režīms