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

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де бир баскыч менен болот, бирок ошол баскычтын артында детерминирленген, хостко тиешелүү тирүү цикл турат. Платформа плагинди жүктөп, анын жарыяланган орнотуу кадамдарын аткарат, көрсөтөт **sandboxталган systemd бирдиги**, жана плагин болгондо гана ден соолугу жакшы деп эсептелет. Ар бир орнотуу андан кийин өзүн өзү жаңыртып турат. ## Админ UI аркылуу бир баскыч менен орнотуу Сиз плагиндерди админ UI аркылуу орното жана башкарсаңыз болот, ал админ модулу API менен колдоого алынган: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Модулдун slug JSON суроо-сунушунун денесинде болушу керек, жолдо эмес: ```json { "slug": "einstein", "version": "" } ``` Кол менен эч нерсе туташтырылбайт: каталогдон плагин тандап, орнотуу баскычын чыкылдатыңыз, андан кийин жайгаштыруучу ишти колго алат. > [!NOTE] > Өзөк топтун сыртында канал бириктиргичти орнотуу (фатир Telegram гана) > иштөөчү мүнөздөмөнү талап кылат **Баштоочу**, **Бизнес** же **Ишкана** лицензия. > Жамааттык планда мындай суроо кайтарылат **HTTP 402 «жок кылуу талап кылынат»** > (код `plan_limit`) — кара [Лицензиялоо](/ky/v1.0/commercial/licensing). > [!NOTE] > Бул **Эйнштейн** эстутум плагини **түздөн-түз интеграцияланган**: ал автоматтык түрдө орнотулат, > «Кирип кеткен» белги тагылган жана ал алынбайт же токтотулбайт. ## SystemdDeployer агымы Капоттун астында **SystemdЖабдуучу** бул кадамдарды аткарат: 1. **Тарболду жүктө** таңдалган плагин үчүн. 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 хостто туруктуу. Плагиндер sandboxed systemd кызматтары катары жайгаштырылат > чыгаруу тарболунан — **эч качан Docker контейнерлери катары.** Эгер жол көрсөтүүчү сага айтса > «плагин контейнерин иштетүү» үчүн, бул AiHummer жөнүндө сүрөттөө эмес. ## Ден соолукту текшерүү /healthz менен Орнотуучу плагинди сурамдайт `/healthz` ишке киргизүүнү ийгилик деп жарыяламасынан мурун аяк чекит. Бул саламаттык дарбазасы бир баскыч менен орнотууну коопсуз кылат: бузулган же туура эмес конфигурацияланган плагин орнотуу учурунда кармалып, өндүрүштө кийин табылган эмес. ## Ар бир орнотуу үчүн автоматтык жаңыртуу Жаңыртуулар иштетилет **ар бир орнотуу үчүн**. Ар бир орнотулган плагин өзүнүн планы боюнча автоматтык түрдө жаңылана алат, ошондуктан плагиндерди учурдагы абалда кармоо үчүн ар бир жаңы версия каталогго чыккан сайын кол менен кайра орнотуу талап кылынбайт. Биринчилеп орнотуу үчүн колдонулган жүктөө → орнотуу кадамдары → рендердик блок → ден-соолукту текшерүү процесси жаңыртуу үчүн да колдонулат. > [!TIP] > Анткени авто-жаңыртуу ар бир орнотуу үчүн болуп, сиз айрым плагиндерди бекитип сактай аласыз > башкаларга акыркы окуяларды көзөмөлдөөгө мүмкүнчүлүгү берүү — ар бир орнотуу өзүнүн жашоо циклин башкарет. ## Көп булактуу каталог Каталог эми бир эле URL менен чектелбейт. **коомдук каталог** үчүнчү тарап плагиндери тиркемеге кошулган түрүндө келет **адаттагы булагы** (орнотулганда анын сатыгында) — сиз өзүңүз кошбойсуз. Ичинде **Плагиндер → Булагылар** (Админ UI, же `POST /v1/admin/modules/catalog/sources`) сиз өзүңүздүн кошумча булактарыңызды кошо аласыз. Шлюз ишке киргизилгенде жана авто-жаңылоо интервалында бардык күйгүзүлгөн булактарды синхрондоштурат. - Бул **расмий булак** (биринчи тарап модулдары) демейки боюнча шилтелет жана ишенимдүү болуп саналат — айрым объект болуп саналат **жооп кылынган эмес** Башка булактардан. - Бул **коомдук каталог** бул үрөк салынган дем алыш булак; **жеке булактар** бар оператор тарабынан кошулду. Ар бир каталогдун жазуу бир `origin`, жана ал `origin` кол тамганы кайсы якорь текшерерин чечет каршы (расмий → тиркелген ачкыч, жеке → ишеним дүкүгү). Жамааттык каталогго жарыялоо үчүн караңыз [Плагин жарыялоо](/ky/v1.0/marketplace/publishing). ## Ишеним модели жана бекитилген ачкыч Орнотуу плагиндин кол тамгасын анын булагы аркылуу текшерет: - **расмий** → каршы текшерилди **coreдо түзүлгөн реестр ачкычы**. Сакталып келген демейки, оператордун аракеттери жок. - **жеке** (жөк жүктөө) → текшерилген менен **мисал ишеним дүкөнү**; бул автордук ачкыч жүктөлгөндө оператор тарабынан бекитилет (бир чыкылдатуу менен). - **кол коюлбаган** → четке кагылган, тек гана иштеп чыгуучу режиминде (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, жергиликтүү өнүгүү менен гана). > [!WARNING] > **Коомчулуктун плагиндерин азыр орнотууга болбойт — бул байланыш үзгүлтүгү > эмес.** Коомчулук каталогуна кол коюлган ачкыч кайра чакырылды; жаңы ачкыч > чыкканга чейин кол тамга текшерүүсү мындай жазууларды четке кагат. Мындан > тышкары, үчүнчү тараптын коду азырынча сиздин серверде кызмат катары > иштетилбейт: обочолонгон аткаруу чөйрөсү пайда болгонго чейин өз жагында > иштеген жана тармак аркылуу туташкан интеграцияларга гана уруксат берилет. > > **Эмнени көрөсүз:** «орнотуу» баскычынан кийин кадимки «орнотулууда» билдирүүсү > чыгат, бирок плагин орнотулгандардын тизмесинде **эч качан пайда болбойт**. > Четке кагуунун себеби шлюз журналына жазылат — башкаруу панелинде > **Журналдар** бөлүмүн ачыңыз. > > **Бүгүн эмне иштейт:** > > - расмий каталогдогу **AiHummer плагиндери** — адаттагыдай орнотулат, аларда > башка, жарактуу кол тамга бар; > - **HTTP аркылуу MCP сервери** — иштеп чыгуусуз аспап булагы катары туташат, > код сиздин жагыңызда калат; > - **OpenAPI спецификациясы боюнча интеграция** — ошол эле, кызмат орнотпостон. > > Өз плагиниңизди кол менен жүктөө кол тамга текшерүүсүнөн өтөт, бирок **HTTP > аркылуу алыскы MCP** же OpenAPI интеграциясы катары гана иштейт; ушул сервердин > өзүндө кызмат катары иштетилиши керек болгон курама четке кагылат. ## Кол коюлган жаңыртуулар Жаңыртуу **анык кол тамгасын кайрадан иштетет** биринчи орнотуу болгондой: жаңы версияга которулганда кол тамга ошол эле ишеним алтынга каршы кайра текшерилет. Жаңыртуу **айланып өтө албайт** текшерүү — сиз жаңыртуу аркылуу ишенимди жогорулатуу мүмкүн эмес. ## Ресми знак жана даража Веб UI каталогунда, AiHummer компаниясынан плагиндер бар **Ресми** билерик жана биринчи даража. Үчүнчү тараптын плагиндери билериксиз көрсөтүлүп, сорттойт **жүктөө саны боюнча**. Ресми желек киргизүүнүн негизинде алынган `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 куралдарын кошуу орнотууга кызмат жок.