Аинсталл насгьы арҿыцрақәа

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 аҟны зныԥшь-нҟәаԥшьрак ауп, аха убри анҟәаԥшьра аҵыхәала иҟоуп идетерминироу, host-native аԥсҭазаара аамҭа. Аплатформа аплагин доунлоуд ҟанаҵоит, иарбоу аинсталл ашьаҿақәа нанагӡоит, **sandbox-зныҟәоу systemd аиԥшра** аргылоит, насгьы аплагин агәабзиара агәаҭара иаҭак анаиҭалак анаҩс мацара «игәабзиоуп» ҳәа иԥхьаӡоит. Убри ашьҭахь аинсталл алкаа зегьы хазы иха ааигӡара иаанхоит. ## Админ UI аҟынтә зныԥшь-нҟәаԥшьрала аинсталл Аплагинқәа шәыргылоит насгьы шәынапхгоит админ UI аҟынтә, иара admin-модуль API ала иршьаҟәырҟьоу: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Амодуль слаг ишьҭуп JSON-запрос ахы аҟны, амҩа аҟны акәымкәа: ```json { "slug": "einstein", "version": "" } ``` Анапала ишьҭырхтәу акгьы ыҟаӡам: каталог аҟынтә аплагин алху, «инсталл» ажәа ианапажьуа, насгьы адеплоер аусура инапы иацәкуеит. > [!NOTE] > Ахадатә набор (Telegram, web, web-виджет) адаҟьа акәымкәа даҽа > акана-коннектор аинсталл азы иҭаху активтә **Starter**, **Business** ма > **Enterprise** алицензиа. Community атариф аҟны абри адҵа иаанагоит **HTTP > 402 «upgrade required»** (акод `plan_limit`) — шәахәаԥш > [Алицензиара](/ab/v1.0/commercial/licensing). > [!NOTE] > **Einstein** агәынкылара аплагин — **ишьаҭоуп**: иара автоматла иргылоуп, > «Ишьаҭоу» бҽаджь имоуп насгьы аныхра ма аанкылара ауӡом. ## SystemdDeployer аҟазшьамҭа Иахьыршьҭоу **SystemdDeployer** абарҭ ашьаҿақәа нанагӡоит: 1. Алху аплагин азы **тарбол доунлоуд ҟаҵара**. 2. Аплагин иарбоу **манифест `install[]` ашьаҿақәа рынагӡара**. 3. Аплагин азы **sandbox-зныҟәоу systemd аиԥшра аргылара**. 4. Асервис «игәабзиоуп» ҳәа ианиашьалакь аҟынӡа **`/healthz` азԥшра**. ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` `/healthz` ииашазар мацара ауп аинсталл active ҳәа иазышьо — изгәабзиамкәа иҟало аплагин бжьаратәла иргылоуп ҳәа иԥхьаӡахом. ## Host-native, sandbox-зныҟәоу systemd — Docker акәымкәа Аплагин зегьы **ихатәы sandbox-зныҟәоу systemd асервис** ҳасабла ауеит. Контейнерқәа ыҟаӡам, Docker ыҟаӡам, оркестратор ыҟаӡам: аплагин — иара ихатәы аиԥшра, апорт насгьы асандбокс аԥкрақәа змоу, инапхгаз Linux-асервис, аинсталл егьырҭ ахәҭа реиԥш systemd ала иныҟәо. > [!WARNING] > AiHummer — host-native. Аплагинқәа аррыхратә tarball аҟынтә > sandbox-зныҟәоу systemd асервисқәа ҳасабла идеплоуп — **зынагьы > Docker-контейнерқәа ҳасабла акәымкәа.** Иахьынтагыла адырраҭара «аплагин > контейнер унагӡа» ишәоуп ҳәа иуҳәозар, уи AiHummer иаҵанакуам. ## /healthz ала агәабзиаратә гейт Аиааира анаиашьаанӡа адеплоер аплагин `/healthz` эндпоинт азԥшуеит. Абри агәабзиаратә гейт ауп зныԥшь-нҟәаԥшьрала аинсталл ишәарҭам изызуа: иҟәымтәу ма ииашамкәа иеиҿкааз аплагин аинсталлраан иркуп, продукциаҟны нас иубаауам. ## Аинсталл алкаа зегьы рзы автоматрҿыцра Арҿыцрақәа **аинсталл алкаа зегьы рзы хазы** имҩаԥысуеит. Иргылоу аплагин зегьы хазы иха аграфик ала автоматла ирҿыцыр алшоит, убри аҟнытә аплагинқәа ҿыцлатәи рҭагылазаашьаҟны рымазаразы каталог аҟны ҿыц аверсиа аналазаало азныкызны анапала аиҭаинсталл аҭахӡам. Актәи аинсталл аан имҩаԥысуа акаԥшь доунлоуд → install[] ашьаҿақәа → аиԥшра аргылара → агәабзиара агәаҭара аҟазшьамҭа заԥхьоит арҿыцраан еиԥш. > [!TIP] > Автоматрҿыцра аинсталл алкаа зегьы рзы хазы имҩаԥысуа азы, шәылшоит аплагин > алкаак ак ишакьы иаанханы, егьырҭ иҵыхәтәи аверсиа иацҵаны иудкылар — > аинсталл алкаа зегьы хазы иха аԥсҭазаара аамҭа инапхгоит. ## Каталог зхыԥхьаӡак-ада Каталог зныкны URL ак ахь иҭакым. **Plugins → Sources** аҟны (Admin UI, ма `POST /v1/admin/modules/catalog/sources`) шәылшоит еиҳа даҽа ахыԥхьаӡак иацҵара — ҿырԥшла, аҩныҟатәи аплагинқәа р**community-каталог**. Агейтуэй иаартоу ахыԥхьаӡакқәа зегьы еиҿкаауеит астарт аан насгьы автоматрҿыцра аамҭа-лагала аан. - **Официалтә ахыԥхьаӡак** (актәи-напала имодульқәа) пиннуп насгьы бжьаратәла аҵабыргоуп — иара хазы аобиект, иара **даҽа ахыԥхьаӡакқәа ала ирыцқьаӡом**. - **Хазы/аҩныҟатәи ахыԥхьаӡакқәа** оператор ала иацҵоуп; акаталог анҭыҵхә зегьы `origin` амоуп, насгьы убри `origin` ауп иазышьо, иарбан аҵабыргратә анкар инанашьало апидпис (official → пиннуп акьыс, private → атрест ацәахьа). Community-каталог аҟны акьыԥхьразы, шәахәаԥш [Аплагин акьыԥхьра](/ab/v1.0/marketplace/publishing). ## Атрест амодель насгьы ипиннуп акьыс Аинсталлраан аплагин анышьҭ ауроу аналац иаԥкны ишьоуеит: - **official** → **core аҟны ипиннуп акьыс** иадгыланы ишьоуеит. Бжьаратәла иуадгылоуп, оператор аусура ыҟаӡам. - **private** (side-load) → **инстанс атрест ацәахьа** иадгыланы ишьоуеит; аҩыза акьыс оператор ала ажәуыргалараан ишьоуп (зныԥшь-нҟәаԥшьырла). - **unsigned** → ирӷьоуп, dev-режим ада (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, аҩныҟатәи аус ауразы мацара). ## Анышьҭ зуоу арҿыцрақәа Арҿыцра **зныкатәи аинсталл еиԥш убри инышьҭ гейт еиҭанагӡоит**: ҿыц аверсиахь ианиасуа, анышьҭ еиҭашьоуеит убри атрест аналац иадгыланы. Арҿыцра ала **атрест ашьоура шьҭыхгазаар ауӡом** — арҿыцра ала атрест аҩаӡара ҳараку иҟалом. ## Official абеи насгьы аиерархиа Web UI акаталог аҟны, AiHummer иаплагинқәа **Official** абеи рымоуп насгьы актәиқәас иҟоуп. Аҩныҟатә аплагинқәа абеи рымаӡакәа иаарԥшуп насгьы **арыжәрақәа рхыԥхьаӡара ала** еиҿкаауп. Official акәашаҩ анҭыҵхә `origin` (official) аҟынтә иацлоуп — manifest аҟны напала ишьҭырхыуӡом. ## Уаҩ узаауеи - [Маркетплейс аиҿкаашьа насгьы аҵыхәтәиқәа](/ab/v1.0/marketplace/overview-tiers) — хԥа аплагин аҵыхәтәиқәа ианрыхәҭаны. - [Аплагин SDK](/ab/v1.0/marketplace/sdk) — `manifest.json`, иара `install[]` ашьаҿақәа абри аԥсҭазаара аамҭа нанагӡо. - [Аплагин акьыԥхьра](/ab/v1.0/marketplace/publishing) — хазы side-load насгьы ауаажәларратә регистр. - [Кодыда аинтеграциақәа](/ab/v1.0/marketplace/zero-code) — иҭагалатәу асервис ыҟамкәа OpenAPI/MCP амаҭәахәқәа ацҵара.