Ehtiyat nüsxələr və fəlakətdən bərpa

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

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

AiHummer-in vəziyyəti kiçik və yaxşı müəyyən edilmişdir, bu da ehtiyat nüsxələri sadələşdirir — yetər ki, **master açarın verilənlər bazasında olmadığını** və onun ayrıca qorunmalı olduğunu unutmayasınız. Bu səhifə nəyin, necə ehtiyat nüsxələnəcəyini və necə bərpa ediləcəyini əhatə edir. ## Nəyin ehtiyat nüsxəsi alınmalıdır Qorunmalı üç müstəqil şey var: | Nə | Harada | Niyə | |---|---|---| | **Verilənlər bazası** | PostgreSQL | Həqiqət mənbəyi — agentlər, söhbətlər, yaddaş, parametrlər, şifrələnmiş sirlər | | **Bloblar** | `AIHUMMER_BLOB_DIR` | Verilənlər bazası tərəfindən istinad edilən media və fayl əlavələri | | **Master açar** | `AIHUMMER_MASTER_KEY` | Sandığı (vault) deşifrə edir; **heç vaxt verilənlər bazasında saxlanılmır** | > [!DANGER] > `AIHUMMER_MASTER_KEY` açarını **ayrıca** ehtiyat nüsxələyin və onu verilənlər > bazası dampından başqa bir yerdə saxlayın. Sandıq bu açar altında zərf > şifrələməsi (envelope-encrypted) ilə qorunur — **master açarı itirsəniz, > şifrələnmiş sirlər bərpaolunmazdır**, hətta mükəmməl verilənlər bazası ehtiyat > nüsxəsi olsa belə. ## Həqiqət mənbəyi PostgreSQL-dir Verilənlər bazasına etibarlı (authoritative) kimi yanaşın. Tövsiyə olunan baza xətti **gündəlik `pg_dump`** üstəgəl **point-in-time bərpa (PITR) üçün WAL arxivləşdirilməsidir**, beləliklə damplar arasında istənilən ana qədər irəli sürə bilərsiniz. ```bash # Daily logical dump pg_dump "$AIHUMMER_DATABASE_URL" --format=custom --file=aihummer-$(date +%F).dump ``` Snapshotlar arasında dəqiq bərpa üçün dampları davamlı WAL arxivləşdirilməsi (PITR) ilə birləşdirin. ## Blobların ehtiyat nüsxəsi Media və fayl əlavələri `AIHUMMER_BLOB_DIR` altında yerləşir. Bu qovluğu verilənlər bazası ilə birlikdə ehtiyat nüsxələyin ki, bərpa edilmiş söhbətlər hələ də öz əlavələrini həll edə bilsin. Əgər `AIHUMMER_BLOB_DIR` konfiqurasiya edilməyibsə, media/fayl xidməti aktiv deyil və əlavə kopyalanacaq heç nə yoxdur. ## aihummer backup və restore əmrləri CLI bu prosedurları iki əmrdə birləşdirir: ```bash aihummer backup [dir] # write a backup into [dir] aihummer restore <file> # restore from a backup file ``` Bunları adi əməliyyat ehtiyat nüsxələri və bərpaları üçün istifadə edin. Əlaqəli əmrlər üçün [CLI istinadına](/en/v1.0/reference/cli) baxın. > [!WARNING] > Tək başına verilənlər bazası bərpası tam bərpa deyil. Blob qovluğunu da bərpa > edin və hədəf hostda **eyni** `AIHUMMER_MASTER_KEY`-in mövcud olduğundan əmin > olun — əks halda sandıq deşifrə edilə bilməz. ## Fəlakətdən bərpa Tam host itkisi ssenarisi üçün **fəlakətdən bərpa runbook-unu** (`docs/runbooks/disaster-recovery.md`) izləyin. Bərpa ardıcıllığı belədir: 1. Host təmin edin və eyni AiHummer versiyasını quraşdırın. 2. **Master açarı** `AIHUMMER_MASTER_KEY` daxilinə bərpa edin. 3. **Verilənlər bazasını** bərpa edin (ən son damp, sonra istifadə olunubsa WAL/PITR vasitəsilə irəli sürün). 4. **Blob qovluğunu** `AIHUMMER_BLOB_DIR` ünvanında bərpa edin. 5. Xidmətləri qaldırın (`aihummer up`) və `/readyz` və `deploy/host/smoke.sh` ilə yoxlayın. > [!TIP] > `AIHUMMER_MEDIA_TOKEN_SECRET`-i də master açarınızla birlikdə saxlayın. O, > imzalanmış media yükləmə URL-lərini yenidən başlatma və yenidən qurmalar > arasında etibarlı saxlayır. ## Sonra hara - Bərpanı yoxlamaq üçün istifadə olunan zondlar və smoke testi: [systemd və sağlamlıq yoxlamaları](/en/v1.0/operations/systemd-health). - Yeniləmə zamanı versiyalaşdırma və miqrasiyalar: [Yeniləmə siyasəti](/en/v1.0/operations/upgrade-policy).