עדכונים

חדש כאן

HolyArrs אומר לך כשיוצאת גרסה חדשה, ואף פעם לא מתקין אותה בעצמו. אתה מושך את האימג’ החדש (image) מתי שנוח לך.

לראות אם יצאה גרסה חדשה

פתח את הדף Status (מצב) (http://your-server:6262/health).
קרא את Updates (עדכונים). אתה אמור לראות אחת מההודעות האלה:

הודעה	משמעות
“HolyArrs 1.2.0 is out, newer than this one.”	אפשר לעדכן כשנוח
“This is the newest version.”	אין מה לעשות
“No HolyArrs release is published yet.”	ה-feed ריק. שום דבר לא תקול
“The last check did not work: …”	אין גישה ל-feed, לרוב כי אין אינטרנט
“The update check is off: …”	כובה בהגדרות

כדי לבדוק עכשיו, לחץ על Check now (בדוק עכשיו) (או Check again). צריך לשם כך את ההרשאה Change settings (שינוי הגדרות).

גרסה חדשה מופיעה גם כאזהרת תקינות. בדיקה שנכשלה מופיעה רק תחת Updates.

לעדכן

משוך את האימג’ החדש והפעל מחדש: docker compose pull, ואחר כך docker compose up -d.
HolyArrs עולה. אם הגרסה החדשה משנה את דרך שמירת הנתונים, הוא עושה קודם גיבוי ורק אז מעדכן את הנתונים. אתה אמור לראות את האפליקציה נפתחת על הגרסה החדשה.

לחזור לגרסה הקודמת

HolyArrs לא יכול להחליף את האימג’ של עצמו, אז אתה מריץ את האימג’ הישן, ו-HolyArrs מחזיר את הנתונים הישנים.

שנה את התגית של האימג’ בקובץ ה-compose שלך (או ב-docker run) לגרסה הישנה, למשל holyarrs/holyarrs:<older version>.
הרץ docker compose up -d.
אם העדכון לא שינה את הנתונים, הגרסה הישנה עולה. סיימת.
אחרת הגרסה הישנה מציגה דף במקום האפליקציה. לחץ על Put back the data from before the update (החזר את הנתונים מלפני העדכון).
הקלד את הקוד החד-פעמי. אפשר למצוא אותו עם docker logs <container>; חפש “one-time code”.
HolyArrs בודק את הגיבוי, מחזיר אותו למקומו ונעצר. אתה אמור לראות את הקונטיינר עולה שוב על הנתונים האלה בזכות מדיניות ההפעלה מחדש שלו. בלי מדיניות כזו, הפעל אותו בעצמך.

בלי הדף: docker exec <container> /holyarrs restore --pre-update, ואחר כך docker restart <container>. בלי Docker: עצור את HolyArrs, הרץ holyarrs restore --pre-update והפעל אותו.

שום דבר לא נמחק. הנתונים החדשים יותר עוברים ל-backups/before-restore-<time>/, כך שאפשר לבטל. כשחוזרים יותר מגרסה אחת אחורה, נבחר הגיבוי האחרון שלפני עדכון שהגרסה הזו יכולה לקרוא.

אפשרויות

הכול ב-Settings > Health checks (הגדרות > בדיקות תקינות). שלוש האחרונות נמצאות בחלק המתקדם של הכרטיס.

הגדרה	ברירת מחדל	מתי לשנות
Check for a newer HolyArrs	On	אתה לא רוצה שום בקשה החוצה
Check for updates every	day	אתה רוצה פחות בדיקות: 3, 7, 14 או 30 ימים
Release feed	ריק (גרסאות של HolyArrs)	אתה מארח feed משלך
Feed may be on the local network	Off	ה-feed שלך נמצא ברשת שלך
Include test versions (like 1.2.0-rc1)	Off	אתה רוצה הודעות על גרסאות בדיקה

אם זה לא עובד

תסמין: “The last check did not work.” סיבה: לשרת אין אינטרנט, או שה-feed שלך נמצא ברשת המקומית. פתרון: בדוק שיש גישה לאינטרנט, או הפעל את Feed may be on the local network.

תסמין: ה-release feed לא נשמר. סיבה: הכתובת כוללת שם משתמש, סיסמה, ?query או #fragment, או שהיא לא מתחילה ב-http:// או ב-https://. פתרון: הסר את החלקים האלה.

תסמין: העדכון נעצר בגלל חוסר מקום בדיסק. סיבה: אין מקום להעתק ולעדכון. פתרון: פנה מקום במקום שבו נמצאת תיקיית ההגדרות, ואז הפעל שוב.

תסמין: דף החזרה לגרסה הקודמת דוחה את הקוד שלך. סיבה: קוד ישן, או 10 קודים שגויים מאז ההפעלה האחרונה. פתרון: העתק את הקוד משורת הלוג החדשה ביותר. אחרי 10 ניסיונות שגויים, הפעל מחדש את הקונטיינר והשתמש בקוד החדש.

יכולות שמורות

כמה יכולות כבויות כברירת מחדל בגרסה הזו. אתה יכול להפעיל אותן על אחריותך. כל עוד הן שמורות, הדפים ופריטי התפריט שלהן מוסתרים, נתיבי ה-API שלהן עונים “not found” והמשימות שלהן לא רצות. נתונים ששמרת עבורן נשארים.

כדי להפעיל אחת, הוסף את המתג שלה ל-HOLYARRS_FLAGS, מופרדים בפסיקים, והפעל מחדש את הקונטיינר:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

כדי לכבות, הסר את השם והפעל מחדש. הגדרות מוסתרות חוזרות כשמפעילים שוב.

מתג	יכולת
`row_title_stats`	סטטיסטיקות כותרים בשורות של Explore, ב-Appearance
`trakt_lists`	מפתח Trakt, רשימות Trakt וביקורות Trakt. רשימות TMDB נשארות פעילות
`alert_channels_more`	התראות ב-Telegram, ntfy, Gotify, Pushover וב-webhook. Discord ואימייל נשארים פעילים
`subtitle_sites`	אתרי כתוביות וחיפוש כתוביות. שפת הכתוביות שלך נשארת פעילה
`emby_signin`	התחברות עם Emby. רענון ספריית Emby עדיין עובד
`go_back`	הלוח Go back בדף Status. השלבים ב-לחזור לגרסה הקודמת עובדים גם בלעדיו

הוספת מתג לא שינתה כלום? בדוק את האיות (אותיות קטנות, קווים תחתונים) והפעל מחדש את הקונטיינר, לא רק את הדף.

למומחים

מה הבדיקה שולחת

בקשה אחת ל-api.github.com לגרסה החדשה ביותר, עם User-Agent: HolyArrs/<version> בלבד. בלי חשבון, בלי מפתח ובלי רשימת מדיה. כשהבדיקה כבויה, אין שום בקשה.

התשובה האחרונה נשמרת, כך שהפעלה מחדש לא בודקת לפני הזמן. בדיקה אחת ממתינה 15 שניות לכל היותר, קוראת עד 512 KB ועוקבת אחרי 3 הפניות לכל היותר, בלי לעבור בין http ל-https. קישור להערות הגרסה מופיע רק כשהוא מצביע לדפי הגרסאות של HolyArrs ב-GitHub; אחרת הגרסה מוצגת כטקסט רגיל.

Release feed מקבל תשובת גרסה בסגנון GitHub, רשימת גרסאות, כל JSON עם version, או טקסט פשוט שמכיל את הגרסה. כתובות של מטא-דאטה בענן תמיד נדחות. גרסת בדיקה נחשבת ישנה יותר מהגרסה הרגילה.

הגיבוי לפני עדכון

לפני שינוי בנתונים השמורים, HolyArrs:

בודק שיש מקום להעתק ולעדכון. אם אין, שום דבר לא משתנה. אפשר לדלג על הבדיקה עם HOLYARRS_SKIP_SPACE_CHECK=yes.
מעתיק כל מסד נתונים ל-backups, בודק את ההעתק וכותב לידו קובץ sha256. אחרי 3 העתקות שנכשלו, שום דבר לא משתנה.
מריץ כל שלב עדכון בנפרד ובודק אותו. שלב שנכשל מבוטל; שלבים שהסתיימו נשארים. הפעל שוב את אותה גרסה כדי להמשיך מהשלב שנכשל עם אותו העתק.

אחרי ההפעלה התקינה הראשונה ההעתק הופך ל-holyarrs-backup-pre-update-<time>.zip, עם תיאור כמו “before updating from 1.1.0 to 1.2.0”. הוא מופיע ב-Settings > Backups וב-holyarrs restore --list. 3 החדשים ביותר נשמרים; לוח הזמנים של הגיבוי אף פעם לא מסיר אותם. התקנה חדשה או עדכון שלא נוגע בנתונים לא יוצרים גיבוי כזה.

לאמת את האימג'

מגרסה 1.0.3 ואילך, כל אימג’ ב-Docker Hub חתום על ידי ריצת הגרסה ב-GitHub. אין מפתח להורדה. בדוק אימג’ עם cosign. שים את הגרסה שאתה מריץ, כמו 1.0.3, במקום שכתוב בו <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)$'

אתה אמור לראות The cosign claims were validated. כל תוצאה אחרת אומרת שהאימג’ לא הגיע מריצת הגרסה של HolyArrs: אל תריץ אותו.

האימג’ נושא גם רישום של אופן הבנייה שלו ורשימה של מה שיש בתוכו (SBOM). בדוק אותם עם ה-GitHub CLI:

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

אותם קבצים נמצאים בכל גרסה ב-GitHub: .sigstore.json (חתימה), .intoto.jsonl (רישום הבנייה) ו-.sbom.spdx.json (התוכן).

קשור

HolyArrs חינמי. אם זה חסך לך זמן, תן לו כוכב ב-GitHub, תמוך בפרויקט או קנה לי קפה.