AiHummer
Türkmençe▾
GirmekŞahsy kabinet
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Marketpleýs we pluginler/Gurnama we täzelenmeler

Gurnama we täzelenmeler

v1.1.x · täzelendi 2026-07-05

AiHummer-de plagin gurmak administratiw UI-de bir gezek basmak bilen bolýar, ýöne şol basyşyň yzynda determinstik, myhman-özbek ömür sikli bar. Platforma plagini ýükläp, onuň yglan edilen gurnama ädimlerini işledýär, görkezýär sandbox edilen systemd birlik, we saglyk barlagyna jogap bereninde diňe plagin sagly diýlip hasaplaýar. Her bir gurnama soňra özüni özbaşdak täzeläp durýar.

Admin UI-dan bir basyş bilen gurnama

Siz plaginleri administrasiýa UI-den gurnap we dolandyryp bilersiňiz, olar administrasiýa modul API-si tarapyndan goldanylýar:

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

Modul slugi JSON sorag bedeninde bolýar, ýolyň içinde däl:

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

El bilen simtiklemek üçin hiç zat ýok: katalogdan bir plagin saýlaň, gurmak üçin basyň we ýerleşdiriji işleriň galan bölegini ýerine ýetirýär.

[!NOTE] Kanal birikdirijisini esasy toplumyň daşynda gurmak (diňe Telegram) aktiwlygy talap edýär Başlaýjy, Iş ýa-da Kärhana lisenziýa. Kömekdaşlyk meýilnamasynda şeýle bir soraňyz yzyna gaýtarýarlar HTTP 402 “daşky görnüşiň ýokarlandyrylmagy talap edilýär” (kod plan_limit) — görüň Lisans almak.

[!NOTE] Şu Eýnşteýn ýatlama plagin iň içine gurnalan: ol öz-özüne gurnalýar, “Gurlan” nyşanyny daşýar we aýrylmaýar ýa-da duruzylmaýar.

SystemdDeployer akymy

Motorunyň aşagynda SystemdÝerleşdiriji bu ädimleri ýerine ýetirýär:

  1. Tarball ýükle saýlanan plugin üçin.
  2. Manifesti işlediň install[] adamlar plugin tarapyndan yglan edildi.
  3. Sandkx sistemd bölümini işlediň plagin üçin.
  4. Sazlama /healthz hyzmat saglygyna degişli diýip hasabat berýänçä.
download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

Diňe haçan /healthz ýerine ýetýän wagtygyna gurnama işjeň hökmünde bellige alynýar — işlemän galýan plagin sessiz gurnalandygy hökmünde hasaplanmaýar.

Myhman-özine mahsus, öňünden çäklendirilen systemd — Docker däl

Her plagin şuňa laýyklykda işleýär özüniň sandboxed systemd hyzmaty. Konteýnerler ýok, Docker ýok, orkestrator ýok: plugin öz birlik, port we sandbox çäklendirmeleri bilen dolandyrylýan Linux hyzmatydyr, gurşawy gurşap alan beýleki programma üpjünçiligi ýaly systemd tarapyndan gözegçilik edilýär.

[!WARNING] AiHummer myhman-özüdür. Pluginler sandbox edilýän systemd hyzmatlary hökmünde ýerleşdirilýär çap edilýän tarballan baýramyndan — Docker konteýnerleri hökmünde asla. Eger bir ýolbaşçy size aýdýan bolsa “plugin konteýnerini işledmek” üçin, ol AiHummer-i düşündirmeýär.

/healthz bilen saglyk gözegçiligi

Ornaşdyrýan enjam plaginini sorag edýär /healthz Ulgam üstünlik bildirilmezden öňiçi nokady barlaýar. Bu saglyk geňeşmesi bir basyş bilen gurnamagy howpsuz edýän zat: bozulýan ýa-da nädogry sazlanan goşmaça programma gurnama wagtynda anyklanýar, önümçilikde soňumyzda däl.

Gurnamadan öň awtomatiki täzelik

Täzelikler dolandyrylýar gurnama başyna. Gurnalan her plugin öz göni tertibine görä awtomatiki ýagdaýda täzeläp bilýär, şonuň üçin pluginleri häzirki ýagdaýda saklamak üçin her gezek täze wersiýa kataloga gelende el bilen täzeden gurnamak gerek däl. Şeýle hem birinji gurnama üçin bolşy ýaly, täzelik üçin hem ýüklemek → gurmak ädimleri → enjamy görkezmek → saglyk barlagy akymy işledi.

[!TIP] Avtomatiki täzelenme her bir gurnama üçin bolandygy sebäpli, käbir plaginleri baglanyşykly holda saklap bilersiňiz başgalaryň iň täze täzelikleri yzarlamagyna ýol berýän — her bir gurnama öz ömri siklini dolandyrýar.

Köp çeşmeli katalog

Katalog indi bir URL bilen çäklenmeýär. jemagat katalogy üçünji tarap plaginleri gurnalan görnüşde çykýar başlangyç çeşme (gurnalmagynda öňünden ekilen) — ony özüňiz goşmaň. Içinde Pluginler → Çeşmeler (Admin UI, ýa-da POST /v1/admin/modules/catalog/sources) siz öz goşmaça çeşmeleriňizi goşup bilersiňiz. Geçelge her işjeň çeşmäni işe girizileninde we awto-täzelik intervalynda sinhronizirleýär.

  • Şu resmi çeşme (birinji tarap modullary) öňünden çäklendirilip we ynamdar hasaplanýar — ýeke bir obýekt bolup durýan uparlanmady başga çeşmeler arkaly.
  • Şu jemagat katalogy töwekgelçiligi bolmadyk standart çeşme bolup durýar; hususy çeşmeler bar operator tarapyndan goşuldy. Her katalog ýazgysy bar bir origin, we şonuň bilen origin gol goýmasynyň haýsy demirbag arkaly barlanýandygyny kesgitleýär garşy (resmi → bölünip goşa açar, hususy → ynam dükan).

Jemgyýet katalogyna neşir etmek üçin serediň Plugin-i neşir etmek.

Ýerleşdirilen açar bilen ynam modeli

Gurnama bir plagin beýanyny çeşmesi arkaly barlaýar:

  • resmi → … bilen barlagdan geçirildi ýadroda düwmelenen registriniň açary. Ygtybarly ädimleşdirilen ýagdaý, operator hiç hili hereket etmeýär.
  • şahsy (gapdaldan ýüklemek) → şol instansiýanyň ynam ammaryna görä tassyklanýar; awtor açary operator tarapyndan ýüklenerkä tassyk edilýär (bir basyş bilen).
  • imzasyz → redd edildi, diňe ösüş režiminde beýlekilerden başga (AIHUMMER_PLUGIN_DEV_UNSIGNED=1, diňe ýerli ösüş).

[!WARNING] Jemgyýet pluginlerini häzir gurnamak mümkin däl — bu aragatnaşyk näsazlygy däl. Jemgyýet katalogyna gol çeken açar yzyna alyndy; täze açar çykýança gol barlagy şeýle ýazgylary ret edýär. Mundan başga-da, üçünji tarapyň kody heniz siziň serweriňizde hyzmat hökmünde işledilmeýär: üzňeleşdirilen işleýiş gurşawy peýda bolýança diňe öz tarapynda işleýän we tor arkaly birleşýän integrasiýalara rugsat berilýär.

Näme görersiňiz: «gurna» düwmesinden soň adaty «gurnalýar» habary çykýar, ýöne plugin gurnalanlaryň sanawynda hiç haçan peýda bolmaýar. Ret edilmegiň sebäbi derwezäniň gündeligine ýazylýar — dolandyryş panelinde Gündelikler bölümini açyň.

Şu gün näme işleýär:

  • resmi katalogdaky AiHummer pluginleri — adatdakysy ýaly gurnalýar, olarda başga, hereket edýän gol bar;
  • HTTP arkaly MCP serweri — işläp taýýarlamazdan gural çeşmesi hökmünde birikdirilýär, kod siziň tarapyňyzda galýar;
  • OpenAPI spesifikasiýasy boýunça integrasiýa — şonuň ýaly, hyzmat gurnamazdan.

Öz pluginiňizi el bilen ýüklemek gol barlagyndan geçýär, ýöne diňe HTTP arkaly uzakdaky MCP ýa-da OpenAPI integrasiýasy hökmünde işlär; şol serwerde hyzmat hökmünde başladylmaly ýygnama ret edilýär.

Gol çekilen täzelenmeler

Täzelik şol bir gol möhüriniň gaýtadan işledilmegi ilkin gurulanda: täze wersiýany geçýän wagty, gol çekme ýene şol bir ynam ankary bilen barlanýar. Bir täzelik geçip bolmaýar barlag — siz täzelik arkaly ynamy ýokarlandyryp bilmerňiz.

Resmi nyşan we derejäniň

Web UI katalogynda, AiHummer-den gelen goşundylar bar Resmi belligi we derejäni ilkinji orunda goýmak. Üçünji tarap plaginler belliksiz görkezilýär we tertipleşdirilýär ýükleme sany boýunça. Resmi baýdak bir girizmäniň öňünden alnan origin (resmi) — bu manifestde el bilen kesgitläp bolmaýar.

Indi nire?