ინსტალაცია და განახლებები

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-ში პლაგინის ინსტალაცია შესაძლებელია ადმინისტრაციული ინტერფეისიდან ერთი დაწკაპვით, მაგრამ ამ დაწკაპვტში იმალება მასპინძლისთვის ნატურალური დეტერმინირებული სიცოცხლის ციკლი. პლატფორმა იტვირთავს პლაგინს, ახორციელებს მისგან გამოცხადებულ ინსტალაციის ნაბიჯებს, აჩვენებს **პესოჩნიცა unit systemd**, და პუგინი ჯანმრთელად მიიჩნევს მხოლოდ მას შემდეგ, რაც ის პასუხობს მდგომარეობის შემოწმებას. ყოველი ინსტალაცია შემდეგ თვითონ იცავს თავს მიმდინარე მდგომარეობაში. ## ერთხრილაზე ინსტალაცია ადმინისტრატორის ინტერფეისიდან თქვენ ამზადებთ და ხელმძღვანელობთ პლაგინებს ადმინისტრატორის ინტერფეისის საშუალებით, რომელიც მხარდაჭერილია ადმინისტრატორის მოდულის API-ით: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` მოდულის იდენტიფიკატორი (slug) მითითებულია JSON–შეკითხვის სხეულში, არა გზაში: ```json { "slug": "einstein", "version": "" } ``` ხელით არაფრის დაკავშირება არ არის საჭირო: აირჩიეთ მოდული კატალოგიდან, დააჭირეთ დაყენებას და დანარჩენს ინსტალერი შეასრულებს. > [!NOTE] > არხის კავშირის დამონტაჟება ძირითად პაკეტს გარეთ (მხოლოდ Telegram) > მოვაჭრე აქტიური **სტარტერი**, **ბიზნესი** ან **წარმოება** ლიცენზია. > Community-ს გეგმაზე ასეთი მოთხოვნა აბრუნებს **HTTP 402 «ხრიკინდება განახლება»** > (კოდი `plan_limit`) — იხ. [ლიცენზირება](/ka/v1.0/commercial/licensing). > [!NOTE] > ეს **აინშტაინი** მეხსიერების მოდული არის **შენობაში ჩაშენებული**: ავტომატურად ვდება, > აქვს ნიშანი „შიგნიდან“ და არ შეიძლება წაშალოს ან შეაჩეროს. ## SystemdDeployer-ს ნაკადი კაპოტის ქვეშ **სისტემდეპლოიერ** ასრულებს ამ ნაბიჯებს: 1. **გადმოწერეთ tar არქივი** არჩეული პლაგინიისთვის. 2. **გააქტიურდეთ მანიფესტი `install[]` ქვეითები** განაცხადებულია პლაგინი. 3. **შექმენით იზოლირებული unit-სისტემა systemd** პლაგინისთვის. 4. **გამოკითხვა `/healthz`** სანამ სერვისი ჯანმრთელობის შესახებ არ აცნობებს. ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` მხოლოდ მაშინ `/healthz` დაეთვლება წარმატებულ ინსტალაციას, რომელიც მონიშნულია როგორც აქტიური — პლაგინი, რომელიც არ იწყება, არ ითვლება ჩასმულად მშვიდად. ## systemd სისტემა მასპინძელზე, აღუწერელი ქვაბაში იზოლირებული — არა Docker ყოველი პლაგინი მუშაობს როგორც **საკუთარი systemd სერვისი იზოლირებულ გარემოში**. კონტეინერები არ არის, Docker არ არის, ორკესტრატორი არ არის: პლაგინი — ეს არის Linux-ის მართვადი სერვისი საკუთარი ერთეულით, პორტით და სენდბოქსის შეზღუდვებით, რომელიც კონტროლირებულია systemd-ის მიერ, როგორც დანარჩენი ინსტალაცია. > [!WARNING] > AiHummer არის მასპინძლის ადგილობრივი. პლაგინები განთავსდება როგორც იზოლირებული systemd სერვისები > გამოსაშვების არქივის ფაილიდან — **არასდროს როგორც Docker-ის კონტეინერები.** თუ გიდი გეუბნებათ > რომ გაეშვას „პლაგინის კონტეინერი“, ეს არ აღწერს AiHummer-ს. ## /healthz-ს საშუალებით მდგომარეობის შესამოწმებლად დეპლოიერ გამოკითხავს პლაგინს `/healthz` საბოლოო წერტილი წარმატების გამოცხადებამდეც. ეს ჯანმრთელობის კონტროლი ხდის ერთ კლიკზე დამონტაჟებას უსაფრთხოს: მწყობრსაგან გამორჩეული ან არასწორად გაწყობილი დამატება ამოდის დაყენებისას, და არა მოგვიანებით ექსპლუატაციის დროს. ## ავტომატური განახლება დაყენებისთვის განახლებები მუშავდება **ინსტალაციისთვის**. თითოეულ დაინსტალირებულ პლაგინს შეუძლია ავტომატურად განახლება საკუთარი გრაფიკის მიხედვით, ამიტომ პლაგინების თანამედროვე მდგომარეობის შენარჩუნება არ საჭიროებს ხელით ხელახლა დაყენებას ყოველი ახალი ვერსიის გამოჩენისას კატალოგში. იგივე ნაბიჯები: გადმოწერა → ინსტალაცია → რენდერინგი იუნიტ → სტატუსის შემოწმების ნაკადი სრულდება განახლებისთვის, ისე როგორც პირველ ინსტალაციაზე. > [!TIP] > რადგან ავტომატური განახლება დამოკიდებულია ინსტალაციაზე, თქვენ შეგიძლიათ ზოგი დანამატი გქონდეთ დაყვანილი ამ მდგომარეობაში, როცა > ქმნის სხვებისთვის ბოლო განახლებების თვალყურის დევნებას შესაძლებელს — თითოეული ინსტალაცია მართავს თავის საკუთარ სიცოცხლის ციკლს. ## კატალოგი რამდენიმე წყაროდან კატალოგი აღარ არის დაკავშირებული ერთ URL-თან. **კომუნიტეტის კატალოგი** მესაკუთრე დეველოპერების პლაგინები წარმოადგენს ნაგულისხმებით ჩაშენებულს **სტანდარტული წყარო** (შექმნილია ინსტალაციის დროს) — თქვენ ამას თვითონ არ უმატებთ.-ში **პლაგინები → წყაროები** (ადმინრის ინტერფეისი, ან `POST /v1/admin/modules/catalog/sources`) თქვენ შეგიძლიათ დაამატოთ საკუთარი დამატებითი წყაროები. გეიტვეი სინქრონიზებას უკეთებს თითოეულ ჩართულ წყაროს დაწყებისას და ავტომატური განახლების ინტერვალში. - ეს **ოფიციალური წყარო** (პირველი მხარის მოდულები) დარღვევის გარეშე დამაგრებულია და ნაგულისხმევად ჩაითვლება ნდობად — საუბარი ობიექტი, რომელიც არის **არ წაიწერა თავიდან** სხვა წყაროების მიხედვით. - ეს **კომუნიტეტის კატალოგი** არის საწყისი წყარო განსაზღვრული მნიშვნელობით; **კერძო წყაროები** არის დამატებულია ოპერატორის მიერ. კატალოგის ყოველი ჩანაწერი აქვს უსაფრთხო უარყოფითი გამტარი `origin`, და ეს `origin` განსაზღვრავს, რომელ ლაიტურასთან შეამოწმება ხელმოწერა წინააღმდეგ (ოფიციალური → დამოწმებული გასაღები, პირადი → ნდობის საცავი). კონცეფციის კატალოგში გამოქვეყნებისათვის იხ. [პლაგინის გამოქვეყნება](/ka/v1.0/marketplace/publishing). ## რწმენის მოდელი და დადგენილი გასაღები ინსტალატორი შეამოწმებს პლაგინის ხელმოწერას მისი წყაროს მიხედვით: - **ოფიციალური** → შემოწმებულია მიხედვით **რეგისტრის კლავიატურა ბირთვშია მიბმული**. ენდობიან ნაგულისხმევად, ოპერატორის მხრიდან არანაირი ქმედება. - **საჯარო** (მონტაჟი მხრიდან) → შემოწმებულია მიხედვით **სანდო სერთიფიკატების საცავი შემთხვევისთვის**; ის ავტორის გასაღები დამტკიცებულია ოპერატორის მიერ ატვირთვისას (ერთი კლიკით). - **ნიშნის გარეშე** → უარყოფილია, გარდა განვითარების რეჟიმისა (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, მხოლოდ ლოკალური განვითარება). > [!WARNING] > **საზოგადოების დანამატების დაყენება ახლა შეუძლებელია — ეს კავშირის ხარვეზი > არაა.** გასაღები, რომლითაც საზოგადოების კატალოგი იწერებოდა, გაუქმებულია; ახალი > გასაღების გამოსვლამდე ხელმოწერის შემოწმება ასეთ ჩანაწერებს უარყოფს. ამისგან > დამოუკიდებლად, მესამე მხარის კოდი ჯერ არ ეშვება სერვისად თქვენს სერვერზე: > იზოლირებული გაშვების გარემოს გაჩენამდე ნებადართულია მხოლოდ ის ინტეგრაციები, > რომლებიც თავიანთ მხარეს მუშაობენ და ქსელით უერთდებიან. > > **რას ნახავთ:** «დაყენების» დაჭერის შემდეგ გამოჩნდება ჩვეული შეტყობინება > «ყენდება», მაგრამ დანამატი დაყენებულთა სიაში **არასოდეს გამოჩნდება**. უარის > მიზეზი იწერება კარიბჭის ჟურნალში — გახსენით **ჟურნალები** მართვის პანელში. > > **რა მუშაობს დღეს:** > > - **AiHummer-ის დანამატები** ოფიციალური კატალოგიდან — ყენდება ჩვეულებრივ, მათ > სხვა, მოქმედი ხელმოწერა აქვთ; > - **MCP-სერვერი HTTP-ით** — უერთდება როგორც ხელსაწყოების წყარო პროგრამირების > გარეშე, კოდი თქვენს მხარეს რჩება; > - **ინტეგრაცია OpenAPI სპეციფიკაციით** — იგივე, დასაყენებელი სერვისის გარეშე. > > საკუთარი დანამატის ხელით ატვირთვა ხელმოწერის შემოწმებას გადის, მაგრამ > გაეშვება მხოლოდ როგორც **დისტანციური MCP HTTP-ით** ან OpenAPI ინტეგრაცია; > აწყობა, რომელიც იმავე სერვერზე სერვისად უნდა გაეშვას, უარყოფილი იქნება. ## ხელმოწერილი განახლებები განახლება **ხრიკავს იგივე სიგნატურულ ჭიშკარს კვლავ** პირველი ინსტალაციისას: ახალ ვერსიაზე გადასვლისას ხელმოწერა ისევ შემოწმდება იმავე ნდობიან კვანძთან მიმართებით. განახლება **არ შეუძლია წასვლა** ჩეკი — თქვენ არ შეგიძლიათ გაზარდოთ ნდობა განახლებით. ## ოფიციალური ნიშანი და რეიტინგი ვებინტერფეისის კატალოგში AiHummer-ის პლაგინები აქვთ **ოფიციალური** სიმბოლო და რანგი პირველები. მესამე მხარის მოდულები ნაჩვენები იქნება სიმბოლოების გარეშე და ორგანიზებული იქნება **ჩამოტვირთვების რაოდენობით**. ოფიციალური დროშა მოდის მონაწილეობიდან `origin` (ოფიციალურად) — ამას ხელსაწყოთ ვერ დაადგენს მანიფესტში. ## სად შემდეგ? - [სავაჭრო პლატფორმის მიმოხილვა და დონეები](/ka/v1.0/marketplace/overview-tiers) — რა არის არსებობს სამი პლაგინის დონე. - [პლაგინების განვითარების ნაკრები](/ka/v1.0/marketplace/sdk) — ეს `manifest.json` ვის `install[]` ნაბიჯები, რომლებიც ახორციელებს ეს სიცოცხლის ციკლი. - [პლაგინის გამოქვეყნება](/ka/v1.0/marketplace/publishing) — კერძო გვერდითი ჩატვირთვა და პუბლიკაცია საზოგადოებაში პირადი კაბინეტიდან. - [კოდის გარეშე ინტეგრაციები](/ka/v1.0/marketplace/zero-code) — დაამატეთ OpenAPI/MCP ინსტრუმენტები სერვისების ინსტალაციის საჭიროების გარეშე.