AiHummer
Тоҷикӣ▾
Даромадан
v1.0.x▾
v1.0.xstable
{ }Swagger
Истифодабарӣ/Сиёсати навсозӣ

Сиёсати навсозӣ

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

Устуворӣ як принсипи маҳсулот аст, на як андешаи дертар. AiHummer аз SemVer пайравӣ мекунад, миграцияҳои ба пеш бехатари пойгоҳи додаҳоро ба таври худкор татбиқ мекунад ва метавонад худро навсозӣ аз як CDN кунад — бинобар ин навсозиҳо муқаррарӣ мебошанд, на хатарнок.

Версиябандӣ (SemVer)

Релизҳо аз Версиябандии Маъноӣ (Semantic Versioning) пайравӣ мекунанд. Версия тавассути /healthz ва aihummer version хабар дода мешавад, бинобар ин шумо метавонед ҳамеша маҳз он чиро, ки пеш ва пас аз навсозӣ кор мекунад, тасдиқ кунед.

Миграцияҳо ба пеш бехатар ва худкоранд

Ҳангоми оғоз шлюз миграцияҳои дарпешистодаи пойгоҳи додаҳоро ба таври худкор татбиқ мекунад. Ду хосият онро бехатар нигоҳ медорад:

  • Ба пеш бехатар. Миграцияҳо тавре навишта шудаанд, ки бинарии навтар бар зидди схемае, ки он ба он миграция мекунад, кор кунад, ки маҳз ҳамин татбиқи худкор ва навсозиҳои тадриҷиро бехатар мегардонад.
  • Татбиқкунандаи ягона тавассути қулфи машваратӣ. Миграцияҳо дар зери як қулфи машваратии PostgreSQL иҷро мешаванд, бинобар ин вақте ки якчанд шлюз дар як вақт оғоз меёбанд, танҳо яке онҳоро татбиқ мекунад ва бақия интизор мешаванд — ҳаргиз як миграцияи дучанд.

[!NOTE] Миграцияҳо ҳамеша дар пули соҳиби пойгоҳи додаҳо иҷро мешаванд. Нақши маҳдуди RLS (AIHUMMER_DB_APP_URL) барои хидматрасонии трафик аст, на барои тағйироти схема.

Худнавсозӣ аз CDN

Шлюз метавонад худро аз CDN-и релиз навсозӣ кунад. Рафтор тавассути се тағйирёбандаи муҳит идора карда мешавад:

Тағйирёбанда Мақсад
AIHUMMER_AUTO_UPDATE off | check | apply — ғайрифаъол, танҳо огоҳкунӣ ё татбиқи худкор
AIHUMMER_UPDATE_CHANNEL Канали релиз барои пайгирӣ (масалан, stable / alfa / beta / dev)
AIHUMMER_DOWNLOAD_BASE_URL URL-и асосӣ, ки навсозӣ аз он кашида мешавад

Навсозиҳо тавассути latest.json-и канал дар CDN кашф мешаванд. Шумо метавонед навсозиҳоро низ ба таври дастӣ бо CLI идора кунед:

aihummer update --check   # report whether a newer version is available
aihummer update           # download and apply the update
# gateway.env — notify-only on the stable channel
AIHUMMER_AUTO_UPDATE=check
AIHUMMER_UPDATE_CHANNEL=stable

[!TIP] Бо AIHUMMER_AUTO_UPDATE=check оғоз кунед, то аз релизҳои нав огоҳ карда шавед ва пас аз он, ки ба канал барои рӯлаутҳои бенозорат эътимод мекунед, ба apply гузаред.

Рӯлаутҳои бе хомӯшӣ

AiHummer тавре сохта шудааст, ки бе қатъи кор навсозӣ шавад:

  • 2+ шлюзро дар паси прокси иҷро кунед. Онҳоро якто-якто рӯл кунед; зонди омодагӣ (/readyz) гиреҳи бозоғозшавандаро аз гардиш берун нигоҳ медорад, то он хидмат накунад.
  • Ҷадвалбанд як-роҳбар аст. Ҷадвалбандии заминавӣ як роҳбари ягонаро тавассути қулфи машваратии PostgreSQL интихоб мекунад, бинобар ин иҷрои якчанд шлюз кори ҷадвалбандишударо такрор намекунад.
  • Расонидан идемпотентӣ аст. Outbox-и расонидани кафолатнок ва ҳамзамон калидҳои идемпотентӣ маънои онро доранд, ки як ҷавоб ҳаргиз дар тӯли бозоғозкунӣ ду бор фиристода намешавад, ки маҳз ҳамин рӯл кардани як флотро бехатар мегардонад.

Минбаъд ба куҷо