Instalare și actualizări

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

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

download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

Instalarea unui plugin în AiHummer se face cu un singur clic în interfața de administrare, dar în spatele acelui clic există un ciclu de viață determinist și nativ pentru gazdă. Platforma descarcă pluginul, rulează pașii de instalare declarați, redă un **unitate systemd izolată**, și consideră pluginul sănătos doar atunci când răspunde la un control de stare. Fiecare instalare apoi se menține actualizată singură. ## Instalare cu un singur clic din interfața de administrare Instalezi și gestionezi pluginurile din interfața de administrare, care este susținută de API-ul modulului de administrare: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Slugul modulului se introduce în corpul cererii JSON, nu în cale: ```json { "slug": "einstein", "version": "" } ``` Nu este nimic de conectat manual: alege un plugin din catalog, fă clic pe instalare, iar instrumentul de implementare preia controlul. > [!NOTE] > Instalarea unui conector de canal în afara setului de bază (doar Telegram) > necesită un activ **Starter**, **Afaceri** sau **Întreprindere** licență. > Pe planul Comunității, o astfel de solicitare returnează **HTTP 402 "actualizare necesară"** > (cod `plan_limit`) — vezi [Licențiere](/ro/v1.0/commercial/licensing). > [!NOTE] > **Einstein** plugin de memorie este **încorporat**: se instalează automat, > poartă o insignă „Încorporată” și nu poate fi eliminată sau oprită. ## Fluxul SystemdDeployer Sub capotă **DeploratorSystemd** efectuează acești pași: 1. **Descarcă un fișier tar** pentru pluginul selectat. 2. **Rulează manifestul `install[]` pași** declarat de plugin. 3. **Redați o unitate systemd izolată** pentru plugin. 4. **Sondaj `/healthz`** până când serviciul raportează sănătos. ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` Doar când `/healthz` reuşeşte instalarea marcată ca activă — un plugin care nu porneşte nu se consideră instalat în mod silenţios. ## Systemd nativ pe gazdă, izolat — nu Docker Fiecare plugin rulează ca **serviciul său systemd izolat**. Nu există containere, nici Docker, nici orchestrator: un plugin este un serviciu Linux gestionat cu propria unitate, port și restricții de sandbox, supravegheat de systemd ca și restul instalației. > [!WARNING] > AiHummer este nativ pentru gazdă. Pluginurile sunt implementate ca servicii systemd izolate > dintr-un pachet de lansare — **niciodată ca containere Docker.** Dacă un ghid îți spune > a „rula containerul pluginului”, nu descrie AiHummer. ## Controlul stării de sănătate cu /healthz Depozitorul interoghează pluginul `/healthz` punct final înainte de a declara succesul. Acest filtru de sănătate este ceea ce face instalarea cu un singur clic sigură: un plugin defect sau configurat greșit este depistat în timpul instalării și nu descoperit mai târziu în producție. ## Actualizare automată per instalare Actualizările sunt gestionate **pe instalație**. Fiecare plugin instalat se poate actualiza automat conform propriului program, astfel încât menținerea pluginurilor la zi nu necesită o reinstalare manuală de fiecare dată când o versiune nouă ajunge în catalog. Aceiași pași de descărcare → instalare → randare unitate → verificare a stării funcționale se aplică pentru o actualizare la fel ca pentru o instalare inițială. > [!TIP] > Deoarece actualizarea automată este pe instalație, poți păstra unele pluginuri fixate în timp ce > permite altora să urmărească noutățile — fiecare instalare își gestionează propriul ciclu de viață. ## Catalog cu mai multe surse Catalogul nu mai este legat de un singur URL. **catalog comunitar** pluginuri terțe care vin ca funcționalitate încorporată **sursă implicită** (plantat la instalare) — nu îl adaugi tu însuți. În **Module → Surse** (Interfață de administrare, sau `POST /v1/admin/modules/catalog/sources`) poți adăuga propriile surse suplimentare. Gateway-ul sincronizează fiecare sursă activată la pornire și la intervalul de actualizare automată. - **sursă oficială** (modulele de primă parte) sunt fixate și de încredere implicit — un obiect separat care este **nu suprascris** de către alte surse. - **catalog comunitar** este o sursă implicită cu sămânță; **surse private** are adăugat de operator. Fiecare intrare din catalog are un `origin`, și că `origin` decide care ancora semnătura este verificată împotriva (oficial → cheie fixată, privat → magazin de încredere). Pentru publicarea în catalogul comunității, vezi [Publicarea unui plugin](/ro/v1.0/marketplace/publishing). ## Model de încredere și cheia fixată Instalarea verifică semnătura unui plugin după sursa acestuia: - **oficial** → verificat în raport cu **cheie de registru fixată în nucleu**. De încredere de către implicit, fără acțiune a operatorului. - **privat** (încărcare laterală) → verificat împotriva **magazin de încredere al instanței**; Cheia autorului este aprobată de operator la încărcare (un singur clic). - **nesemnat** → respins, cu excepția modului de dezvoltare (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, doar dezvoltare locală). > [!WARNING] > **Pluginurile comunității nu pot fi instalate acum — nu este o problemă de > conexiune.** Cheia cu care se semna catalogul comunității a fost retrasă; până > la livrarea unei chei noi, verificarea semnăturii respinge aceste intrări. > Separat de asta, codul terț încă nu rulează ca serviciu pe serverul > dumneavoastră: până la apariția unui mediu de execuție izolat sunt permise doar > integrările care rulează la ele și se conectează prin rețea. > > **Ce veți vedea:** după apăsarea butonului „instalează” apare obișnuitul mesaj > „se instalează”, dar pluginul **nu apare niciodată** în lista celor instalate. > Motivul refuzului ajunge în jurnalul gateway-ului — deschideți **Jurnale** în > panoul de administrare. > > **Ce funcționează astăzi:** > > - **pluginurile de la AiHummer** din catalogul oficial — se instalează normal, > au o altă semnătură, validă; > - **un server MCP prin HTTP** — conectat ca sursă de unelte fără dezvoltare, > codul rămâne la dumneavoastră; > - **o integrare prin specificație OpenAPI** — la fel, fără serviciu de instalat. > > Încărcarea laterală a propriului plugin trece verificarea semnăturii, dar va > rula doar ca **MCP la distanță prin HTTP** sau integrare OpenAPI; o compilare > care trebuie pornită ca serviciu pe același server este respinsă. ## Actualizări semnate O actualizare **execută din nou aceeași poartă cu semnătură** ca prima instalare: la trecerea la o versiune nouă, semnătura este verificată din nou împotriva aceluiași punct de încredere. O actualizare **nu se poate ocoli** verificarea — nu poți crește încrederea printr-o actualizare. ## Insigna și clasamentul oficial În catalogul interfeței web, pluginurile de la AiHummer au un **Oficial** emblemă și rang mai întâi. Pluginurile terțe apar fără emblemă și se sortează **după numărul de descărcări**. Steagul oficial este derivat dintr-o intrare `origin` (oficial) — nu poate fi setat manual în manifest. ## Unde următor? - [Prezentare generală a pieței și niveluri](/ro/v1.0/marketplace/overview-tiers) — ce naiba exist trei niveluri de plugin. - [SDK pentru plugin](/ro/v1.0/marketplace/sdk) — `manifest.json` al cărui `install[]` pașii pe care îi parcurge acest ciclu de viață. - [Publicarea unui plugin](/ro/v1.0/marketplace/publishing) — încărcare laterală privată și publicare comunitară prin intermediul cabinetului personal. - [Integrări fără cod](/ro/v1.0/marketplace/zero-code) — adaugă instrumente OpenAPI/MCP fără niciun serviciu de instalat.