Asenna ja päivitykset

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

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

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

Liitännäisen asentaminen AiHummeriin on yksittäinen klikkaus hallintaliittymässä, mutta tuon klikkauksen takana on deterministinen, isäntäkohtainen elinkaari. Alusta lataa liitännäisen, suorittaa sen ilmoittamat asennusvaiheet, renderöi **hiekkalaatikotettu systemd-yksikkö**, ja pitää liitännäistä terveenä vain, kun se vastaa terveystarkistukseen. Jokainen asennus sitten pitää itsensä ajan tasalla itse. ## Yhden napsautuksen asennus hallintakäyttöliittymästä Asennat ja hallitset lisäosia hallintakäyttöliittymästä, jota tukee hallintamoduulin API: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Moduulin tunniste menee JSON-pyynnön runkoon, ei polkuun: ```json { "slug": "einstein", "version": "" } ``` Ei tarvitse kytkeä mitään käsin: valitse liitännäinen luettelosta, klikkaa asenna, ja käyttöönottaja hoitaa loput. > [!NOTE] > Kanavayhdistimen asentaminen ydinsarjan ulkopuolelle (vain Telegram) > vaatii aktiivisen **Aloittaja**, **Liiketoiminta** tai **Yritys** lisenssi. > Yhteisösuunnitelmassa tällainen pyyntö palautuu **HTTP 402 "päivitys vaaditaan"** > (koodi `plan_limit`) — katso [Lisensointi](/fi/v1.0/commercial/licensing). > [!NOTE] > Se **Einstein** muistilisäosa on **sisäänrakennettu**: se asentuu automaattisesti, > kantaa 'Sisäänrakennettu'-merkkiä, eikä sitä voi poistaa tai pysäyttää. ## SystemdDeployer-prosessi Konepellin alla **SystemdAsentaja** suorittaa nämä vaiheet: 1. **Lataa tar-paketti** valitulle laajennukselle. 2. **Suorita manifesti `install[]` askeleet** laiminlyönyt liitännäinen. 3. **Renderöi hiekkalaatikkoon rajattu systemd-yksikkö** liitännäistä varten. 4. **Äänestys `/healthz`** kunnes palvelu ilmoittaa olevansa terve. ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` Vain kun `/healthz` onnistuu, asennus merkitään aktiiviseksi — liitännäinen, joka ei käynnisty, ei lasketa hiljaisesti asennetuksi. ## Isäntäkohtainen, hiekkalaatikossa toimiva systemd — ei Dockeria Jokainen lisäosa toimii kuin **oma hiekkalaatikkoon suljettu systemd-palvelu**. Ei ole säiliöitä, ei Dockeria, ei orkestroijaa: liitännäinen on hallittu Linux-palvelu omalla yksiköllään, portillaan ja hiekkalaatikkorajoituksillaan, jota valvoo systemd kuten muuta asennusta. > [!WARNING] > AiHummer on isäntäkohtainen. Laajennukset otetaan käyttöön hiekkalaatikotettuina systemd-palveluina > julkaisun tarballista — **ei koskaan Docker-kontteina.** Jos opas kertoo sinulle > ajaa laajennussäiliötä, se ei kuvaile AiHummeria. ## Terveystarkastus komennolla /healthz Julkaisija kysyy laajennuksen `/healthz` päätepiste ennen onnistumisen ilmoittamista. Tämä terveystarkastus tekee yhden klikkauksen asennuksesta turvallisen: rikki tai virheellisesti määritetty lisäosa havaitaan asennuksen aikana sen sijaan, että se huomattaisiin myöhemmin tuotannossa. ## Esiasennuksen automaattinen päivitys Päivityksiä käsitellään **asennusta kohden**. Jokainen asennettu lisäosa voi päivittää itsensä omalla aikataulullaan, joten lisäosien pitäminen ajan tasalla ei vaadi manuaalista uudelleenasennusta aina, kun uusi versio ilmestyy luetteloon. Sama lataus → asennus → renderöintiyksikkö → terveystarkastus -prosessi toimii päivityksessä samalla tavalla kuin ensimmäisessä asennuksessa. > [!TIP] > Koska automaattinen päivitys on asennuskohtaista, voit pitää joitakin liitännäisiä kiinnitettyinä samalla kun > antaa muiden seurata uusinta — jokainen asennus hallitsee omaa elinkaartaan. ## Monilähdekatalogi Katalogi ei enää liity yhteen URL-osoitteeseen. Se **yhteisön luettelo** kolmannen osapuolen lisäosista toimitetaan sisäänrakennettuna **oletuslähde** (asennettaessa siemenetty) — et lisää sitä itse. Sisään **Laajennukset → Lähteet** (Hallinta-Käyttöliittymä, tai `POST /v1/admin/modules/catalog/sources`) voit lisätä omia lisälähteitäsi. Portti synkronoi jokaisen käytössä olevan lähteen käynnistyksen yhteydessä ja automaattisen päivityksen aikavälillä. - Se **virallinen lähde** (ensisijaiset moduulit) on oletusarvoisesti kiinnitetty ja luotettu — erillinen esine, joka on **ei ylikirjoitettu** toisista lähteistä. - Se **yhteisön luettelo** on lähtökohtaisesti sijoitetun siemenen lähde; **yksityiset lähteet** ovat lisätty operaattorin toimesta. Jokaisella luettelon merkinnällä on eräs `origin`, ja se `origin` päätää, minkä ankkurin allekirjoitus tarkistetaan vastaan (virallinen → kiinnitetty avain, yksityinen → luotettujen varastoon). Yhteisön luetteloon julkaisemista varten katso [Laajennuksen julkaiseminen](/fi/v1.0/marketplace/publishing). ## Luottamusmalli ja kiinnitetty avain Asennus tarkistaa laajennuksen allekirjoituksen sen lähteen mukaan: - **virallinen** → vahvistettu suhteessa **rekisterimerkintä kiinnitetty ydinkomponenttiin**. Luotettu oletus, ei operaattorin toimenpidettä. - **yksityinen** (sivu-lataa) → vahvistettu vastaan **instanssin luottokauppa**; se Kirjoittajan avain hyväksytään operaattorin toimesta latauksen yhteydessä (yhdellä napsautuksella). - **allekirjoittamaton** → hylätty, paitsi kehitystilassa (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, vain paikallinen kehitys). > [!WARNING] > **Yhteisön liitännäisiä ei voi juuri nyt asentaa — kyse ei ole yhteysviasta.** > Avain, jolla yhteisökatalogi allekirjoitettiin, on peruttu; kunnes uusi avain > julkaistaan, allekirjoituksen tarkistus hylkää nämä merkinnät. Tästä > riippumatta kolmannen osapuolen koodia ei vielä ajeta palveluna palvelimellasi: > kunnes eristetty ajoympäristö on olemassa, sallitaan vain integraatiot, jotka > toimivat omalla puolellaan ja yhdistävät verkon yli. > > **Mitä näet:** ”asenna”-napin jälkeen näkyy tavallinen viesti ”asennetaan”, > mutta liitännäinen **ei koskaan ilmesty** asennettujen luetteloon. Hylkäyksen > syy kirjautuu yhdyskäytävän lokiin — avaa **Lokit** hallintapaneelissa. > > **Mikä toimii tänään:** > > - **AiHummerin liitännäiset** virallisesta katalogista — ne asentuvat kuten > ennenkin ja niissä on toinen, voimassa oleva allekirjoitus; > - **MCP-palvelin HTTP:n yli** — kytketään työkalulähteeksi ilman kehitystyötä, > koodi pysyy sinun puolellasi; > - **OpenAPI-määrittelyyn perustuva integraatio** — sama asia, ei asennettavaa > palvelua. > > Oman liitännäisen sivulataus läpäisee allekirjoituksen tarkistuksen, mutta se > ajetaan vain **etä-MCP:nä HTTP:n yli** tai OpenAPI-integraationa; käännös, joka > pitäisi käynnistää palveluna samalla palvelimella, hylätään. ## Allekirjoitetut päivitykset Päivitys **suorittaa saman allekirjoitusportin uudelleen** ensimmäisen asennuksen yhteydessä: kun siirrytään uuteen versioon, allekirjoitus tarkistetaan uudelleen samaa luottamusankkuria vastaan. Päivitys **ei voi ohittaa** tarkistus — et voi lisätä luottamusta päivityksen kautta. ## Virallinen merkki ja arvostelu Verkkokäyttöliittymän luettelossa AiHummerin lisäosat sisältävät **Virallinen** merkki ja sijoitus ensimmäiseksi. Kolmannen osapuolen lisäosat näkyvät ilman merkkiä ja järjestävät **latausmäärän mukaan**. Virallinen lippu on johdettu erään osallistujan ehdotuksesta `origin` (virallinen) — sitä ei voida asettaa käsin manifestiin. ## Minne seuraavaksi - [Verkkokaupan yleiskuvaus ja tasot](/fi/v1.0/marketplace/overview-tiers) — mikä ihme kolme lisäosatasoa ovat. - [Liitännäisen SDK](/fi/v1.0/marketplace/sdk) — se `manifest.json` kenen `install[]` vaiheet, joita tämä elinkaaren vaihe suorittaa. - [Laajennuksen julkaiseminen](/fi/v1.0/marketplace/publishing) — yksityinen sivulataus ja yhteisön julkaiseminen henkilökohtaisen kaapin kautta. - [Nollakoodin integraatiot](/fi/v1.0/marketplace/zero-code) — lisää OpenAPI/MCP-työkaluja ilman asennettavaa palvelua.