Орнотуу жана жаңылоолор

GET  /v1/admin/modules
POST /v1/admin/modules/install

{ "slug": "einstein", "version": "" }

download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

AiHummerде плагинди орнотуу — админ UIде бир чыкылдатуу, бирок ал чыкылдатуунун артында детерминисттик, хост-нативдик жашоо цикли турат. Платформа плагинди жүктөп алат, анын жарыяланган орнотуу кадамдарын аткарат, **изоляцияланган systemd бирдигин** түзөт жана плагин ден соолук текшерүүсүнө жооп бергенден кийин гана аны соо деп эсептейт. Андан кийин ар бир орнотуу өзүн өзү жаңы бойдон сактайт. ## Админ UIден бир чыкылдатуу менен орнотуу Сиз плагиндерди админ UIден орнотуп, башкарасыз, ал админ модулунун API аркылуу иштейт: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Модулдун slug'у сурам жолунда эмес, JSON сурам денесинде берилет: ```json { "slug": "einstein", "version": "" } ``` Колдон туташтыра турган эч нерсе жок: каталогдон плагинди тандаңыз, орнотууну басыңыз, андан кийин деплоер баарын өзү аткарат. > [!NOTE] > Негизги топтомдон (Telegram, web, веб-виджет) тышкаркы канал коннекторун > орнотуу үчүн активдүү **Starter**, **Business** же **Enterprise** лицензиясы > талап кылынат. Community тарифинде мындай сурам **HTTP 402 «жаңылоо талап > кылынат»** (код `plan_limit`) кайтарат — караңыз: > [Лицензиялоо](/ky/v1.0/commercial/licensing). > [!NOTE] > **Einstein** эс тутум плагини **курулуштагы**: ал автоматтык түрдө > орнотулат, «Курулуштагы» значогун алып жүрөт жана алынып салынбайт же > токтотулбайт. ## SystemdDeployer агымы Капоттун астында **SystemdDeployer** төмөнкү кадамдарды аткарат: 1. Тандалган плагин үчүн **tarball жүктөп алат**. 2. Плагин жарыялаган **манифесттин `install[]` кадамдарын аткарат**. 3. Плагин үчүн **изоляцияланган systemd бирдигин түзөт**. 4. Кызмат соо деп билдиргенге чейин **`/healthz` сурамжылайт**. ```text 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** ичинде (Админ UI, же `POST /v1/admin/modules/catalog/sources`) кошумча булак кошо аласыз — мисалы, үчүнчү тараптын плагиндеринин **коомдук каталогун**. Шлюз баштоодо жана авто-жаңылоо аралыгында ар бир иштетилген булакты синхрондойт. - **Расмий булак** (биринчи тараптын модулдары) демейки боюнча бекитилген жана ишеничтүү — ал башка булактар тарабынан **кайра жазылбаган** өзүнчө объект. - **Жеке/коомдук булактар** оператор тарабынан кошулат; ар бир каталог жазуусунда `origin` болот, жана ал `origin` кол тамга кайсы анкорго каршы текшерилерин чечет (расмий → бекитилген ачкыч, жеке → ишеним дүкөнү). Коомдук каталогго жарыялоо үчүн [Плагинди жарыялоо](/ky/v1.0/marketplace/publishing) бөлүмүн караңыз. ## Ишеним модели жана бекитилген ачкыч Орнотуу плагиндин кол тамгасын анын булагы боюнча текшерет: - **расмий** → **ядрого бекитилген реестр ачкычына** каршы текшерилет. Демейки боюнча ишеничтүү, оператордун аракети керек эмес. - **жеке** (каптал-жүктөө) → **инстанциянын ишеним дүкөнүнө** каршы текшерилет; автордун ачкычы жүктөөдө оператор тарабынан бекитилет (бир чыкылдатуу). - **кол тамгасыз** → четке кагылат, dev режиминен башкасы (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, жергиликтүү иштеп чыгуу гана). ## Кол коюлган жаңылоолор Жаңылоо биринчи орнотуудагы **ошол эле кол тамга гейтин кайра иштетет**: жаңы версияга өткөндө кол тамга ошол эле ишеним анкоруна каршы кайра текшерилет. Жаңылоо текшерүүнү **айланып өтө албайт** — жаңылоо аркылуу ишенимди көтөрө албайсыз. ## Расмий белги жана рейтинг Web UI каталогунда AiHummerден келген плагиндер **Official** белгисин алып жүрөт жана биринчи орунда турат. Үчүнчү тараптын плагиндери белгисиз көрсөтүлүп, **жүктөп алуу санына** жараша иреттелет. Official желеги жазуунун `origin` (расмий) маанисинен алынат — аны манифестте колдон коюуга болбойт. ## Эми кайда - [Маркетплейстин обзору жана деңгээлдери](/ky/v1.0/marketplace/overview-tiers) — плагиндин үч деңгээли деген эмне. - [Плагин SDK](/ky/v1.0/marketplace/sdk) — `manifest.json` ушул бул жашоо цикли иштеткен `install[]` кадамдары менен. - [Плагинди жарыялоо](/ky/v1.0/marketplace/publishing) — жеке каптал-жүктөө жана коомдук реестр. - [Кодсуз интеграциялар](/ky/v1.0/marketplace/zero-code) — орнотула турган кызматсыз OpenAPI/MCP куралдарын кошуу.