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

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-ге плагин орнату әкімші интерфейсінде бір рет басуды қажет етеді, бірақ сол басудың артында анықталған, хостқа тән өмірлік цикл бар. Платформа плагинді жүктеп алады, оның жарияланған орнату қадамдарын орындайды, көрсетеді **қорғалған systemd бірлігі**, және плагин тек денсаулық тексеру сұрағына жауап берген кезде ғана сау деп саналады. Әрбір орнату сол күйінде өздігінен жаңарып отырады. ## Әкімші интерфейсінен бір рет басу арқылы орнату Сіз плагиндерді әкімші UI арқылы орнатасыз және басқарасыз, ол әкімші модулі API арқылы қолдаулы: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Модульдің слагы жолда емес, JSON сұранысының денесінде көрсетіледі: ```json { "slug": "einstein", "version": "" } ``` Қолмен сым қосатын ештеңе жоқ: каталогтан плагинді таңдаңыз, орнатуға басыңыз, және орналастырушы бәрін өзі басқарады. > [!NOTE] > Арнаны қосқышты негізгі жиынтықтан тыс орнату (тек Telegram) > белсенді қажет **Бастауыш**, **Кәсіпкерлік** немесе **Кәсіпорын** лицензия. > Қауымдастық жоспарында мұндай сұраныс қайтарылады **HTTP 402 «жаңарту қажет»** > (код `plan_limit`) — қараңыз [Лицензиялау](/kk/v1.0/commercial/licensing). > [!NOTE] > Бұл **Эйнштейн** ес сақтау плагині **құрастырылған**: ол автоматты түрде орнатылады, > «Құрастырылған» белгісін көтереді және оны өшіруге немесе тоқтатуға болмайды. ## SystemdDeployer ағымы Мотордың астында **SystemdЖүктеуші** осы қадамдарды орындайды: 1. **Tarball жүктеу** таңдалған плагин үшін. 2. **Манифесті іске қосыңыз `install[]` қадамдар** плагин арқылы жарияланған. 3. **Sandboxed systemd бірлігін көрсету** плагин үшін. 4. **Сауалнама `/healthz`** қызметтің сау екенін хабарлағанға дейін. ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` Тек қана `/healthz` сәтті болса, орнату белсенді деп белгіленеді — іске қосылмайтын плагин үндемей орнатылды деп есептелмейді. ## Хосттық жергілікті, оқшауланған systemd — Docker емес Әр плагин ретінде жұмыс істейді **өзінің оқшауланған systemd қызметі**. Контейнерлер жоқ, Docker жоқ, оркестратор жоқ: плагин – бұл өзінің бірлігі, порты және құмқорған шектеулері бар, systemd арқылы басқа орнатулар сияқты бақыланатын басқарылатын Linux қызметі. > [!WARNING] > AiHummer хост-тік. Плагиндер жүйеленген sandboxed systemd қызметтері ретінде орналастырылады > шархталған шығарылымнан — **ешқашан Docker контейнерлері ретінде.** Егер бір жолсерік саған айтса > «плагин контейнерін іске қосу» үшін, бұл AiHummer туралы сипаттамайды. ## /healthz арқылы денсаулықты тексеру Орнатушы плагинді сұрайды `/healthz` сәттілікті жарияламастан бұрын соңғы нүкте. Бұл денсаулық қақпасы бір рет басу арқылы орнатуды қауіпсіз етеді: бұзылған немесе дұрыс конфигурацияланбаған плагин орнату кезінде ұсталып, кейін өндірісте табылмайды. ## Орнату алдында автоматты жаңарту Жаңартулар өңделеді **орнату үшін**. Әрбір орнатылған плагин өз кестесіне сәйкес өздігінен жаңартылуы мүмкін, сондықтан плагиндерді өзектендіру үшін әр жаңа нұсқа каталога жеткен сайын қолмен қайта орнатудың қажеті жоқ. Жаңарту үшін де алғашқы орнату сияқты жүктеу → орнату қадамдары → рендер бірлігі → денсаулық тексеру ағыны жүреді. > [!TIP] > Өйткені автожаңарту әр орнату үшін болады, сіз кейбір плагиндерді орнату кезінде бекіте аласыз > басқаларға соңғыларын қадағалауға мүмкіндік беру — әрбір орнату өз өмірлік кезеңін басқарады. ## Көп көзді каталог Каталог енді бір URL мекенжайымен шектелмейді. Үшінші тарап плагиндеріне арналған **қауымдастық каталогы** кірістірілген **әдепкі дереккөз** ретінде жеткізіледі (орнату кезінде енгізіледі), сондықтан оны өзіңіз қоспайсыз. **Плагиндер → Дереккөздер** бөлімінде (әкімші интерфейсі немесе `POST /v1/admin/modules/catalog/sources`) қосымша дереккөздеріңізді қоса аласыз. Шлюз барлық қосылған дереккөздерді іске қосылғанда және автоматты жаңарту аралығымен синхрондайды. - Бұл **ресми дереккөз** (бірінші тарап модульдері) әдепкі бойынша бекітілген және сенімді болып табылады — бөлек нысан болып табылатын **жазылмаған** басқа дереккөздер арқылы. - Бұл **қауымдастық каталогы** бұршақтанылған әдепкі көз болып табылады; **жеке дереккөздер** болады оператор қосқан. Әр каталог жазбасының бір `origin`, және ол `origin` қолтаңбаның қай анкерде расталатынын шешеді қарсы (ресми → тіркелген кілт, жеке → сенім дүкені). Қауымдастық каталогына жариялау үшін қараңыз [Плагинді жариялау](/kk/v1.0/marketplace/publishing). ## Сенім үлгісі және бекітілген кілт Орнату плагиннің қолтаңбасын оның көздеріне қарап тексереді: - **ресми** → ... қарсы тексерілді **ядроға бекітілген тіркеу кілті**. Сенім артылған әдепкі, ешқандай оператор әрекеті жоқ. - **жеке** (жанама жүктеу) → тексерілді қарсы **оқиға сенім қоймасы**; бұл автор кілті жүктеу кезінде оператор арқылы мақұлданады (бір рет басу). - **сансыз** → қабылданбады, тек дамушы режимінде (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, тек жергілікті дамуға арналған). > [!WARNING] > **Қоғамдастық плагиндерін қазір орнату мүмкін емес — бұл байланыс ақауы емес.** > Қоғамдастық каталогына қол қойған кілт кері қайтарылды; жаңа кілт шыққанға > дейін қолтаңба тексерісі мұндай жазбаларды қабылдамайды. Бұдан бөлек, үшінші > тарап коды әзірге сіздің серверіңізде қызмет ретінде іске қосылмайды: > оқшауланған орындау ортасы пайда болғанша тек өз жағында жұмыс істейтін және > желі арқылы қосылатын интеграцияларға рұқсат берілген. > > **Не көресіз:** «орнату» түймесінен кейін әдеттегі «орнатылуда» хабары > шығады, бірақ плагин орнатылғандар тізімінде **ешқашан пайда болмайды**. Бас > тарту себебі шлюз журналына жазылады — басқару тақтасында **Журналдар** > бөлімін ашыңыз. > > **Бүгін не жұмыс істейді:** > > - ресми каталогтағы **AiHummer плагиндері** — әдеттегідей орнатылады, оларда > басқа, жарамды қолтаңба бар; > - **HTTP арқылы MCP сервері** — әзірлеусіз құрал көзі ретінде қосылады, код > сіздің жағыңызда қалады; > - **OpenAPI сипаттамасы бойынша интеграция** — сол сияқты, қызмет орнатпай. > > Өз плагиніңізді қолмен жүктеу қолтаңба тексерісінен өтеді, бірақ тек **HTTP > арқылы қашықтағы MCP** немесе OpenAPI интеграциясы ретінде жұмыс істейді; осы > серверде қызмет ретінде іске қосылуы тиіс құрастырма қабылданбайды. ## Қол қойылған жаңартулар Жаңарту **сол қолтаңба қақпасын қайта іске қосады** бірінші орнату тәрізді: жаңа нұсқаға көшкенде қолтаңба сол сенім тіреуігіне қарсы қайта тексеріледі. Жаңарту **асуы мүмкін емес** тексеру — жаңарту арқылы сенімділікті арттыра алмайсыз. ## Ресми белгі және дәрежесі Веб интерфейс каталогында AiHummer плагиндері бар **Ресми** белгішесі мен дәрежесі бірінші. Үшінші тарап плагиндері белгішесіз көрсетіледі және сұрыпталады **жүктеу саны бойынша**. Ресми ту кірістің негізінде алынған `origin` (ресми) — бұл манифестацияда қолмен орнатылмайды. ## Келесі қайда - [Нарық алаңының шолуы және деңгейлері](/kk/v1.0/marketplace/overview-tiers) — не деген? үш плагин деңгейі бар. - [Плагин SDK](/kk/v1.0/marketplace/sdk) — бұл `manifest.json` кімнің `install[]` осы өмірлік цикл қандай қадамдардан өтеді. - [Плагинді жариялау](/kk/v1.0/marketplace/publishing) — жеке тараптан жүктеу және жеке кабинет арқылы қауымдастық жариялау. - [Кодсыз интеграциялар](/kk/v1.0/marketplace/zero-code) — OpenAPI/MCP құралдарын қосу орнатуға ешқандай қызмет жоқ.