AiHummer
Oʻzbekcha▾
KirishShaxsiy kabinet
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Foydalanish/Zaxira nusxalari va ofatlardan tiklash

Zaxira nusxalari va ofatlardan tiklash

v1.0.x · yangilandi 2026-06-26

AiHummerning holati kichik va aniq belgilangan, bu esa zaxira nusxalarini oddiy qiladi — faqat shuni eslab qolishingiz kerakki master kalit ma’lumotlar bazasida mavjud emas va uning o‘zi himoya qilinishi kerak. Ushbu sahifa nima zaxiralash, qanday zaxiralash va qanday tiklash haqida ma’lumot beradi.

Nimani zaxiralash kerak

Himoya qilish uchun uchta mustaqil narsa mavjud:

Nima Qayer Nima uchun
Ma’lumotlar bazasi PostgreSQL Haqiqat manbai — agentlar, suhbatlar, xotira, sozlamalar, shifrlangan sirlar
Bloblardan AIHUMMER_BLOB_DIR Ma’lumotlar bazasi tomonidan tilga olingan media va fayl biriktirmalari
Asosiy kalit AIHUMMER_MASTER_KEY Seifni shifrdan chiqaradi; hech qachon ma’lumotlar bazasida saqlanmagan

[!DANGER] Zaxira nusxasini olish AIHUMMER_MASTER_KEY alohida va uni boshqa joyda saqlang maʼlumotlar bazasi zaxirasi. Xavf saqlash joyi ushbu kalit ostida konvert-shifrlangan — yoʻqotish asosiy kalit va shifrlangan sirlar tiklab bo‘lmaydi, hatto mukammal bilan ma’lumotlar bazasini zaxiralash.

PostgreSQL haqiqat manbai hisoblanadi

Ma’lumotlar bazasini rasmiy manba sifatida ko’ring. Tavsiya etilgan boshlang’ich nuqta kundalik pg_dump pluss Vaqt nuqtasiga qaytarish (PITR) uchun WAL arxivlash shunday qilib, siz dumplar orasidagi istalgan vaqtda oldinga siljishingiz mumkin.

# Daily logical dump
pg_dump "$AIHUMMER_DATABASE_URL" --format=custom --file=aihummer-$(date +%F).dump

Qayta tiklash nuqtalari orasidagi nozik tiklash uchun dump fayllarni uzluksiz WAL arxivlash (PITR) bilan juftlang.

Einshteynning xotirasi ham ma’lumotlar bazasida yashaydi: inson o’qiy oladigan kanonik Markdown (MEMORY.md) va v2 vektor do’koni prognozlar undan olingan, alohida vakolatli manbalar emas.

Bloblarni zaxiralash

Media va fayl biriktirmalari ostida yashaydi AIHUMMER_BLOB_DIR. Bu katalogni ma’lumotlar bazasi bilan birga zaxiralang, shunda tiklangan suhbatlar o’z ilovalarini hal qila oladi. Agar AIHUMMER_BLOB_DIR sozlanmagan, media/fayl xizmati faol emas va nusxalash uchun qo’shimcha hech narsa yo’q.

Aihummer zaxira qilish va tiklash buyruqlari

CLI rutinni ikkita buyruqqa birlashtiradi:

aihummer backup [dir]      # write a backup into [dir]
aihummer restore <file>    # restore from a backup file

Bularni oddiy operatsion zaxiralar va tiklashlar uchun ishlating. Qarang CLI ma’lumotnomasi tegishli buyruqlar uchun.

[!WARNING] Faqat ma’lumotlar bazasini tiklash to’liq tiklash hisoblanmaydi. Blob katalogini ham tiklang, va ishonch hosil qiling xuddi shunday AIHUMMER_MASTER_KEY maqsadli xostda mavjud — aks holda ombor shifrlashdan chiqarib bo‘lmaydi.

Falokatdan tiklanish

To‘liq mezbon yo‘qotish holati uchun, quyidagini bajaring falokatdan tiklanish qo’llanmasi (docs/runbooks/disaster-recovery.md). Tiklash tartibi:

  1. Mezon hostni ta’minlang va shu AiHummer versiyasini o’rnating.
  2. Qayta tiklash asosiy kalit ichiga AIHUMMER_MASTER_KEY.
  3. Qayta tiklash ma’lumotlar bazasi (so‘nggi zaxira, keyin WAL/PITR ishlatilgan bo‘lsa, u orqali oldinga siljiting).
  4. Qayta tiklash blob papkasi da AIHUMMER_BLOB_DIR.
  5. Tiklash modul konfiguratsiyasi va artefaktlar (sozlamalar ma’lumotlar bazasida saqlanadi; zaxira nusxangizdan har qanday modulga xos sozlash fayllarini tiklang).
  6. Qayta tiklash Einshteyn xotira fayllari — MEMORY.md va kanonik Markdown (xotira proyeksiyasi) — ularning katalogiga (yoki ularni qayta qurishga ruxsat berish) ma’lumotlar bazasi).
  7. Agar embedder sidecar ishlatilsa, uni tiklang v2 vektor do’koni (yoki qayta qurish tiklangan ma’lumotlar bazasidan/Markdown) indekslar.
  8. Xizmatlarni ishga tushiring (aihummer up) va tasdiqlash /readyz va deploy/host/smoke.sh.

[!TIP] Shuningdek saqlang AIHUMMER_MEDIA_TOKEN_SECRET ustoz kalitingiz bilan. U imzolangan holda saqlaydi media yuklab olish URL manzillari qayta ishga tushirish va qayta qurishlar davomida ham amal qiladi.

Keyingi qayerga