Տեղադրում և թարմացումներ

GET  /v1/admin/modules
POST /v1/admin/modules/{slug}/install

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

AiHummer-ում փլագին տեղադրելը ադմին UI-ում ընդամենը մեկ սեղմում է, սակայն այդ սեղմման հետևում կանգնած է դետերմինիստական, host-native կենսացիկլ։ Հարթակը ներբեռնում է փլագինը, կատարում է նրա հայտարարված տեղադրման քայլերը, ստեղծում է **մեկուսացված systemd միավոր**, և փլագինը համարում է առողջ միայն այն ժամանակ, երբ այն պատասխանում է առողջության ստուգմանը։ Այնուհետև յուրաքանչյուր տեղադրում ինքն իրեն պահում է թարմացված վիճակում։ ## Մեկ սեղմումով տեղադրում ադմին UI-ից Փլագինները տեղադրում և կառավարում եք ադմին UI-ից, որը հենվում է ադմին մոդուլի API-ի վրա. ```http GET /v1/admin/modules POST /v1/admin/modules/{slug}/install ``` Ձեռքով միացնելու ոչինչ չկա. ընտրեք փլագին կատալոգից, սեղմեք install, և deployer-ը ստանձնում է մնացածը։ > [!NOTE] > Հիշողության փլագին **Einstein-ը ներկառուցված է**. այն տեղադրվում է ավտոմատ, > նշված է «Ներկառուցված» կրծքանշանով և չի կարող ջնջվել կամ կանգնեցվել։ ## SystemdDeployer-ի հոսքը Կուլիսներում **SystemdDeployer**-ը կատարում է հետևյալ քայլերը. 1. **Ներբեռնում է tarball** ընտրված փլագինի համար։ 2. **Կատարում է manifest-ի `install[]` քայլերը**, որոնք հայտարարված են փլագինի կողմից։ 3. **Ստեղծում է մեկուսացված systemd միավոր** փլագինի համար։ 4. **Հարցում է անում `/healthz`-ին**, մինչև ծառայությունը հայտնի առողջ վիճակ։ ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` Միայն երբ `/healthz`-ը հաջողվում է, տեղադրումը նշվում է որպես ակտիվ. փլագինը, որը չի կարողանում գործարկվել, լուռ ձևով չի համարվում տեղադրված։ ## Host-native, մեկուսացված systemd — ոչ Docker Յուրաքանչյուր փլագին աշխատում է որպես **իր սեփական մեկուսացված systemd ծառայություն**։ Չկան կոնտեյներներ, չկա Docker, չկա orchestrator. փլագինը կառավարվող Linux ծառայություն է իր սեփական միավորով, պորտով և մեկուսացման սահմանափակումներով, որը վերահսկվում է systemd-ի կողմից, ինչպես տեղադրման մնացած մասը։ > [!WARNING] > AiHummer-ը host-native է։ Փլագինները տեղակայվում են որպես մեկուսացված systemd ծառայություններ > release tarball-ից — **երբեք որպես Docker կոնտեյներներ։** Եթե ուղեցույցը ձեզ ասում է, > որ «գործարկեք փլագինի կոնտեյները», ապա այն չի նկարագրում AiHummer-ը։ ## Առողջության դարպասավորում /healthz-ով Deployer-ը հարցում է անում փլագինի `/healthz` վերջակետին, նախքան հաջողություն հայտարարելը։ Այս առողջության դարպասն է, որ մեկ սեղմումով տեղադրումը դարձնում է անվտանգ. կոտրված կամ սխալ կարգավորված փլագինը բռնվում է տեղադրման ընթացքում, այլ ոչ թե հայտնաբերվում ավելի ուշ՝ արտադրությունում։ ## Տեղադրումներով auto-update Թարմացումները կարգավորվում են **յուրաքանչյուր տեղադրման մակարդակում**։ Յուրաքանչյուր տեղադրված փլագին կարող է ինքն իրեն auto-update անել իր սեփական ժամանակացույցով, այնպես որ փլագինները արդիական պահելը չի պահանջում ձեռքով վերատեղադրում ամեն անգամ, երբ նոր տարբերակ է հասնում կատալոգ։ Նույն download → install քայլեր → render unit → health-check հոսքն աշխատում է թարմացման համար, ինչպես առաջին տեղադրման համար։ > [!TIP] > Քանի որ auto-update-ը տեղադրման մակարդակում է, կարող եք որոշ փլագիններ ֆիքսված պահել, մինչդեռ > մյուսներին թույլ տալ հետևել ամենավերջին տարբերակին — յուրաքանչյուր տեղադրում կառավարում է իր սեփական կենսացիկլը։ ## Բազմ-աղբյուր կատալոգ Կատալոգն այլևս կապված չէ մեկ URL-ի հետ։ **Plugins → Sources**-ում (Ադմին UI, կամ `POST /v1/admin/modules/catalog/sources`) կարող եք ավելացնել լրացուցիչ աղբյուր — օրինակ, երրորդ կողմի փլագինների **համայնքային կատալոգ**։ Gateway-ը համաժամացնում է յուրաքանչյուր միացված աղբյուր գործարկման ժամանակ և auto-update-ի ինտերվալով։ - **Պաշտոնական աղբյուրը** (առաջին կողմի մոդուլներ) ֆիքսված և վստահելի է լռելյայն — առանձին օբյեկտ, որը **չի վերագրվում** այլ աղբյուրների կողմից։ - **Մասնավոր/համայնքային աղբյուրները** ավելացվում են օպերատորի կողմից. յուրաքանչյուր կատալոգի գրառում ունի `origin`, և այդ `origin`-ը որոշում է, թե որ խարսխի դեմ է ստուգվում ստորագրությունը (official → ֆիքսված բանալի, private → trust store)։ Համայնքային կատալոգ հրապարակելու համար տես [Փլագինի հրապարակում](/hy/v1.0/marketplace/publishing)։ ## Վստահության մոդելը և ֆիքսված բանալին Տեղադրումը ստուգում է փլագինի ստորագրությունն ըստ իր աղբյուրի. - **official** → ստուգվում է **core-ում ֆիքսված registry բանալու դեմ**։ Վստահելի է լռելյայն, օպերատորի գործողություն չի պահանջվում։ - **private** (side-load) → ստուգվում է **instance trust store**-ի դեմ. հեղինակի բանալին հաստատվում է օպերատորի կողմից վերբեռնման ժամանակ (մեկ սեղմում)։ - **unsigned** → մերժվում է, բացառությամբ dev ռեժիմի (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, միայն լոկալ մշակման համար)։ ## Ստորագրված թարմացումներ Թարմացումը **կրկին կատարում է նույն ստորագրության դարպասը**, ինչ առաջին տեղադրումը. նոր տարբերակ տեղափոխվելիս ստորագրությունը կրկին ստուգվում է նույն վստահության խարսխի դեմ։ Թարմացումը **չի կարող շրջանցել** ստուգումը — դուք չեք կարող բարձրացնել վստահությունը թարմացման միջոցով։ ## Official կրծքանշանը և դասակարգումը Web UI կատալոգում AiHummer-ի փլագինները կրում են **Official** կրծքանշան և դասակարգվում են առաջինը։ Երրորդ կողմի փլագինները ցուցադրվում են առանց կրծքանշանի և տեսակավորվում են **ըստ ներբեռնումների քանակի**։ Official դրոշը ստացվում է գրառման `origin`-ից (official) — այն չի կարող ձեռքով սահմանվել manifest-ում։ ## Ո՞ւր հաջորդիվ - [Marketplace-ի ակնարկ և մակարդակներ](/hy/v1.0/marketplace/overview-tiers) — ինչ են փլագինների երեք մակարդակները։ - [Փլագինի SDK](/hy/v1.0/marketplace/sdk) — `manifest.json`-ը, որի `install[]` քայլերն աշխատեցնում է այս կենսացիկլը։ - [Փլագինի հրապարակում](/hy/v1.0/marketplace/publishing) — մասնավոր side-load և հանրային registry։ - [Zero-code ինտեգրացիաներ](/hy/v1.0/marketplace/zero-code) — ավելացրեք OpenAPI/MCP գործիքներ առանց տեղադրման ենթակա ծառայության։