Instalēšana un atjauninājumi

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

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

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

Spraudņa instalēšana AiHummer ir viens klikšķis administratora lietotāja interfeisā, bet aiz šī klikšķa slēpjas deterministiska, saimniekdatora nativa dzīves cikla izpilde. Platforma lejupielādē spraudni, veic tā deklarētos instalācijas soļus, attēlo **piesprausts systemd vienība**, un uzskata spraudni par veselīgu tikai tad, kad tas atbild uz veselības pārbaudi. Katras instalācijas tad pašas seko līdzi savai atjaunināšanai. ## Vienas klikšķa instalēšana no administrēšanas lietotāja interfeisa Jūs instalējat un pārvaldāt spraudņus no administrācijas lietotāja saskarnes, ko nodrošina administrācijas moduļa API: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Moduļa identifikators tiek ievietots JSON pieprasījuma pamattekstā, nevis ceļā: ```json { "slug": "einstein", "version": "" } ``` Nav nekā, ko vadu ar rokām: izvēlieties spraudni no kataloga, noklikšķiniet uz instalēšanas, un izvietošanas rīks pārņem vadību. > [!NOTE] > Kanāla savienotāja instalēšana ārpus pamatkomplekta (tikai Telegram) > prasa aktīvu **Starteris**, **Bizness** vai **Uzņēmums** licence. > Kopienas plānā šāda pieprasījuma rezultāts ir **HTTP 402 "prasīts jauninājums"** > (kods `plan_limit`) — skatīt [Licencešana](/lv/v1.0/commercial/licensing). > [!NOTE] > Tas **Einšteins** atmiņas spraudnis ir **iebūvēts**: tas tiek instalēts automātiski, > nes “iebūvētas” nozīmīti un to nevar noņemt vai apturēt. ## SystemdDeployer plūsma Pārsega iekšpusē **SystemdIzvietotājs** veic šos soļus: 1. **Lejupielādēt tarbālu** izvēlētajam spraudnim. 2. **Palaidiet manifestu `install[]` soļi** deklarēts spraudņa. 3. **Atveidojiet sandboxed systemd vienību** paplašinājumam. 4. **Aptauja `/healthz`** līdz serviss ziņo par veselīgu stāvokli. ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` Tikai tad, kad `/healthz` izdodas, tiek atzīmēta instalācija kā aktīva — spraudnis, kas nepalaižas, netiek klusējot uzskatīts par instalētu. ## Mājas datora vietējā, izolētā systemd — nevis Docker Katrs spraudnis darbojas kā **savs sandboxed systemd serviss**. Nav konteineru, nav Docker, nav orkestratora: spraudnis ir pārvaldīta Linux pakalpojuma vienība ar saviem portiem un smilšu kastes ierobežojumiem, kuru uzrauga systemd tāpat kā pārējo instalāciju. > [!WARNING] > AiHummer ir dabiski resursu saimniekā. Spraudņi tiek izvietoti kā izolētas systemd pakalpojumu sistēmas > no izlaiduma tarball **nekad kā Docker konteineri.** Ja gids tev saka > lai “palaistu spraudņa konteineru”, tas neapraksta AiHummer. ## Veselības pārbaude ar /healthz Izvietotājs pārbauda spraudņa `/healthz` galapunkts pirms panākumu paziņošanas. Šis veselības vārds padara vienas klikšķa instalēšanu drošu: bojāts vai nepareizi konfigurēts spraudnis tiek atklāts instalēšanas laikā, nevis vēlāk ražošanā. ## Automātiska atjaunināšana pirms instalēšanas Atjauninājumi tiek apstrādāti **uz uzstādījumu**. Katrs instalētais spraudnis var automātiski atjaunināties pēc sava grafika, tādējādi spraudņu aktualizēšana neprasa manuālu pārlādēšanu katru reizi, kad katalogā parādās jauna versija. Tie paši lejupielādes → instalēšanas soļi → renderēšanas vienības → sistēmas veselības pārbaudes process tiek veikts gan atjaunināšanai, gan pirmreizējai instalēšanai. > [!TIP] > Tā kā automātiskā atjaunināšana ir uz katras instalācijas, jūs varat dažus spraudņus paturēt piespraustus, kamēr > ļaujot citiem izsekot jaunāko — katra instalācija pārvalda savu dzīves ciklu. ## Daudzavotu katalogs Katalogs vairs nav saistīts ar vienu URL. **kopienas katalogs** trešo pušu spraudņi tiek piegādāti kā iebūvēti **noklusējuma avots** (iepriekš iestatīts instalēšanas laikā) — jūs to nepievienojat pats. Sadaļā **Spraudņi → Avoti** (Admina UI, vai `POST /v1/admin/modules/catalog/sources`) jūs varat pievienot savus papildu avotus. Vārteja sinhronizē katru iespējoto avotu startēšanas laikā un automātiskās atjaunināšanas intervālā. - Tas **oficiāls avots** (pirmās puses moduļi) pēc noklusējuma ir piesprausti un uzticami — atsevišķs objekts, kas ir **nav pārrakstīts** no citiem avotiem. - Tas **kopienas katalogs** ir iepriekš iestatīts noklusējuma avots; **privātie avoti** ir pievienots operatora. Katram kataloga ierakstam ir vienu `origin`, un tas `origin` izlemj, kura enkura paraksts tiek pārbaudīts pret (oficiāli → piestiprināta atslēga, privāti → uzticības krātuve). Papildus publicēšanai kopienas katalogā skatīt [Spraudņa publicēšana](/lv/v1.0/marketplace/publishing). ## Uzticības modelis un piespraustais atslēga Instalācija pārbauda spraudņa parakstu pēc tā avota: - **oficiāls** → pārbaudīts attiecībā uz **reģistra atslēga piesprausta kodolā**. Uzticams noklusējums, nav operatora darbības. - **privāts** (sānu ielāde) → pārbaudīts pret **instanču uzticības krātuve**; autora atslēga tiek apstiprināta nozaimbāju lietotāja augšupielādes laikā (viens klikšķis). - **neparakstīts** → noraidīts, izņemot izstrādes režīmā (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, tikai lokālā izstrāde). > [!WARNING] > **Kopienas spraudņus pašlaik nav iespējams uzstādīt — tā nav savienojuma > kļūme.** Atslēga, ar kuru tika parakstīts kopienas katalogs, ir atsaukta; līdz > jaunas atslēgas izlaidumam paraksta pārbaude šādus ierakstus noraida. Neatkarīgi > no tā trešo pušu kods vēl netiek darbināts kā pakalpojums jūsu serverī: kamēr > nav izolētas izpildvides, atļautas ir tikai integrācijas, kas darbojas savā pusē > un pieslēdzas pa tīklu. > > **Ko jūs redzēsiet:** pēc pogas «uzstādīt» parādās ierastais paziņojums > «uzstāda», bet spraudnis **nekad neparādās** uzstādīto sarakstā. Atteikuma > iemesls nonāk vārtejas žurnālā — atveriet **Žurnāli** pārvaldības panelī. > > **Kas darbojas šodien:** > > - **AiHummer spraudņi** no oficiālā kataloga — tie uzstādās kā parasti un tiem > ir cits, derīgs paraksts; > - **MCP serveris pa HTTP** — pieslēdzams kā rīku avots bez izstrādes, kods > paliek jūsu pusē; > - **integrācija pēc OpenAPI specifikācijas** — tas pats, bez uzstādāma > pakalpojuma. > > Sava spraudņa sānielāde iztur paraksta pārbaudi, taču darbosies tikai kā > **attālināts MCP pa HTTP** vai OpenAPI integrācija; būvējums, kas jāpalaiž kā > pakalpojums tajā pašā serverī, tiek noraidīts. ## Parakstīti atjauninājumi Atjauninājums **atkārtoti palaiž to pašu paraksta vārti** kā pirmā instalēšana: pārejot uz jaunu versiju, paraksts tiek atkārtoti pārbaudīts pret to pašu uzticamības centru. Atjauninājums **nevar apiet** pārbaude — tu nevari paaugstināt uzticību ar atjauninājumu. ## Oficiālā žetona un rangs Tīmekļa lietotāja interfeisa katalogā AiHummer spraudņiem ir **Oficiāls** žetons un ranga pirmais. Trešo pušu spraudņi tiek rādīti bez žetona un kārtoti **pēc lejupielāžu skaita**. Oficiālā karoga dizains ir iegūts no ieraksta `origin` (oficiāli) — tas nevar tikt iestatīts manuāli manifestā. ## Kur uz nākamo - [Tirgus pārskats un līmeņi](/lv/v1.0/marketplace/overview-tiers) — kas tā trīs spraudņu līmeņi ir. - [Spraudņa SDK](/lv/v1.0/marketplace/sdk) — tas `manifest.json` kura `install[]` soļi, kuros darbojas šis dzīves cikls. - [Spraudņa publicēšana](/lv/v1.0/marketplace/publishing) — privātā sānu ielāde un kopienas publicēšana caur personīgo kabinetu. - [Integrācijas bez koda](/lv/v1.0/marketplace/zero-code) — pievienot OpenAPI/MCP rīkus bez pakalpojuma uzstādīšanas.