AiHummer
Аԥсшәа▾
Аиалаҵара
v1.0.x▾
v1.0.xstable
{ }Swagger
Аэксплуатациа/Аиашьа аполитика

Аиашьа аполитика

v1.0.x · ирҿыцуп 2026-06-26

Аишьҭагылара — апродукт принципуп, ашьҭахьтәи гәаанагаракәым. AiHummer ишьҭоит SemVer, иршеит иарԥхьаӡаны ашәарҭам абаза амиграциақәа автоматла, насгьы ауеит self-update CDN аҟынтә — убри аҟынтә аиашьа имариоуп, ишәарҭам.

Аверсиахара (SemVer)

Аrelease-қәа ишьҭоит Семантикатә Аверсиахара. Аверсиа /healthz насгьы aihummer version рыла иҭыхуеит, убри аҟынтә аиашьа аԥхьа насгьы анаҩс иарбан ишауса ауба.

Амиграциақәа иарԥхьаӡаны ашәарҭам насгьы автомат

Аарԥшра аан the gateway иаамыжьу абаза амиграциақәа автоматла иршеит. Ҩ-зеиԥшк ари ашәарҭам иаазырхо:

  • Иарԥхьаӡаны ашәарҭам. Амиграциақәа иҩуп уи ажәҩахымӡатәи бинар уи ахь имиграцируу схема аус аура, убри ауп автомат-аршра насгьы роллингтә аиашьа ашәарҭам иаазырхо.
  • Акы-аршратә advisory lock ала. Амиграциақәа иршеит PostgreSQL advisory lock аҵаҟа, убри аҟынтә gateway-к зегьы зны иаарԥшзар акы мацара иршеит насгьы егьырҭ изыԥшуеит — ҩынтә миграциа акәымкәа.

[!NOTE] Амиграциақәа зегьы иршеит the owner абаза pool аҟны. Иантабарга RLS роль (AIHUMMER_DB_APP_URL) — атрафик аус аура рзы, схема аԥсахрақәа рзы акәым.

Self-update CDN аҟынтә

The gateway ахаҭа CDN аrelease аҟынтә иршеит. Ари аус еилазаауеит хԥа environment variable ала:

Вариабль Аус
AIHUMMER_AUTO_UPDATE off | check | apply — иаҿыхоу, дырраны-мацара, мамзар автомат-аршра
AIHUMMER_UPDATE_CHANNEL Аrelease аканал иршеит (мап., stable / alfa / beta / dev)
AIHUMMER_DOWNLOAD_BASE_URL Аиашьа аҟынтә иархьыӡу Base 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 ахь иас аканал угәгьаразар иаԥшымкәа аиашьаразы.

Zero-downtime аиашьа

AiHummer иҟаҵоуп аиашьаразы аусаанкылара ыҟамкәа:

  • 2+ gateway прокси ашьҭахь иршь. Зны-зныла иршь; аазырхиара зонд (/readyz) иауршо аnode аротациа аҟынтә ианхалоит уи аусура аалагаанӡа.
  • Апланировшьык-акы-лидер. Аҿеихыжьратә апланиршьара акы лидер ишьҭоит PostgreSQL advisory lock ала, убри аҟынтә gateway-қәа жәпа аршра иршьоу аусура ҩынтә иҟаҵаӡам.
  • Адашьҭара идемпотентуп. Игарантхаз-адашьҭара outbox идемпотентра калитлқәа ацны аҭак ҩынтә иашьҭаӡам аарԥхрашьҭ аасҭа, убри ауп флот аршра ашәарҭам иаазырхо.

Анаҩс аҿы