AiHummer
Türkmençe▾
Gir
v1.0.x▾
v1.0.xstable
{ }Swagger
Ulanyş/Ätiýaçlyk nusgalar we betbagtçylykdan dikeldiş

Ätiýaçlyk nusgalar we betbagtçylykdan dikeldiş

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

AiHummer-iň ýagdaýy kiçi we gowy kesgitlenen, bu ätiýaçlandyrmany ýönekeýleşdirýär — master açaryň maglumatlar bazasynda däldigini we onuň öz-özüne goralmalydygyny ýatda saklasaňyz. Bu sahypa nämäni ätiýaçlandyrmalydygyny, nädip we nädip dikeltmelidigini öz içine alýar.

Nämäni ätiýaçlandyrmaly

Goralmaly üç garaşsyz zat bar:

Näme Nirede Näme üçin
Maglumatlar bazasy PostgreSQL Hakykatyň çeşmesi — agentler, söhbetdeşlikler, ýat, sazlamalar, şifrlenen syrlar
Bloblar AIHUMMER_BLOB_DIR Maglumatlar bazasy tarapyndan salgylanýan media we faýl goşundylary
Master açar AIHUMMER_MASTER_KEY Ammary şifresini açýar; hiç haçan maglumatlar bazasynda saklanmaýar

[!DANGER] AIHUMMER_MASTER_KEY-i aýratyn ätiýaçlandyryň we ony maglumatlar bazasynyň dampyndan başga bir ýerde saklaň. Ammar bu açaryň aşagynda örtük-şifrlenen — master açary ýitirseňiz, şifrlenen syrlary dikeltmek mümkin däl, hatda kämil maglumatlar bazasy ätiýaçlygy bilen-de.

PostgreSQL hakykatyň çeşmesidir

Maglumatlar bazasyna ygtyýarly hökmünde garaň. Maslahat berilýän esas günlük pg_dump goşmaça point-in-time recovery (PITR) üçin WAL arhiwlemesi — şeýdip damplaryň arasynda islendik pursata öňe togalanyp bilersiňiz.

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

Damplary surat görnüşleriň arasynda inçe-derejeli dikeldiş üçin yzygiderli WAL arhiwlemesi (PITR) bilen jübütleň.

Bloblary ätiýaçlandyrmak

Media we faýl goşundylary AIHUMMER_BLOB_DIR astynda ýaşaýar. Bu katalogy maglumatlar bazasy bilen birlikde ätiýaçlandyryň, şeýdip dikeldilen söhbetdeşlikler öz goşundylaryny entegem çözüp bilýär. Eger AIHUMMER_BLOB_DIR düzülmedik bolsa, media/faýl hyzmaty işjeň däl we göçürilmeli goşmaça hiç zat ýok.

aihummer backup & restore buýruklary

CLI bu işi iki buýruga jemleýär:

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

Bulary adaty operasion ätiýaçlandyrmalar we dikeldişler üçin ulanyň. Degişli buýruklar üçin CLI salgylanmasyna serediň.

[!WARNING] Diňe maglumatlar bazasyny dikeltmek doly dikeldiş däldir. Blob katalogyny hem dikeldiň, we maksat hostda şol AIHUMMER_MASTER_KEY-iň barlygyna göz ýetiriň — ýogsam ammaryň şifresini açyp bolmaýar.

Betbagtçylykdan dikeldiş

Doly host-ýitiş senarisi üçin betbagtçylykdan-dikeldiş runbuk-yna (docs/runbooks/disaster-recovery.md) eýeriň. Dikeldiş tertibi:

  1. Host taýýarlaň we şol AiHummer wersiýasyny gurnaň.
  2. Master açary AIHUMMER_MASTER_KEY-e dikeldiň.
  3. Maglumatlar bazasyny dikeldiň (iň soňky damp, soňra ulanylan bolsa WAL/PITR arkaly öňe togalaň).
  4. Blob katalogyny AIHUMMER_BLOB_DIR-de dikeldiň.
  5. Hyzmatlary işlediň (aihummer up) we /readyz we deploy/host/smoke.sh bilen barlaň.

[!TIP] Şeýle hem AIHUMMER_MEDIA_TOKEN_SECRET-i master açaryňyz bilen saklaň. Ol gaýtadan başlatmalar we gaýtadan gurnamalar arkaly imzalanan media göçürip-alyş URL-lerini hereketli saklaýar.

Indiki nirä