Суурилуулах болон шинэчлэх

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-д плагин суулгах нь админ UI-д нэг удаагийн даралт юм, гэхдээ тэр даралтын ард тодорхойлогдсон, хост-орон нутгийн амьдралын мөчлөг байдаг. Платформ нь плагиныг татаж авч, зарласан суулгах алхмуудыг нь гүйцэтгэж, дүрслэлт үүсгэнэ **оронд хязгаарлагдсан systemd нэгж**, мөн зөвхөн эрүүл мэндийн шалгалтанд хариу өгсөн тохиолдолд л залгаасыг эрүүл гэж үздэг. Тэгээд тус бүрийн суулгалт өөрөө өөрийгөө шинэчилж байдаг. ## Админ UI-ээс нэг товшилтоор суулгана Та залгаасуудыг захиргаа UI-аас суулгаж, удирддаг бөгөөд энэ нь захиргаа модуль API-д тулгуурладаг: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Модулын slug нь замд биш, JSON хүсэлтийн биеийн хэсэгт ордог: ```json { "slug": "einstein", "version": "" } ``` Гар аргаар утас холбох зүйл огт байхгүй: каталогоос нэг нэмэлт сонгоод, суулгах дээр дарахад, байрлуулагч өөрөө хариуцах болно. > [!NOTE] > Суваг холбогчийг үндсэн багцын гадна суулгах (зөвхөн Телеграм) > идэвхтэй нэгийг шаарддаг **Эхлүүлэгч**, **Бизнес** эсвэл **Энтэрпрайз** эрх > Комьюнити төлөвлөгөөнд ийм хүсэлт буцааж ирдэг **HTTP 402 "шинэчлэлт шаардлагатай"** > (код `plan_limit`) — үзэх [Лицензийн олголт](/mn/v1.0/commercial/licensing). > [!NOTE] > Тэр **Эйнштейн** санах ойн нэмэлт **суурилуулсан**: үүнийг автомат байдлаар суулгадаг, > “Дотоод суурилагдсан” тэмдэгтэй бөгөөд устгах эсвэл зогсоох боломжгүй. ## SystemdDeployer урсгал Моторын дор энэ нь **SystemdТарьгч** эдгээр алхмуудыг гүйцэтгэдэг: 1. **Тарбал татаж авах** сонгосон залгаасын хувьд. 2. **Манифестийг ажиллуул `install[]` алхамууд** плагинаар тунхагласан. 3. **Сандбоксдсон systemd нэгжийг ажиллуулна уу** плагинд зориулсан. 4. **Судалгаа `/healthz`** үйлчилгээг эрүүл гэж мэдээлэх хүртэл. ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` Зөвхөн тухайн үед `/healthz` амжилттай бол суулгалт идэвхтэй гэж тэмдэглэгдэнэ — ажиллахгүй байгаа нэмэлт нь суулгасан мэт нам гүм тооцогдохгүй. ## Хост-дотоод, хамгаалагдсан systemd — Docker биш Бүх нэмэлтүүд дараах байдлаар ажилладаг **өөрийн тусгаарлагдсан systemd үйлчилгээ**. Сав баглаа боодол байхгүй, Docker байхгүй, зохицуулагч байхгүй: плагин нь өөрийн нэгж, порт болон тусгаарлах хязгаарлалттай, системийн бусад хэсэг шиг systemd-аар хянагддаг удирдлагатай Linux үйлчилгээ юм. > [!WARNING] > AiHummer нь хост-д суурилсан юм. Плагинуудыг системийн sandboxed service байдлаар байршуулдаг > сарниулах тарболоос — **Docker саванд хэзээ ч биш.** Хэрвээ удирдагч танд хэлбэл > "Плагин савыг ажиллуулах" гэж хэлэхэд, энэ нь AiHummer-ийг тодорхойлдоггүй. ## /healthz ашиглан эрүүл мэндийн шалгалт Түгээх программ нь залгуулгын мэдээллийг шалгадаг `/healthz` амжилт зарлахын өмнө төгсгөлийн цэг. Энэ эрүүл мэндийн хаалга нь нэг товшилтоор суулгахыг аюулгүй болгож байдаг: эвдрэлтэй эсвэл буруу тохируулагдсан залгаас суулгах явцад баригддаг бөгөөд үйлдвэрлэлийн үед илрэхгүй. ## Суулгалтаас өмнөх автомат шинэчлэлт Шинэчлэлтүүдийг удирдана **суурилуулалтын нэг бүрт**. Тавигдсан бүх нэмэлт функцүүд өөрийн хуваарьт тохируулгаар автоматаар шинэчлэгддэг тул шинэ хувилбар каталогт орсон ч нэмэлт функцийг шинэчлэхийн тулд гараар дахин суулгах шаардлагагүй. Шинэчлэлт хийхдээ ч анх удаа суулгахтай адил татаж авах → суулгах алхмууд → нэгжийг дүрсэлсэн → эрүүл мэндийн шалгалт хийх урсгал ажиллана. > [!TIP] > Автоматаар шинэчлэх нь суулгалт бүрт хамаарах тул та зарим нэмэлтүүдийг тогтоон хадгалах боломжтой > өөрсдийг нь дагаж мөрдөхөд боломж олгож — бүрэн суулгалт бүр өөрийн амьдралын мөчийг удирддаг. ## Олон эх сурвалжийн каталог Каталог одоо ганц URL хаястай холбогдоогүй байна. Тэр **нийтийн каталог** гуравдагч талын залгаасууд нь суулгаж өгсөн байдлаар ирдэг **анхдагч эх сурвалж** (суулгахад үргэлжлүүлэн нэмэгдсэн) — та үүнийг өөрөө нэмэхгүй. Дотор **Нэмэлтүүд → Эх сурвалжууд** (Админ UI, эсвэл `POST /v1/admin/modules/catalog/sources`) та өөрийн нэмэлт эх үүсвэрүүдийг оруулж болно. Гейтвей нь эхлэх үед болон авто-шинэчлэх интервал дээр идэвхжсэн бүх эх үүсвэрийг синк хийдэг. - Тэр **албан ёсны эх сурвалж** (нэгдүгээр талын модулууд) анхдагчаар бэхлэгдсэн ба итгэлтэй гэж тооцогддог — таслан салгасан объект бөгөөд **дээд бичигдээгүй** бусад эх сурвалжаар. - Тэр **нийтлэг каталог** энэ бол үрэлсэн анхдагч эх сурвалж юм; **хувийн эх сурвалжууд** бол оператор нэмсэн. Бүрэн бүтээл болгонд нэг `origin`, ба тэр `origin` гарын үсгийг аль тулгуурт баталгаажуулахаа шийддэг эсрэг (албан ёсоор → наалттай түлхүүр, хувийн → итгэлцлийн сан). Нийтлэг каталогт нийтлэх талаар, харна уу [Плагин нийтлэх](/mn/v1.0/marketplace/publishing). ## Итгэлцлийн загвар ба тогтоосон түлхүүр Суулгалт нь плагины гарын үсгийг эх сурвалжаар нь баталгаажуулдаг: - **албан ёсны** →-тай нэгтгэн шалгасан **голд хадгалагдсан бүртгэлийн түлхүүр**. Итгэдэг анхдагч, операторын ямар ч үйлдэлгүй. - **хувийн** (хажуугаар ачаалах) → **тухайн суулгалтын итгэмжлэлийн санд** тулган баталгаажуулна; Зохиогчийн түлхүүрийг оператор нь байршуулалтын үед (нэг товшилтоор) баталдаг. - **гарын үсэггүй** → татгалзсан, хөгжүүлэлтийн горимд эсвэл (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, зөвхөн орон нутгийн хөгжүүлэлт). > [!WARNING] > **Нийгэмлэгийн залгаасуудыг одоогоор суулгах боломжгүй — энэ нь холболтын алдаа > биш.** Нийгэмлэгийн каталогид гарын үсэг зурсан түлхүүрийг эргүүлэн татсан; > шинэ түлхүүр гарах хүртэл гарын үсгийн шалгалт ийм бичлэгүүдийг татгалзана. > Үүнээс тусад нь, гуравдагч талын код таны сервер дээр үйлчилгээ болж хараахан > ажиллуулагдахгүй: тусгаарлагдсан ажиллах орчин гарах хүртэл зөвхөн өөрийн талдаа > ажиллаж, сүлжээгээр холбогддог интеграцуудыг зөвшөөрнө. > > **Та юу харах вэ:** «суулгах» товчийг дарсны дараа ердийн «суулгаж байна» гэсэн > мэдэгдэл гарна, гэвч залгаас суулгасны жагсаалтад **хэзээ ч гарч ирэхгүй**. > Татгалзсан шалтгаан гарцын бүртгэлд бичигдэнэ — удирдлагын самбар дахь > **Бүртгэл** хэсгийг нээнэ үү. > > **Өнөөдөр юу ажиллаж байна:** > > - албан ёсны каталог дахь **AiHummer-ийн залгаасууд** — урьдын адил суудаг, > тэдгээрт өөр, хүчинтэй гарын үсэг байдаг; > - **HTTP дээрх MCP сервер** — хөгжүүлэлтгүйгээр хэрэгслийн эх сурвалж болж > холбогдоно, код таны талд үлдэнэ; > - **OpenAPI тодорхойлолтоор интеграц** — мөн адил, суулгах үйлчилгээгүйгээр. > > Өөрийн залгаасаа гараар ачаалах нь гарын үсгийн шалгалтыг давна, гэхдээ зөвхөн > **HTTP дээрх алсын MCP** эсвэл OpenAPI интеграц хэлбэрээр ажиллана; тухайн > сервер дээр үйлчилгээ болж эхлэх шаардлагатай бүтээц татгалзагдана. ## Гэрчлэгдсэн шинэчлэлүүд Шинэчлэлт **нэг ижил гарын үсгийн хаалгыг дахин ажиллуулдаг** анхны суулгалтын адил: шинэ хувилбар руу шилжих үед гарын үсгийг дахин нэг ижил итгэмжлэл дээр шалгана. Шинэчлэлт **өөрөөр давж гарах боломжгүй** шалгалт — та шинэчлэлтээр итгэлцлийг дээшлүүлж чадахгүй. ## Албан ёсны тэмдэг болон зэрэг Вэб UI каталогт, AiHummer-аас авсан плагинуудыг агуулдаг **Албан ёсны** шагнал ба цол хамгийн түрүүнд. Гуравдагч талын нэмэлтүүд шагналгүйгээр харуулагдаж, ангилагддаг **таталгын тоогоор**. Албан ёсны далбаа нь нэг оролцогчийн оролцооноос гаралтай `origin` (албан ёсны) — үүнийг гар аргаар manifest-д тохируулах боломжгүй. ## Дараа хаашаа явах вэ - [Зах зээлийн тойм ба зэрэглэл](/mn/v1.0/marketplace/overview-tiers) — юу нь гурван нэмэлтийн шатлал байна. - [Плагин SDK](/mn/v1.0/marketplace/sdk) — тэр `manifest.json` хүний `install[]` энэ амьдралын мөчлөгийн процесс хэрхэн ажилладаг. - [Плагин нийтлэх](/mn/v1.0/marketplace/publishing) — хувийн талын ачаалалт ба хуудсан дахь хувийн кабинетаар нийгмийн хэвлэлт хийх. - [Шуурхай кодгүй нэгдлүүд](/mn/v1.0/marketplace/zero-code) — OpenAPI/MCP хэрэгслүүдийг нэмэх суулгах үйлчилгээ байхгүй.