AiHummer
Suomi▾
Kirjaudu sisäänTili
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Toiminnot/Varmuuskopiot ja katastrofipalautus

Varmuuskopiot ja katastrofipalautus

v1.0.x · päivitetty 2026-06-26

AiHummerin tila on pieni ja hyvin määritelty, mikä tekee varmuuskopioista suoraviivaisia — kunhan muistat, että pääavain ei ole tietokannassa ja sitä on suojattava itsenäisesti. Tämä sivu käsittelee, mitä varmuuskopioida, kuinka ja kuinka palauttaa.

Mitä varmuuskopioida

On kolme itsenäistä asiaa suojeltavana:

Mitä Missä Miksi
Tietokanta PostgreSQL Totuuden lähde — agentit, keskustelut, muisti, asetukset, salatut salaisuudet
Tölkyt AIHUMMER_BLOB_DIR Tietokannan viittaamat media- ja tiedostoliitteet
Pääavain AIHUMMER_MASTER_KEY Salakirjoittaa holvin; ei koskaan tallennettu tietokantaan

[!DANGER] Varmuuskopioida AIHUMMER_MASTER_KEY erikseen ja säilytä se jossain muualla kuin tietokantadumppi. Holvi on kirjekuoriin salattu tämän avaimen alla — menettää pääavain ja salatut salaisuudet ovat palautumattomia, jopa täydellisen kanssa tietokannan varmuuskopio.

PostgreSQL on totuuden lähde

Kohtele tietokantaa auktoriteettina. Suositeltu perusta on päivittäinen pg_dump plus WAL-arkistointi pisteaikapalautusta (PITR) varten joten voit siirtyä eteenpäin mihin tahansa hetkeen romahdusten välillä.

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

Yhdistä varmuuskopiot jatkuvaan WAL-arkistointiin (PITR) tarkkaan palautukseen tilannevedosten välillä.

Einsteinin muisti elää myös tietokannassa: ihmisen luettavissa oleva kanoninen Markdown (MEMORY.md) ja v2-vektorivarasto ovat ennusteet josta se on johdettu, ei erillisistä auktoriteettisista lähteistä.

Varmuuskopioidaan lohkot

Media ja tiedostoliitteet sijaitsevat alla AIHUMMER_BLOB_DIR. Varmuuskopioi tämä hakemisto yhdessä tietokannan kanssa, jotta palautetut keskustelut voivat edelleen käsitellä liitteensä. Jos AIHUMMER_BLOB_DIR ei ole määritetty, media/tiedostopalvelu ei ole aktiivinen eikä ole mitään ylimääräistä kopioitavaa.

Aihummer-varmuuskopiointi- ja palautuskomennot

Komentoriviliittymä paketoi rutiinin kahteen komentoon:

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

Käytä näitä tavallisiin toiminnallisiin varmuuskopioihin ja palautuksiin. Katso CLI-viite liittyville komennoille.

[!WARNING] Pelkkä tietokannan palautus ei ole täydellinen palautus. Palauta myös blob-hakemisto. ja varmista, että sama AIHUMMER_MASTER_KEY on läsnä kohdekoneessa — muuten holvia ei voi purkaa salauksesta.

Kriisinhallinta

Täydellisen isäntähäviötilanteen osalta seuraa katastrofipalautuksen toimintakäsikirja (docs/runbooks/disaster-recovery.md). Palautusjärjestys on:

  1. Hanki isäntä ja asenna sama AiHummer-versio.
  2. Palauta pääavain sisään AIHUMMER_MASTER_KEY.
  3. Palauta tietokanta (uusin varmuuskopiointi, sitten eteneminen WAL:n/PITR:n avulla, jos käytetty).
  4. Palauta lohkohakemisto luona AIHUMMER_BLOB_DIR.
  5. Palauta moduulin määritykset ja artefaktit (asetukset sijaitsevat tietokannassa; palauta kaikki moduulikohtaiset konfiguraatiotiedostot varmuuskopiostasi).
  6. Palauta Einsteinin muistiedostot — MEMORY.md ja kaanoninen Markdown (muistiprojektio) — heidän hakemistoonsa (tai anna niiden rakentua uudelleen) tietokanta).
  7. Jos upottajan sivuvaunu on käytössä, palauta v2-vektorivarasto (tai rakentaa uudelleen indeksit palautetusta tietokannasta/Markdown).
  8. Käynnistä palvelut (aihummer up) ja tarkista /readyz ja deploy/host/smoke.sh.

[!TIP] Pidä myös AIHUMMER_MEDIA_TOKEN_SECRET pääavaimellasi. Se pysyy allekirjoitettuna median lataus-URL-osoitteet ovat voimassa uudelleenkäynnistysten ja uudelleenrakennusten yli.

Minne seuraavaksi