Ehtiyat nüsxələr və fəlakət bərpası

v1.2.x · yeniləndi 2026-06-26

AiHummer-in vəziyyəti kiçik və yaxşı müəyyən olunub, bu da ehtiyat nüsxələrini sadə edir — belə ki, xatırlamaq kifayətdir ki əsas açar bazada yoxdur və öz-özünə qorunmalıdır. Bu səhifə nələri ehtiyat nüsxələməli, necə etməli və necə bərpa etməli olduğunuzu əhatə edir.

Nəyi ehtiyat nüsxə etmək

Müdafiə ediləcək üç müstəqil şey var:

Nə	Harada	Niyə
Verilənlər bazası	PostgreSQL	Həqiqətin mənbəyi — agentlər, söhbətlər, yaddaş, parametrlər, şifrələnmiş sirlər
Ləkələr	`AIHUMMER_BLOB_DIR`	Verilənlər bazası tərəfindən istinad olunan media və fayl əlavələri
Əsas açar	`AIHUMMER_MASTER_KEY`	Kassanı deşifrə edir; heç vaxt verilənlər bazasında saxlanılmayıb

[!DANGER] Ehtiyat nüsxə AIHUMMER_MASTER_KEY ayrılıqda və onu başqa bir yerdə saxlayın verilənlər bazasının çıxarışı. Qala bu açar altında zərf-şifrələnmişdir — itirmək əsas açar və şifrələnmiş sirləri bərpa etmək mümkün deyil, hətta mükəmməl olarkən belə verilənlər bazasının ehtiyat nüsxəsi.

PostgreSQL həqiqətin mənbəyidir

Verilənlər bazasını səlahiyyətli kimi qəbul edin. Tövsiyə olunan baza xətti gündəlik pg_dump plus Nöqtə-vaxt bərpası (PITR) üçün WAL arxivləşdirməsi beləliklə, siz tökülmələr arasındakı istənilən vaxta irəliləyə bilərsiniz.

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

Yedəkləri fasiləsiz WAL arxivləşdirmə (PITR) ilə cütləşdirin ki, şəkillər arasında incə tənzimlənmiş bərpa mümkün olsun.

Einşteynin yaddaşı da verilənlər bazasında yaşayır: insan tərəfindən oxuna bilən kanonik Markdown (MEMORY.md) və v2 vektor mağazası proqnozlar ondan törədilmiş, ayrıca səlahiyyətli mağazalar deyil.

Blobları ehtiyat nüsxələmək

Media və fayl əlavələri altında yaşayır AIHUMMER_BLOB_DIR. Bu qovluğu verilənlər bazası ilə birlikdə yedəkləyin ki, bərpa edilmiş söhbətlər hələ də onların əlavələrini həll edə bilsin. Əgər AIHUMMER_BLOB_DIR quraşdırılmayıb, media/fayl xidməti aktiv deyil və kopyalamaq üçün əlavə heç nə yoxdur.

Aihummer ehtiyat nüsxə və bərpa əmrləri

CLI rutini iki əmri birləşdirir:

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

Bunlardan adi əməliyyat ehtiyat nüsxələri və bərpa üçün istifadə edin. Baxın CLI istinadı müvafiq əmrlər üçün.

[!WARNING] Yalnız verilənlər bazasının bərpası tam bərpa deyil. Blob qovluğunu da bərpa edin, və əmin olun ki eyni AIHUMMER_MASTER_KEY hədəf hostda mövcuddur — Əks halda, kassanı deşifrə etmək mümkün olmayacaq.

Fəlakətdən bərpa

Tam host itki ssenarisi üçün, izləyin fəlakətdən-bərpa əməliyyat kitabçası (docs/runbooks/disaster-recovery.md). Bərpa əmri belədir:

Bir host təmin edin və eyni AiHummer versiyasını quraşdırın.
Bərpa et əsas açar içinə AIHUMMER_MASTER_KEY.
Bərpa et verilənlər bazası (ən son yedək, sonra istifadə olunubsa WAL/PITR vasitəsilə irəli çevirin).
Bərpa et blob kataloqu at AIHUMMER_BLOB_DIR.
Bərpa et modul konfiqurasiyası və artefaktlar (ayarlar verilənlər bazasında saxlanılır; backup-dan hər hansı modul-spesifik konfiqurasiya fayllarını bərpa edin).
Bərpa et Einşteyn yaddaş faylları — MEMORY.md və canonical Markdown (yaddaş proyeksiyası) — onların kataloquna (və ya onları yenidən qurmağa icazə verin verilənlər bazası).
Əgər yerləşdirici yanında tərəf istifadə olunursa, bərpa edin v2 vektor mağazası (və ya yenidən qur) bərpa edilmiş verilənlər bazasından/Markdown sənədindən indekslər).
Xidmətləri işə sal (aihummer up) və ilə təsdiqləyin /readyz və deploy/host/smoke.sh.

[!TIP] Həm də saxla AIHUMMER_MEDIA_TOKEN_SECRET əsas açarınızla. İmzalanmış qalır media yükləmə URL-ləri yenidən başladıqdan və yenidən qurduqdan sonra da etibarlıdır.

Növbəti haradır

Bərpa edilməni yoxlamaq üçün istifadə olunan prob və tüstü testi: systemd və sağlamlıq yoxlamaları.
Yeniləmə zamanı versiyalaşma və miqrasiyalar: Yeniləmə siyasəti.