AiHummer
Türkmençe
GirmekŞahsy kabinet
v1.0.x
{ }Swagger

Ehtiyat nusgalar we heläkçilik ýagdaýynda dikeltmek

v1.0.x · täzelendi 2026-06-26

AiHummer-iň ýagdaýy kiçi we anyk kesgitlenen, bu hem goragly nusgalaýyşlary ýönekeýleşdirýär — diňe muny ýatda saklasaň bolýar başlyk açar maglumatyň bazasynda ýok we onuň özbaşdak goralmagy zerurdyr. Bu sahypada nämeleri gorap saklamaly, nähili saklamaly we nädip dikeltmeli barada maglumat berilýär.

Näme ätiýaçlyk edilmeli

Goramalydan üç garaşsyz zat bar:

Näme Gaýda Näme üçin
Maglumatlar bazasy PostgreSQL Hakykylygyň çeşmesi — agentler, gürrüňler, ýat, sazlamalar, şifrlenen syrlary
Lopçalary AIHUMMER_BLOB_DIR Maglumat binýady tarapyndan görkezilen media we faýl goşundylary
Baş açar AIHUMMER_MASTER_KEY Guşagy açýar; maglumatlar bazasynda hiç wagt saklanmady

[!DANGER] Egerlenmek AIHUMMER_MASTER_KEY ayry we onu başga ýere goýmak maglumat bazasy bölünmesi. Möhür bu açaryň astynda konvert bilen şifrlenen — ýitirmek baş açar we şifrlenen gizlinler dikeltmek mümkin däl, hatda kämil bolsa-da Maglumatlar bazasynyň ätiýasy.

PostgreSQL hakykatyň çeşmesidir

Maglumatlar bazasyny ygtybarly hasaplaň. Başlangyç hökmünde maslahat berilýän esas günlük pg_dump plýus WAL arhivlemesi nokat-temmä gaýtadan dikeltmek (PITR) üçin şonuň üçin siz dem alyşlar arasyndaky islendik pursada öňe batyp bilersiňiz.

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

Dump-fayllary yzygiderli WAL arhivlemek bilen (PITR) birleşdiriň, snapshot-lar arasynda jikme-jik dikeltmek üçin.

Einsteiniň ýady hem maglumatlar bazasynda ýaşýarlar: adamlar üçin düşnükli kody Markdown (MEMORY.md) we v2 wektor düzümi proýeksiýalar ondan alnan, aýry-häkimiýetli çeşmeler däl.

Bloblary ätiýaçlyk nusgasyny almak

Media we faýl goşundylary aşakda ýerleşýär AIHUMMER_BLOB_DIR. Bu katalogy maglumatlar binýady bilen bile sakla, şonda dikeldilen söhbetdeşlikler hem-de baglanyşykly faýllary çözip biler. Eger AIHUMMER_BLOB_DIR konfigurasiýa edilmedi, media/faýl hyzmaty işjeň däl we göçürmek üçin goşmaça zat ýok.

Aihummer ätiýaçlyk we dikeltme buýrugy

CLI rutinany iki buýruga toplumlaýar:

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

Bulary adaty iş hereketleri öňündäki ätiýaçlyklar we dikeldişler üçin ulanyň. Garaň CLI salgysy gatnaşykly buýruklar üçin.

[!WARNING] Diňe maglumatlar bazasyny dikeltmek doly dikeldiş däl. Blob katalogyny hem dikeldiň. we üpjün ediň şol bir AIHUMMER_MASTER_KEY maksat mynasynda bar — şol şertde keselhanany açmak mümkin däl.

Bahalysyzlykdan gaýtadan dikeltmek

Täze kesel itýän senariýa üçin öňüni alyň halas ediş hadysalary boýunça iş kitapçasy (docs/runbooks/disaster-recovery.md). Gaýtadan dikeltmek buýrugy şularyň öňündedir:

  1. Bir serwer üpjün ediň we şol AiHummer wersiýasyny gurnyň.
  2. Täzeden dikelt baş açar içine AIHUMMER_MASTER_KEY.
  3. Täzeden dikelt maglumatlar bazasy ( iň soňky köçürme, soňra WAL/PITR ulanylýan bolsa öňe süýşür).
  4. Täzeden dikelt blob katalogy at AIHUMMER_BLOB_DIR.
  5. Gaýtadan dikeltmek modul konfigurasiýasy we artefaktlar (sazlamalar maglumatyň bazasynda ýaşaýar; Ehtiyat nusgaňyzdan islendik modul üçin ýörite konfigurasiýa faýllaryny dikeldiň).
  6. Täzeden dikelt Eynşteýniň ýatlama faýllaryMEMORY.md we kanoniki Markdown (ýady öňünden görkeziş) — olaryň katalogyna (ýa-da olaryň täzeden dikeldilmegine rugsat ber) maglumatlar banky).
  7. Eger embedder sidecar ulanylsa, dikeltmek v2 wektor düzümi (ýa-da täzeden gurmak Täzelenen maglumat bazasyndan/Markdown-dan indeksler).
  8. Hyzmatlary işgäri getiraihummer up) we tassyklamak bilen /readyz we deploy/host/smoke.sh.

[!TIP] Hem-de sakla AIHUMMER_MEDIA_TOKEN_SECRET üşüň açar bilen. Ol gol çekilen ýagdaýda saklaýar Media göçürip almak URL-leri täzeden başlamalarda we gaýtadan gurmalarda hem möhümdir.

Indi nire?