AiHummer
Тоҷикӣ▾
ВоридшавӣКабинети шахсӣ
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Истифодабарӣ/Нусхаҳои эҳтиётӣ ва барқарорсозии офат

Нусхаҳои эҳтиётӣ ва барқарорсозии офат

v1.1.x · навсозӣ шуд 2026-06-26

Ҳолати AiHummer хурд ва хуб муайян шудааст, ки нусхабардориҳоро содда мегардонад — то даме ки шумо ёд доред, ки калиди асосӣ дар пойгоҳи додаҳо нест ва бояд танҳо муҳофизат карда шавад. Ин саҳифа фарогири он аст, ки чӣ бояд нусхабардорӣ шавад, чӣ тавр ва чӣ гуна барқарор кардан мумкин аст.

Чӣ бояд нусхабардорӣ кард

Се чизи мустақил барои ҳифз вуҷуд доранд:

Чӣ Куҷо Чӣ маъно дорад?
Пойгоҳи додаҳо PostgreSQL Манбаи ҳақиқат — агентҳо, гуфтугӯҳо, хотира, танзимот, сиррҳои рамзгузошташуда
Ларзаҳо AIHUMMER_BLOB_DIR Васоити ахбор ва замимаҳое, ки аз ҷониби пойгоҳи додаҳо ишора шудаанд
Калиди асосӣ AIHUMMER_MASTER_KEY Қуттиро кушода мекунад ҳеҷ гоҳ дар пойгоҳи додаҳо нигоҳ дошта намешавад

[!DANGER] Паштапӣ диҳед AIHUMMER_MASTER_KEY ҷудогона ва онро дар ҷое ғайр аз дампии пойгоҳи додаҳо. Сандуқ зери ин калид рамзгузорӣ шудааст — аз даст додан калиди асосӣ ва сиррҳои рамзшуда барқарорнашаванда мебошанд, ҳатто бо комил нусхаи эҳтиётии пойгоҳи додаҳо.

PostgreSQL манбаи ҳақиқат аст

Маълумотнома бояд ҳамчун манбаи асосӣ баррасӣ шавад. Сатҳи тавсияшуда ин аст ҳаррӯз pg_dump афзалият Архивбардории WAL барои барқарорсозии нуқтаи вақтӣ (PITR) пас шумо метавонед ба ҳар лаҳза байни партобҳо ҳаракат кунед.

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

Дампҳоро бо сабткунии доимии WAL (PITR) ҷуфт кунед барои барқарорсозии дақиқ байни тасвирҳои ҳолати система.

Хотираи Эйнштейн низ дар пойгоҳи додаҳо зинда аст: Markdown-и канонии хонданшавандаи инсон(MEMORY.md) ва мағозаи векторӣ v2 пешгӯӣ қазияшуда аз он, на мағозаи мустақили ваколатдор.

Ҳамгиронии блобҳо

Воситаҳо ва пайвасткуниҳои файл дар зер зиндагӣ мекунанд AIHUMMER_BLOB_DIRИн директорияро ҳамроҳ бо пойгоҳи додаҳо эҳтиётӣ кунед, то сӯҳбатҳои барқароршуда ҳанӯз ҳам тавонанд замимулаҳои худро ҳал кунанд. Агар AIHUMMER_BLOB_DIR танзим нашудааст, хидмати расона/файл фаъол нест ва чизе иловагӣ барои нусхабардорӣ вуҷуд надорад.

Фармонҳои эҳтиётӣ ва барқарорсозии aihummer

CLI тамоми равандро ба ду фармон муттаҳид мекунад:

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

Инҳоро барои захираҳо ва барқарорсозии оддӣ истифода баред. Нигоҳ кунед Маълумоти CLI барои фармонҳои марбут.

[!WARNING] Барқарор кардани пойгоҳи додаҳо танҳо як барқарорсозии пурра нест. Феҳристи блобро низ барқарор кунед ва итминон ҳосил кунед, ки ҳамон 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ҳои зеркашии васоити ахборӣ, ки пас аз аз сароғоз ва таҷдиди сохтор ҳам боқӣ мемонанд.

Баъд ба куҷо