AiHummer
Eesti▾
SisselogimineKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Tegevused/Varukoopiad ja katastroofi taastamine

Varukoopiad ja katastroofi taastamine

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

AiHummeri olek on väike ja hästi määratletud, mis muudab varukoopiate tegemise lihtsaks — seni, kuni mäletad, et peavõti ei ole andmebaasis ja seda tuleb kaitsta iseseisvalt. See leht käsitleb, mida varundada, kuidas, ja kuidas taastada.

Mida varundada

On kolm sõltumatut asja, mida kaitsta:

Mis Kus Miks
Andmebaas PostgreSQL Tõe allikas — agendid, vestlused, mälu, seaded, krüpteeritud saladused
Laigud AIHUMMER_BLOB_DIR Andmebaasis viidatud meedia ja failimanused
Peavõti AIHUMMER_MASTER_KEY Dekrüpteerib safiiri; pole kunagi andmebaasi salvestatud

[!DANGER] Varunda AIHUMMER_MASTER_KEY eraldi ja hoida seda kusagil mujal kui andmebaasi väljaanne. Keldrit on selle võtme all ümbrikuga krüpteeritud — kaotama peavõti ja krüpteeritud saladused on taastamatud, isegi täiusliku andmebaasi varukoopia.

PostgreSQL on tõe allikas

Käsitle andmebaasi kui autoriteetset. Soovitatud baastaseme on igapäevane pg_dump pluss WAL-i arhiveerimine punkt-aegseks taastamiseks (PITR) nii et saate liikuda ettepoole mis tahes hetke vahel dumpide vahel.

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

Ühenda dumpid pideva WAL-aruvi arhiivimisega (PITR), et võimaldada detailset taastamist hetktõmmiste vahel.

Einsteini mälestus elab ka andmebaasis: inimloetav kanoniline Markdown (MEMORY.md) ja v2 vektoripood on prognoosid tulenevad sellest, mitte eraldiseisvatest autoriteetsetest allikatest.

Blobide varundamine

Meedia ja faili manused asuvad siin AIHUMMER_BLOB_DIR. Varundage see kataloog koos andmebaasiga, et taastatud vestlused saaksid endiselt oma manuseid kasutada. Kui AIHUMMER_BLOB_DIR ei ole konfigureeritud, meedia/faili teenus ei ole aktiivne ja midagi lisaks kopeerida pole.

Aihummeri varundamise ja taastamise käsud

CLI pakib rutiini kaheks käsuks:

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

Kasutage neid tavapäraste operatiivsete varukoopiate tegemiseks ja taastamiseks. Vaadake CLI viide seotud käskude jaoks.

[!WARNING] Ainult andmebaasi taastamine ei ole täielik taastumine. Taastage ka blob-kataloog. ja veendu, et sama AIHUMMER_MASTER_KEY on kohal sihtmasinas — Vastasel juhul ei saa ladu dekrüpteerida.

Katastroofi taastamine

Täieliku hostikahjumi stsenaariumi puhul järgige katastroofi taastamise käsiraamat (docs/runbooks/disaster-recovery.md). Taastamiskorras on:

  1. Pakkuge host ja installige sama AiHummeri versioon.
  2. Taasta peavõti sisse AIHUMMER_MASTER_KEY.
  3. Taasta andmebaas (viimane dump, seejärel liigu edasi WAL/PITR kaudu, kui kasutatakse).
  4. Taasta blobide kataloog juures AIHUMMER_BLOB_DIR.
  5. Taasta mooduli seadistus ja artefaktid (seaded elavad andmebaasis; taastage kõik moodulispetsiifilised konfiguratsioonifailid oma varukoopiast).
  6. Taasta Einsteini mälufailid — MEMORY.md ja kanoniline Markdown (mäluprojektsioon) — nende kataloogi (või lase neil uuesti üles ehitada alates andmebaas).
  7. Kui kasutatakse embedderi kõrvalprotsessi, taastage v2 vektoripood (või ehitada uuesti taastatud andmebaasi/Markdowni indeksid).
  8. Tõsta teenused üles (aihummer up) ja kinnitage /readyz ja deploy/host/smoke.sh.

[!TIP] Samuti hoia AIHUMMER_MEDIA_TOKEN_SECRET oma peavõtmega. See hoiab allkirjastatud meediumi allalaadimise URL-id kehtivad taaskäivitatud ja uuesti ehitatud seadmete puhul.

Kuhu järgmine