Gurnamak we täzelenmeler

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-de plugin gurnamak admin UI-de bir basyşdyr, ýöne şol basyşyň aňyrsynda determinirlenen, host-native ömri ýatyr. Platforma plugini ýükleýär, onuň yglan edilen gurnama ädimlerini ýerine ýetirýär, **izolirlenen systemd birligini** döredýär we plugini diňe ol saglyk barlagyna jogap berenden soň sagdyn hasaplaýar. Her gurnama soňra özüni özbaşdak täzeläp durýar. ## Admin UI-den bir basyşda gurnamak Plugin gurnamagy we dolandyrmagy admin UI-den amala aşyrýarsyňyz, ol admin modul API tarapyndan goldanylýar: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Modul slug-y ýoluň özünde däl-de, JSON haýyş göwresinde berilýär: ```json { "slug": "einstein", "version": "" } ``` El bilen hiç zat birikdirmegiň zerurlygy ýok: katalogdan plugin saýlaň, gurnamaga basyň, soňra deployer dolandyrmagy öz üstüne alýar. > [!NOTE] > Esasy topluma girmeýän kanal konnektoryny (Telegram, web, web widжeti) > gurnamak işjeň **Starter**, **Business** ýa-da **Enterprise** ygtyýarnamasyny > talap edýär. Community tarifinde şeýle haýyş **HTTP 402 "upgrade required"** > (`plan_limit` kody) gaýtarýar — serediň [Ygtyýarnama](/tk/v1.0/commercial/licensing). > [!NOTE] > **Einstein** ýat plagini **içki**: ol her kärendar üçin awtomatiki gurnalýar, > «Built-in» belligini göterýär we aýrylyp ýa-da saklanyp bilinmez. ## SystemdDeployer akymy Içki tarapda **SystemdDeployer** şu ädimleri ýerine ýetirýär: 1. Saýlanan plugin üçin **tarball ýükleýär**. 2. Plugin tarapyndan yglan edilen **manifest `install[]` ädimlerini ýerine ýetirýär**. 3. Plugin üçin **izolirlenen systemd birligini döredýär**. 4. Hyzmat sagdyn diýip habar berýänçä **`/healthz` barlap durýar**. ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` Diňe `/healthz` üstünlikli bolanda gurnama işjeň diýlip bellenilýär — işläp başlap bilmedik plugin sessiz-üýnsüz gurnaldy hasaplanmaýar. ## Host-native, izolirlenen systemd — Docker däl Her plugin **öz izolirlenen systemd hyzmaty hökmünde** işleýär. Konteýnerler ýok, Docker ýok, orkestrator ýok: plugin galan gurnama ýaly systemd tarapyndan gözegçilik edilýän, öz birligi, porty we izolýasiýa çäklendirmeleri bolan dolandyrylýan Linux hyzmatydyr. > [!WARNING] > AiHummer host-native. Pluginler reliz tarball-dan izolirlenen systemd hyzmatlary > hökmünde ýerleşdirilýär — **hiç haçan Docker konteýnerleri hökmünde däl.** Eger gollanma size > "plugin konteýnerini işlet" diýse, ol AiHummer-i suratlandyrmaýar. ## /healthz bilen saglyk derwezesi Deployer üstünligi yglan etmezden öň pluginiň `/healthz` ahyrky nokadyny barlaýar. Bu saglyk derwezesi bir basyşly gurnamany howpsuz edýär: döwülen ýa-da nädogry sazlanan plugin önümçilikde soňra ýüze çykarylman gurnamada tutulýar. ## Her gurnama üçin awto-täzelenme Täzelenmeler **her gurnama boýunça** dolandyrylýar. Her gurnalan plugin öz tertibinde özüni awto-täzeläp bilýär, şonuň üçin pluginleri täze ýagdaýda saklamak her gezek kataloga täze wersiýa gelende el bilen gaýtadan gurnamagy talap etmeýär. Şol ýükleme → gurnama ädimleri → birligi döretmek → saglyk barlagy akymy täzelenme üçin hem ilkinji gurnama ýaly işleýär. > [!TIP] > Awto-täzelenme her gurnama boýunça bolany üçin, käbir pluginleri berkidip saklap, beýlekilere > iň soňkysyny yzarlamaga rugsat berip bilersiňiz — her gurnama öz ömrüni özi dolandyrýar. ## Köp çeşmeli katalog Katalog indi ýeke URL bilen baglanyşykly däl. **Plugins → Sources** (Admin UI, ýa-da `POST /v1/admin/modules/catalog/sources`) bölüminde goşmaça çeşme goşup bilersiňiz — meselem, üçünji tarap pluginleriniň **jemgyýet katalogyny**. Gateway her işjeňleşdirilen çeşmäni başlanmagynda we awto-täzelenme aralygynda sinhronlaýar. - **Resmi çeşme** (birinji tarap modulleri) berkidilen we deslapky ýagdaýda ynamly — beýleki çeşmeler tarapyndan **üýtgedilmeýän** aýratyn obýekt. - **Hususy/jemgyýet çeşmeleri** operator tarapyndan goşulýar; her katalog ýazgysynyň `origin`-i bar we şol `origin` gol haýsy lybas garşysynda barlanjagyny çözýär (resmi → berkidilen açar, hususy → ynam dükany). Jemgyýet katalogyna çap etmek üçin [Plugin çap etmek](/tk/v1.0/marketplace/publishing) bölümine serediň. ## Ynam modeli we berkidilen açar Gurnama pluginiň goluny onuň çeşmesi boýunça barlaýar: - **official** → **özekde berkidilen registr açary** garşysynda barlanýar. Deslapky ýagdaýda ynamly, operator hereketi gerek däl. - **private** (side-load) → **gurama ynam dükany** garşysynda barlanýar; awtor açary ýüklenende operator tarapyndan tassyklanýar (bir basyş). - **unsigned** → ret edilýär, dev rejesinden başga (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, diňe ýerli işläp düzme üçin). ## Gol çekilen täzelenmeler Täzelenme ilkinji gurnama bilen **şol bir gol derwezesini gaýtadan işledýär**: täze wersiýa geçende gol ýene şol bir ynam lybasy garşysynda barlanýar. Täzelenme barlagy **aýlap geçip bilmeýär** — täzelenme arkaly ynamy ýokarlandyryp bilmersiňiz. ## Resmi nyşany we tertipleşdirme Web UI katalogynda AiHummer-den gelen pluginler **Official** nyşanyny göterýär we ilkinji tertipleşýär. Üçünji tarap pluginleri nyşansyz görkezilýär we **ýüklemeleriň sany boýunça** tertipleşýär. Official baýdagy ýazgynyň `origin`-inden (official) alynýar — ony manifestde el bilen goýup bolmaýar. ## Indiki ädim - [Marketplace umumy syn we derejeler](/tk/v1.0/marketplace/overview-tiers) — üç plugin derejesiniň näme bolup biljekdigi. - [Plugin SDK](/tk/v1.0/marketplace/sdk) — bu ömri işledýän `install[]` ädimleri bolan `manifest.json`. - [Plugin çap etmek](/tk/v1.0/marketplace/publishing) — hususy side-load we jemgyýetçilik registri. - [Kodsuz integrasiýalar](/tk/v1.0/marketplace/zero-code) — gurnaýan hyzmaty bolmazdan OpenAPI/MCP gurallaryny goşmak.