Quraşdırma və yeniləmələr

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-də bir plaqini quraşdırmaq admin istifadəçi interfeysində tək bir klikdir, amma həmin klik arxasında deterministik, ev sahibi-təbii bir həyat dövrü var. Platforma plaqini yükləyir, onun elan edilmiş quraşdırma addımlarını işləyir, göstərir **sandboxlaşdırılmış systemd vahidi**, və plagini yalnız sağlamlıq yoxlamasına cavab verdikdə sağlam hesab edir. Hər quraşdırma sonra özünü müstəqil şəkildə güncəlləyir. ## İdarəetmə interfeysindən bir kliklə quraşdırma Siz plaginləri idarəçi UI-dən quraşdırır və idarə edirsiniz, bu da idarəçi modul API tərəfindən dəstəklənir: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Modul slugu JSON sorğu bədənində olur, yolun özündə deyil: ```json { "slug": "einstein", "version": "" } ``` Əl ilə qoşulacaq heç nə yoxdur: kataloqdan bir əlavə seçin, quraşdırmaq üçün klikləyin və yerləşdirici davamını idarə edəcək. > [!NOTE] > Kanal birləşdiricisini əsas dəstdən kənarda quraşdırmaq (yalnız Telegram) > aktiv tələb edir **Başlanğıc**, **Biznes** və ya **Müəssisə** lisenziya. > İcma planında belə bir sorğu geri dönür **HTTP 402 "yüksəltmə tələb olunur"** > (kod `plan_limit`) — bax [Lisenziyalaşdırma](/az/v1.0/commercial/licensing). > [!NOTE] > O **Einşteyn** yaddaş əlavəsi olur **daxili**: o, avtomatik olaraq quraşdırılır, > “Daxili” nişanını daşıyır və çıxarıla və ya dayandırıla bilməz. ## SystemdDeployer axını Qapağın altında **SystemdDeployer** bu addımları yerinə yetirir: 1. **Tar faylını yüklə** seçilmiş plagin üçün. 2. **Manifesti işlədin `install[]` addımlar** plugin tərəfindən elan edilmişdir. 3. **Sandbox edilmiş systemd vahidini işlədin** plagin üçün. 4. **Sorğu `/healthz`** xidmət sağlam olduğunu bildirənə qədər. ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` Yalnız o zaman `/healthz` müvəffəq olursa, quraşdırma aktiv olaraq işarələnir — başlamayan bir plugin səssizcə quraşdırılmış hesab edilmir. ## Ev sahibi-yerli, qumluq sistemd — Docker deyil Hər bir plugin olaraq işləyir **özünə məxsus sandboxed systemd xidməti**. Konteyner yoxdur, Docker yoxdur, orkestrator yoxdur: bir plugin onun öz vahidi, portu və səndbox məhdudiyyətləri olan idarə olunan Linux xidmətidir, quraşdırmanın qalan hissəsi kimi systemd tərəfindən nəzarət olunur. > [!WARNING] > AiHummer yerli hostdur. Pluginlər sandboxed systemd xidmətləri kimi yerləşdirilir > buraxılış tarbolundan — **heç vaxt Docker konteynerləri kimi.** Əgər bir bələdçi sizə deyirsə > "plugin konteynerini işlətmək" üçün, bu AiHummer-i təsvir etmir. ## Sağlamlıq yoxlaması /healthz ilə Yerinə yetirici plaqinin sorğusunu həyata keçirir `/healthz` uğuru elan etməzdən əvvəl son nöqtə. Bu sağlamlıq qapısı bir kliklə quraşdırmanı təhlükəsiz edən şeydir: qırıq və ya yanlış konfiqurasiya edilmiş bir plagin quraşdırma zamanı aşkar edilir, sonradan istehsalda deyil. ## Quraşdırmadan əvvəl avtomatik yeniləmə Yeniləmələr idarə olunur **quraşdırma başına**. Hər quraşdırılmış plugin öz cədvəlinə uyğun olaraq avtomatik yenilənə bilər, buna görə də pluginlərin aktuallığını saxlamaq üçün hər dəfə yeni versiya kataloqa daxil olduqda əl ilə yenidən quraşdırma tələb olunmur. Eyni yükləmə → quraşdırma addımları → render bölməsi → sağlamlıq yoxlaması axını həm yeniləmə, həm də ilkin quraşdırma üçün işləyir. > [!TIP] > Çünki avtomatik yeniləmə hər quraşdırma üçün nəzərdə tutulub, bəzi əlavələri sabit saxlayarkən > başqalarının son yenilikləri izləməsinə imkan vermək — hər quraşdırma öz dövrünü idarə edir. ## Çoxmənbəli kataloq Kataloq artıq tək URL-ə bağlı deyil. **icma kataloqu** üçüncü tərəf plaginləri daxili olaraq göndərilir **default mənbə** (quraşdırma zamanı toxumlanmışdır) — onu özünüz əlavə etmirsiniz. Daxilində **Plaginlər → Mənbələr** (Admin İstifadəçi İnterfeysi, və ya `POST /v1/admin/modules/catalog/sources`) siz öz əlavə mənbələrinizi əlavə edə bilərsiniz. Qapı açıldığı zaman və avtomatik yenilənmə intervalında hər aktivləşdirilmiş mənbə sinxronizasiya olunur. - O **rəsmi mənbə** (birinci tərəf modulları) standart olaraq möhkəmləndirilmiş və etibarlı sayılır — ayrı bir obyekt olan **üstünə yazılmayıb** digər mənbələrə görə. - O **icma kataloqu** təhkim edilmiş standart mənbədir; **şəxsi mənbələr** dir əməliyyatçı tərəfindən əlavə edildi. Hər bir kataloq daxilində bir `origin`, və bu `origin` imzanın hansı demir tərəfindən təsdiqlənəcəyinə qərar verir əleyhinə (rəsmi → yapışdırılmış açar, şəxsi → etibar mağazası). İcma kataloquna nəşr üçün baxın [Plugin dərc etmək](/az/v1.0/marketplace/publishing). ## Etibar modeli və bərkidilmiş açar Quraşdırma bir plaqinin imzasını onun mənbəsinə görə yoxlayır: - **rəsmi** → qarşı təsdiqləndi **registr reyestri əsasda bərkidilib**. tərəfindən etibar edilir standart, operator hərəkəti yoxdur. - **şəxsi** (yan-yükləmə) → qarşı təsdiqləndi **nümunə etibar mağazası**; Müəllif açarı yükləmə zamanı operator tərəfindən təsdiqlənir (bir kliklə). - **imzalanmamış** → rədd edildi, yalnız inkişaf rejimində (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, yalnız yerli inkişaf). > [!WARNING] > **İcma plaginlərini hazırda quraşdırmaq mümkün deyil — bu, əlaqə nasazlığı > deyil.** İcma kataloqunu imzalayan açar geri çağırılıb; yeni açar buraxılana > qədər imza yoxlaması belə qeydləri rədd edir. Bundan asılı olmayaraq, üçüncü > tərəf kodu hələ sizin serverinizdə xidmət kimi işə salınmır: təcrid olunmuş icra > mühiti yaranana qədər yalnız öz tərəfində işləyən və şəbəkə üzərindən qoşulan > inteqrasiyalara icazə verilir. > > **Nə görəcəksiniz:** «quraşdır» düyməsindən sonra adi «quraşdırılır» mesajı > çıxır, lakin plagin quraşdırılmışlar siyahısında **heç vaxt görünmür**. İmtina > səbəbi şlüz jurnalına yazılır — idarə panelində **Jurnallar** bölməsini açın. > > **Bu gün nə işləyir:** > > - rəsmi kataloqdakı **AiHummer plaginləri** — həmişəki kimi quraşdırılır, > onlarda başqa, etibarlı imza var; > - **HTTP üzərindən MCP serveri** — proqramlaşdırma olmadan alət mənbəyi kimi > qoşulur, kod sizin tərəfinizdə qalır; > - **OpenAPI spesifikasiyası üzrə inteqrasiya** — eyni şey, quraşdırılacaq > xidmət olmadan. > > Öz plagininizin əl ilə yüklənməsi imza yoxlamasından keçir, lakin yalnız **HTTP > üzərindən uzaq MCP** və ya OpenAPI inteqrasiyası kimi işləyəcək; həmin serverdə > xidmət kimi başladılmalı olan yığım rədd edilir. ## İmzalanmış yeniləmələr Bir yeniləmə **eyni imza qapısını yenidən işlədir** ilk quraşdırma kimi: yeni versiyaya keçərkən imza yenidən eyni etibar nöqtəsinə qarşı yoxlanılır. Yeniləmə **keçmək olmaz** yoxlama — bir yeniləmə vasitəsilə etibarı artıra bilməzsən. ## Rəsmi nişan və reytinq Veb İstifadəçi İnterfeysi kataloqunda, AiHummer-dən olan plaginslər daşıyır **Rəsmi** nşan və rütbə ilk. Üçüncü tərəf plaginləri nşansız göstərilir və sıralanır **yükləmə sayı üzrə**. Rəsmi bayraq bir girişi çıxış nöqtəsi kimi götürür `origin` (rəsmi) — bu, manifestdə əl ilə təyin edilə bilməz. ## Növbəti haradır - [Marketplace icmalı və səviyyələri](/az/v1.0/marketplace/overview-tiers) — nə üç plugin səviyyəsi var. - [Plugin SDK](/az/v1.0/marketplace/sdk) — `manifest.json` kimə aid `install[]` bu həyat dövrü hansı addımlar üzrə işləyir. - [Plugin dərc etmək](/az/v1.0/marketplace/publishing) — özəl yan yükləmə və şəxsi kabinet vasitəsilə icma nəşri. - [Sıfır-kod inteqrasiyaları](/az/v1.0/marketplace/zero-code) — OpenAPI/MCP alətləri əlavə et quraşdırılacaq xidmət yoxdur.