Сактоо көчүрмөлөрү жана кырсыктык калыбына келтирүү

# 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дин абалы кичинекей жана так аныкталган, бул резервдик көчүрмөлөрдү жөнөкөй кылат — эгерде сиз эстеп калсаңыз **мастер ачкыч маалымат базасында жок** жана аны өзүнчө коргоо керек. Бул бетте эмне сактоо керектиги, кантип сактоо жана кантип калыбына келтирүү жөнүндө маалымат берилет. ## Эмне камдоо керек Коргоо үчүн үч өз алдынча нерсе бар: | Эмне | Кайда | Эмне үчүн | |---|---|---| | **Маалымат базасы** | PostgreSQL | Чындык булагы — агенттер, сүйлөшүүлөр, эс тутум, орнотуулар, шифрленген сырлар | | **Дөөлөр** | `AIHUMMER_BLOB_DIR` | Маалымдар базасы тарабынан шилтемеленген медиа жана файл тиркемелери | | **Башкы ачкыч** | `AIHUMMER_MASTER_KEY` | Капаны ачат; **мәліметтер базасында сакталбайт** | > [!DANGER] > Артка кет `AIHUMMER_MASTER_KEY` **айрым-айрым** жана аны башка жерде сактаңыз > маалыматтар базасын чыгарып алуу. Сейф ушул ачкычтын астында конверт менен шифрленген — **жоготуу > мастер ачкыч жана шифрленген сырлар калыбына келтирилбейт**, кемчиликсиз болгон учурда да > маалыматтар базасын камдык көчүрмөсү. ## PostgreSQL чындап турган булак болуп эсептелет Маалымат базасын ыйгарым укуктуу деп караңыз. сунушталган баштапкы деңгээл – бул **күн сайын `pg_dump`** плюс **Убакытка жараша калыбына келтирүү (PITR) үчүн WAL архивдөө** ошондо сиз көчүрмөлөрдүн ортосундагы каалаган убакытка жылдырсаңыз болот. ```bash # Daily logical dump pg_dump "$AIHUMMER_DATABASE_URL" --format=custom --file=aihummer-$(date +%F).dump ``` Сүрөттөрдүн ортосунда так калыбына келтирүү үчүн топкунаган журналдын үзгүлтүксүз архивдөөсү (PITR) менен көчүрмөлөрдү жуптаңыз. Эйнштейндин эс тутуму маалымат базасында да жашайт: адам окуй алган канондук Markdown (`MEMORY.md`) жана v2 вектордук сактоо болуп саналат **прогноздор** анын негизинде алынган, өзүнчө ыйгарым укуктуу сактоочу жерлер эмес. ## Blobдарды сактоо Медиа жана файл тиркемелери астында жашайт `AIHUMMER_BLOB_DIR`. Бул каталогду маалымат базасы менен кошо сактап коюңуз, ошондо калыбына келтирилген сүйлөшүүлөр дагы алардын тиркемелерин чечө алат. Эгер `AIHUMMER_BLOB_DIR` көйлөлө элек, медиа/файл кызматы активдүү эмес жана көчүрүү үчүн кошумча эч нерсе жок. ## aihummer камдык көчүрмөсүн жасоо жана калыбына келтирүү буйруктары CLI рутина эки буйруктун ичинде топтолот: ```bash aihummer backup [dir] # write a backup into [dir] aihummer restore <file> # restore from a backup file ``` Буларды кадимки операциялык камдык көчүрмөлөрдү жана калыбына келтирүүлөрдү жүргүзүү үчүн колдонуңуз. Караңыз [CLI колдонмосу](/ky/v1.0/reference/cli) тектеш буйруктар үчүн. > [!WARNING] > Мелдешти базасын калыбына келтирүү өзүнчө толук калыбына келтирүү эмес. Blob каталогун дагы калыбына келтириңиз, > жана камсыз кыл **Ошондой эле** `AIHUMMER_MASTER_KEY` максаттагы хостто бар — > болбосо сейфти декоддолу болбойт. ## Коопсуздукту калыбына келтирүү Толук хост жоготуў сценарийи үчүн, аны көз тарап **апаатты калыбына келтирүү боюнча нускамалык китепча** (`docs/runbooks/disaster-recovery.md`). Калыбына келтирүү тартиби: 1. Хостту камсыздоо жана ошол эле AiHummer версиясын орнотуу. 2. Калыбына келтирүү **мастер ачкыч** ичине `AIHUMMER_MASTER_KEY`. 3. Калыбына келтирүү **маалымат базасы** (ачык акыркы көчүрмө, андан кийин эгер колдонулган болсо WAL/PITR аркылуу алдыга жылуудан өткөн). 4. Калыбына келтирүү **блоб каталог** жана `AIHUMMER_BLOB_DIR`. 5. Калыбына келтирүү **модулдун конфигурациясы жана артефакттары** (пайдалануу жөндөөлөрү маалымат базасында сакталат; өзүңүздүн камдык көчүрмөдөн модулга тиешелүү конфигурация файлдарын калыбына келтирүү). 6. Калыбына келтирүү **Эйнштейндин эс тутум файлдары** — `MEMORY.md` жана канондук Markdown (эстутум проекциясы) — алардын каталогуна (же аларды кайрадан курууга уруксат бер)} маалымат базасы). 7. Эгер эндбедер сайкар колдонулса, калыбына келтириңиз **v2 вектордук сактоочу** (же кайра куруу калпына келтирилген маалымат базасынан/Markdown) индекстер. 8. Кызматтарды жүктө (`aihummer up`) жана текшериңиз `/readyz` жана `deploy/host/smoke.sh`. > [!TIP] > Ошондой эле сакта `AIHUMMER_MEDIA_TOKEN_SECRET` сиздин негизги ачкычыңыз менен. Ал кол коюлган бойдон сакталат > медиа жүктөө URL даректери кайра баштоо жана кайра курууларда жарактуу. ## Келерки кайда - Өзгөртүүнү текшерүү үчүн колдонулган зонддор жана түтүн тести: [systemd жана саламаттыкты текшерүү](/ky/v1.0/operations/systemd-health). - Жаңыртуу учурунда версиялоо жана миграциялар: [Жаңыртуу саясаты](/ky/v1.0/operations/upgrade-policy).