Ашьҭаҵара, outbox & аиҭашьақәыргылара

Ахаҿ анхиркәшо, аҭак ма иахьеиҭеит уи аканал иахьдҟьаз — ишьақәгылауп, насгьы шәҟәык ала. AiHummer ари инапаҿы иааннакылоит транзакциалатә outbox, идемпотентратә аалырҟьарақәа ацны ахаҿ аиҭашьақәыргылара аиҭагара ашьҭахь. Изыхәҭоу аамҭазы NATS-абжьажәҩа иадхалоит ашьҭаҵара иреиҳаны идуу адеплойментқәа рзы.

Иқәныршәоу ашьҭаҵара

Аҭак инлайн ала иашьҭымҵоит ахаҿ ахыркәшараҿы. Уи аҟынтә outbox аҿы иҭагылоуп уи иаԥызҵаз аусура иацны, насгьы ашьҭаҵара аусуҩы уи иааникылоит насгьы изаԥырҵаз аканал иахьдиршьҭуеит. Аҭак иахьеиҭеит аԥхьа ииашаны иахьаҵанахоз азы, “аҭак аԥҵан” ацны “аҭак ашьҭуп” рыбжьара иҟалаз акрах уи иаҟәнаршәартә алшара ыҟам — аиҭагара ашьҭахь outbox-аҿтәи аҭагылазаашьа уаҟа иаанхоит насгьы ашьҭаҵара иацҵахоит.

turn produces reply
   └─▶ enqueue in outbox (durable)
         └─▶ delivery worker ─▶ originating channel
               └─ acknowledged ─▶ marked delivered

Ашьҭаҵара идемпотентра иадаҳәалоуп ари at-least-once аусуҩы exactly-once адәныҟатәи аҿагылашьа ааникылартә: resume-стабилтә ledger-аҭыӡҭыԥ ацны аалырҟьара абарьер ишьақәнаргылоит иеиҭаԥхьаӡаз ма иеиҭагаз аҭак аканал ахь акызаҵәык ишахьылаало (ахь(уба Мультитенантра & идемпотентра).

[!NOTE] “Exactly-once” абраҟа адәныҟала иубо алҵшәа аанарԥшуеит: ахархәаҩ аҭак акызаҵәык иоуеит. Аҩныҟала аусуҩы ашьҭаҵара акырынтә иҽазишәартә алшоит; идемпотентра ахаҭәы ари аҽазышәарақәа акызаҵәык иубо ашьҭаҵара ахь иаирхәоит.

Ахаҿ аиҭашьақәыргылара аиҭагара ашьҭахь

Агейтуэй ахаҿ агьежьаҿы иаиҭагар — адеплой, акрах, ахост аиҭашьҭыхра — аусура ишьҭымхуеит. Ахаҿ аиҭашьақәыргылара иаԥырҟьаз ахаҿ иеиҭанарԥшуеит уи ахиркәшартә. Ари ишәарҭам аалырҟьарақәа идемпотентроуп азы азеиԥшу: иахьеиҭеит ашәҟәы ма аканал-аршьҭра аиҭагара аԥхьа иҟалаз уи ledger-аҭыӡҭыԥ ала иазхаҵоуп насгьы иаԥхоит, иаԥырмҵоз ахәҭақәа рхыркәшарахьы ицоит. Ахархәаҩ акызаҵәык, ихиркәшоу аҭак ибоит ма абжамҵ ма ажәаԥҟак.

Изыхәҭоу NATS-абжьажәҩа

Иадагьыланы ашьҭаҵара зегьы PostgreSQL ала иауеит, уи аминималтә адеплоймент агейтуэй акыи адырраҭарадза акыи аанарԥшуеит. Иреиҳаны идуу ма мультигейтуэй адырраҭарадза рзы ашьҭаҵара NATS-абжьажәҩа ахь иҭыҵыр ауеит уи URL аиқәыршәара ала:

# gateway.env
AIHUMMER_NATS_URL=nats://127.0.0.1:4222

Абжьажәҩа иаразнак изыхәҭоуп — AIHUMMER_NATS_URL ушьымҭакуа ианажәуп outbox уи ада иауеит. Аныҟоу аамҭазы NATS уи атранспорт ҟалоит ашьҭаҵара аусура иахьахьыло, уи апрокси ашьҭахь горизонталла иҭбаау агейтуэйқәа рзы иахаалоит.

[!TIP] Zero-downtime арҿыцрақәа ҩба ма иреиҳаны агейтуэйқәа реверс-прокси ашьҭахь иауеит. Аиҭархиаҩ акызаҵәык-алидер иаанхоит Postgres advisory lock ала, насгьы идемпотентратә ашьҭаҵара иаанарԥшуеит иҵегь агейтуэйқәа адагьаҵара рыжәларартә шәҟәык ҩынтә аршьҭарада.

Изаԥшароу

Ашьҭаҵара ииашамра апроблемақәа рхы иахьаарԥшло аԥхьа иоуп, уи аҟынтә амониторинг иахәҭоу акоуп. AiHummer ателеметриа OTLP ала иаршьҭуеит (AIHUMMER_OTEL_ENDPOINT) насгьы Grafana адашбордқәа иарбоит; Prometheus /metrics эндпоинт скрапируентә ыҟам.

Ашьҭаҵара адиспозициақәа — ашьҭаҵара аҽазышәара ахьаԥшахаара. Ампыҵаныҟәарақәа рхаара аканал ма даунстрим апроблема иаанарԥшуеит.
Outbox аҭбаара — ишԥацны иауазаалак аҭакқәа ашьҭаҵара иазыԥшуп. Ишьақәгылоу ахаара ашьҭаҵара ишьҭахьыло ааникылоит.
DLQ аҭбаара — рыретрайқәа изхырҵаз насгьы dead-letter аджәбаҿы иҭагылаз аҭагылазаашьақәа. DLQ ахаара зегьы ариашара иазҵаауеит.

[!WARNING] Ари ахаҿ алатенцеи ампыҵаныҟәара аԥхьаӡеи рыцны изаԥшы. Иҭбаауа outbox ма DLQ аԥхьахьтәи аамҭеи ауп даунстрим аканалқәа изеилаху, ахаҿ ахаҭа ииашаны иаауазаалак аамҭазгьы.

Аҩаџьара иуцо

Ашьҭаҵара exactly-once иазҟазаз идемпотентра: Мультитенантра & идемпотентра.
Аҭак иаԥызҵо адвигатель: Агейтуэй & ахаҿ адвигатель.