Архивхареи акатастрофа ашьҭахь арҿыхареи

# 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 аҭагылазаашьа маҷуп насгьы ишьақәгылоуп, убри иабзоураны архивхара имариоуп — ауаҩы ишигәалашәозар **the master key абаза иҭам** насгьы хазы ахьчазароуп. Абри адаҟьа аҿы иарбоуп изхымҭоу архив, ишахымҭо, насгьы ишаԥырхагоу. ## Иарбан архив ҟалатәузеи Хԥа хазхазтәи иҟоуп ихьчатәу: | Иарбоу | Аҿы | Изаҟоу | |---|---|---| | **Абаза** | PostgreSQL | Аиаша аҵыхәтәантәи — агентқәа, аиҿцәажәарақәа, агәынҩажәара, ахышьҭарақәа, иршифрахаз амаӡақәа | | **Blobs** | `AIHUMMER_BLOB_DIR` | Амедиа насгьы абазала иадҳәалоу афаилқәа | | **Master key** | `AIHUMMER_MASTER_KEY` | Авалт идешифрхоит; **абаза иҭаҵам** | > [!DANGER] > Архив ҟаҟ `AIHUMMER_MASTER_KEY` **хазы** насгьы абаза адамп иҟам ахьырҟ. > Авалт абри акалит аҵаҟа envelope-шифрахоуп — **master key ишәылаӡар иршифрахаз > амаӡақәа рырҿыхара уадаҩуп**, абаза архив маншәалазаргьы. ## PostgreSQL — аиаша аҵыхәтәантәи Абаза аиаша иабзоураны иахәаԥшы. Иҟоу абжьаратә ҟазшьахә — **уаҵәтәи `pg_dump`** ацҵаны **WAL архивхара point-in-time recovery (PITR) азы** убри аҟынтә удампқәа реиҩашамҭа зны-зныла иауршеит. ```bash # Daily logical dump pg_dump "$AIHUMMER_DATABASE_URL" --format=custom --file=aihummer-$(date +%F).dump ``` Адампқәа еицҵа WAL архивхара хаҭакны (PITR) аснапшоттқәа реиҩашамҭа аӡбахьтә арҿыхаразы. ## Blobs архивхара Амедиа насгьы афаилқәа `AIHUMMER_BLOB_DIR` аҵаҟа иҟоуп. Абри акаталог архив ҟаҟ абазала, убри аҟынтә иарҿыху аиҿцәажәарақәа рыфаилқәа реилкаара рылшоит. `AIHUMMER_BLOB_DIR` иарӡамзар, амедиа/афаил аусура аус ауам насгьы хазтәи икопиатәу акгьы ыҟаӡам. ## The aihummer backup & restore адҵақәа CLI аусура ҩ-дҵак рыла еидыркылоит: ```bash aihummer backup [dir] # write a backup into [dir] aihummer restore <file> # restore from a backup file ``` Ари аусуратә архивхареи арҿыхареи рзы иҟа. Иадҳәалоу адҵақәа рзы ахәаԥш [CLI азгәаҭа](/ab/v1.0/reference/cli). > [!WARNING] > Абаза арҿыхара мацара хыхәпатә арҿыхара акаӡам. Blob каталог архив ҟаҟ, > насгьы иашьашәалоу **убри иакоу** `AIHUMMER_MASTER_KEY` атаргет хост аҿы > ишыҟоу убаа — мамзар авалт идешифрхар ауам. ## Акатастрофа ашьҭахь арҿыхара Хыхәпатә хост шылаӡара аҟынтә, иашьҭала **акатастрофа арҿыхара руктә** (`docs/runbooks/disaster-recovery.md`). Арҿыхара аус ала: 1. Хост ҟа насгьы иакоу AiHummer аверсиа ишьҭ. 2. Арҿых **master key** `AIHUMMER_MASTER_KEY` аҟны. 3. Арҿых **абаза** (аҵыхәтәантәи адамп, нас WAL/PITR ала иашьҭала аиашьа аазыр). 4. Арҿых **blob каталог** `AIHUMMER_BLOB_DIR` аҟны. 5. Аусурақәа аарԥш (`aihummer up`) насгьы убаа `/readyz` насгьы `deploy/host/smoke.sh` рыла. > [!TIP] > Иҟаҟ `AIHUMMER_MEDIA_TOKEN_SECRET` уаҩ master key ацны. Ари аиашьаны иршифру > амедиа аалыҵ URL аарԥхрашьҭаны иашьашәалоу иаанагоит. ## Анаҩс аҿы - Зондтә насгьы smoke test арҿыхара ауба: [systemd насгьы агәабзиара агәаҭарақәа](/ab/v1.0/operations/systemd-health). - Аверсиахареи амиграциақәеи аиашьаны: [Аиашьа аполитика](/ab/v1.0/operations/upgrade-policy).