AiHummer
Қазақша▾
Кіру
v1.0.x▾
v1.0.xstable
{ }Swagger
Маркетплейс және плагиндер/Орнату және жаңартулар

Орнату және жаңартулар

v1.0.x · жаңартылды 2026-06-26

AiHummer-де плагинді орнату — әкімші интерфейсінде бір рет басу, бірақ сол басудың артында детерминистік, хост-нативті өмірлік цикл бар. Платформа плагинді жүктейді, оның жарияланған орнату қадамдарын орындайды, оқшауланған systemd бірлігін рендерлейді, және плагин денсаулық тексеруіне жауап бергенше ғана оны сау деп санайды. Содан кейін әр орнату өзін-өзі жаңартып отырады.

Әкімші интерфейсінен бір рет басумен орнату

Сіз плагиндерді әкімші интерфейсінен орнатасыз және басқарасыз, ол әкімші модуль API-мен қамтамасыз етілген:

GET  /v1/admin/modules
POST /v1/admin/modules/{slug}/install

Қолмен жалғайтын ештеңе жоқ: каталогтан плагин таңдаңыз, орнатуды басыңыз, және деплойер бәрін өз қолына алады.

[!NOTE] Einstein жад плагині — кіріктірілген: ол автоматты түрде орнатылады, «Кіріктірілген» бейджімен белгіленген және оны жоюға немесе тоқтатуға болмайды.

SystemdDeployer ағыны

Іштей SystemdDeployer мына қадамдарды орындайды:

  1. Таңдалған плагин үшін tarball жүктеу.
  2. Плагин жариялаған install[] манифест қадамдарын орындау.
  3. Плагин үшін оқшауланған systemd бірлігін рендерлеу.
  4. Қызмет сау деп хабарлағанша /healthz сұрау.
download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

Тек /healthz сәтті болғанда ғана орнату белсенді деп белгіленеді — көтерілмеген плагин үнсіз орнатылған болып саналмайды.

Хост-нативті, оқшауланған systemd — Docker емес

Әр плагин өзінің оқшауланған systemd қызметі ретінде жұмыс істейді. Контейнерлер жоқ, Docker жоқ, оркестратор жоқ: плагин — өзінің бірлігі, порты және оқшаулау шектеулері бар басқарылатын Linux қызметі, орнатудың қалған бөлігі сияқты systemd-пен қадағаланады.

[!WARNING] AiHummer хост-нативті. Плагиндер релиз tarball-дан оқшауланған systemd қызметтері ретінде орналастырылады — ешқашан Docker контейнерлері ретінде емес. Егер нұсқаулық сізге “плагин контейнерін іске қос” десе, ол AiHummer-ді сипаттамайды.

/healthz арқылы денсаулық қақпасы

Деплойер сәттілікті жариялаудан бұрын плагиннің /healthz соңғы нүктесін сұрайды. Дәл осы денсаулық қақпасы бір рет басумен орнатуды қауіпсіз етеді: бұзылған немесе дұрыс бапталмаған плагин кейін өндірісте табылғанша, орнату кезінде ұсталады.

Әр орнатуға арналған автожаңарту

Жаңартулар әр орнату бойынша өңделеді. Әр орнатылған плагин өзінің кестесі бойынша өзін-өзі автожаңарта алады, сондықтан плагиндерді жаңартып ұстау каталогқа жаңа нұсқа келген сайын қолмен қайта орнатуды қажет етпейді. Жаңарту үшін бірінші орнату сияқты дәл сол жүктеу → орнату қадамдары → бірлікті рендерлеу → денсаулық тексеру ағыны орындалады.

[!TIP] Автожаңарту әр орнату бойынша болғандықтан, кейбір плагиндерді бекітіп қойып, басқаларына ең соңғысын бақылауға рұқсат бере аласыз — әр орнату өзінің өмірлік циклін басқарады.

Көп көзді каталог

Каталог енді жалғыз URL-ге байланбаған. Plugins → Sources ішінде (әкімші интерфейсі, немесе POST /v1/admin/modules/catalog/sources) қосымша көз қоса аласыз — мысалы, үшінші тарап плагиндерінің қауымдастық каталогы. Шлюз әр қосылған көзді іске қосу кезінде және автожаңарту аралығында синхрондайды.

  • Ресми көз (бірінші тарап модульдер) бекітілген және әдепкі бойынша сенімді — басқа көздермен қайта жазылмайтын бөлек нысан.
  • Жеке/қауымдастық көздерін оператор қосады; әр каталог жазбасында origin бар, және сол origin қолтаңбаның қай тіреуішке қарсы тексерілетінін шешеді (ресми → бекітілген кілт, жеке → сенім қоймасы).

Қауымдастық каталогына жариялау туралы Плагинді жариялау бөлімін қараңыз.

Сенім моделі және бекітілген кілт

Орнату плагиннің қолтаңбасын оның көзі бойынша тексереді:

  • official → ядрода бекітілген тіркеу кілтіне қарсы тексеріледі. Әдепкі бойынша сенімді, оператордың әрекеті қажет емес.
  • private (бүйірден жүктеу) → дана сенім қоймасына қарсы тексеріледі; автор кілтін оператор жүктеу кезінде бекітеді (бір рет басу).
  • unsigned → қабылданбайды, dev режимінен басқа (AIHUMMER_PLUGIN_DEV_UNSIGNED=1, тек жергілікті әзірлеу).

Қол қойылған жаңартулар

Жаңарту бірінші орнату сияқты дәл сол қолтаңба қақпасын қайта орындайды: жаңа нұсқаға ауысқанда қолтаңба дәл сол сенім тіреуішіне қарсы қайта тексеріледі. Жаңарту тексеруді айналып өте алмайды — жаңарту арқылы сенімді көтере алмайсыз.

Official белгісі және рейтинг

Веб-интерфейс каталогында AiHummer плагиндері Official белгісін алады және бірінші тұрады. Үшінші тарап плагиндері белгісіз көрсетіледі және жүктеулер саны бойынша сұрыпталады. Official жалаушасы жазбаның origin-нен (official) шығарылады — оны манифестте қолмен орнату мүмкін емес.

Әрі қарай қайда