8feea123bb
* feat(docs): mirror every docs/ page in all 65 locales Extends the documentation mirrors from the 22-page core set (#13940) to every Markdown page under docs/: 152 sources x 65 locales = 9,880 mirrors (6,208 new), language bars rewritten for the full locale list, state adopted so the blocking drift gate now covers all 152 pages. run-translation.mjs: an oversized block made only of table rows or list items (PROVIDER_REFERENCE.md 244-row table, FREE_TIERS.md 71-item list) is cut at item boundaries and rejoined without a blank line — the single 16-40 KB request outlived the backend socket for verbose scripts. 48 older mirrors whose tables had lost rows were retranslated with --force. * docs(i18n): refresh mirrors for the sources the base changed since the branch cut Section-level retranslation of the 29 docs (and README.md) whose source or mirrors moved on release/v3.8.51 during the run, then state adoption; the drift gate is green again on the merged tree.
9.1 KiB
SQLite Runtime Resolution (עברית)
🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW
OmniRoute מאתר את מנהל ההתקן של SQLite בעת ההפעלה באמצעות שרשרת גיבוי בת 5 שלבים:
-
better-sqlite3המצורף (דרךdependenciesב-package.json) — המהיר ביותר, קובץ בינארי מקורי, המותקן על ידיnpm installכאשר כלי בנייה זמינים. -
better-sqlite3המותקן בזמן ריצה (בתוך~/.omniroute/runtime/) — מותקן באופן עצל בעת ההפעלה הראשונה או על ידיscripts/build/postinstall.mjs → scripts/postinstall.mjs. לפני הטעינה, מתבצע אימות של בתי הקסם בקובץ.nodeהמקורי (ELF / Mach-O / PE) כדי להגן מפני קבצים בינאריים פגומים או כאלה שנבנו לפלטפורמה שגויה. -
node:sqlite(הספרייה הסטנדרטית של Node ≥22.5) — אינו דורש בנייה מקורית; משמש כאשר שני הנתיבים של better-sqlite3 נכשלים. ערכת תכונות מוגבלת. -
sql.js(WASM) — אפשרות הגיבוי האחרונה. פועל בכל מקום, אך איטי יותר וכותב נתונים במרווחי זמן במקום באופן סינכרוני.
מדוע נדרשת המורכבות הזו?
- Windows EBUSY: הפקודה
npm install -g omniroute@latestעלולה להיכשל אם הקובץbetter_sqlite3.nodeשל הגרסה הקודמת נעול על ידי תהליך פעיל. ההתקנה בזמן ריצה בתוך~/.omniroute/runtime/עוקפת את המטמון הגלובלי של npm. - אין כלי בנייה: סביבות מסוימות (Windows ארגוני ללא VS Build
Tools, תמונות Docker מינימליות) אינן יכולות להדר את
better-sqlite3. מתקין זמן הריצה מאתר קובץ בינארי שנבנה מראש במאגר npm; מנהלי ההתקן החלופיים מבטיחים ש-OmniRoute עדיין יופעל גם אם פעולה זו נכשלת. - מערכות מבודדות מהרשת: אם מאגר npm אינו נגיש,
node:sqliteאוsql.jsמבטיחים פונקציונליות בסיסית.
אימות בתי קסם
לפני טעינת קובץ .node שהותקן בזמן ריצה, OmniRoute קורא את 8 הבתים
הראשונים ומשווה אותם לערכי הקסם המוכרים של הפלטפורמות:
| פלטפורמה | בתים (הקסדצימלי) | תווית |
|---|---|---|
| Linux | 7F 45 4C 46 |
elf |
| macOS 64-bit BE | FE ED FA CF |
macho |
| macOS 64-bit LE | CF FA ED FE |
macho-le |
| macOS fat (אוניברסלי) | CA FE BA BE |
macho-fat |
| Windows | 4D 5A (MZ) |
pe |
ערך קסם שאינו תואם → המערכת מתעלמת מהקובץ וממשיכה לשלב הגיבוי הבא.
בדיקת מנהל ההתקן הפעיל
import { getDriverInfo } from "@/lib/db/core";
const info = getDriverInfo();
// { source: "bundled" | "runtime" | "runtime-installed-now" | "node-sqlite" | "sql-js",
// kind: "better-sqlite3" | "node-sqlite" | "sql-js" }
שליטה ידנית
# דילוג על החימום שלאחר ההתקנה (להתקנות CI מהירות)
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute
# התקנה מחדש בכפייה של better-sqlite3 בזמן ריצה
rm -rf ~/.omniroute/runtime
omniroute # יותקן מחדש בהפעלה הבאה
# בדיקת מנהל ההתקן הפעיל
omniroute config db-info # (אם פקודת ה-CLI קיימת)
חומר עזר
מימוש:
bin/cli/runtime/magicBytes.mjs— פונקציות עזר לאימות בתי קסם של קבצים בינארייםbin/cli/runtime/sqliteRuntime.mjs— מאתר בזמן ריצה בן 5 שלבים + מתקין עצלbin/cli/runtime/index.mjs— מתזמר ההפעלה (warmUpRuntimes())scripts/postinstall.mjs— נקודת חיבור לאחר התקנת npm (חימום שאינו גורם לכשל)src/lib/db/core.ts— ייצוא שלensureDbInitialized()/getDriverInfo()
טופולוגיה עם כותב יחיד (אין תמיכה בזמינות גבוהה)
שרשרת מנהלי ההתקן החלופיים שלעיל עדיין פועלת בתוך תהליך אחד. בתצורת ברירת המחדל של SQLite, OmniRoute הוא כותב יחיד:
- אין לחבר שני עותקים של OmniRoute לאותו קובץ
storage.sqlite. - הפעלה מחדש של קונטיינר, פריסה מסוג Recreate, סיום בשל OOM או הפעלה מחדש עקב HEALTHCHECK מפילים כל הפעלת SSE שמתבצעת באותו רגע. בנתיב הסטנדרטי אין ניקוז של הפעלות.
- בדיקת חיות של המתזמר שמתייחסת לתגובה איטית של
/healthzכאילו השירות מת תחסל את העותק היחיד. מומלץ להשתמש בבדיקת חיות באמצעות TCP + בדיקת מוכנות באמצעות HTTP/healthz. ראו מדריך Docker — זמינות וכן המלצות לבדיקות Kubernetes.