CLI сілтемесі

sudo aihummer up
aihummer status

# Only check whether a newer release exists
aihummer update --check

# Apply the update
sudo aihummer update

sudo aihummer restart
aihummer logs                 # the gateway unit's journal (default; follows)
aihummer logs --no-follow     # print the tail of the journal and exit
aihummer logs aihummer-stt    # another systemd unit's journal
sudo aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql

sudo aihummer set-password --login admin

aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings get AIHUMMER_STT_URL
aihummer settings list

aihummer license keygen                # generate a signing key
aihummer license sign                  # sign a license
aihummer license show <token>          # decode + verify a token

aihummer loadtest

aihummer plugin init <kind>            # scaffold a manifest (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # validate a manifest against the contract
aihummer plugin keygen                 # ed25519 author key (.key + .pub)
aihummer plugin package ./my-plugin    # build a tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Publish privately to your instance (public publishing is done in the portal — "My plugins")
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz

Бұл `aihummer` Командалық жол құралы жергілікті орнатуды басқарады: ол шлюзді іске қосады және жаңартады (орнату өзі сіздің аккаунт порталындағы жеке орнату сілтемесі арқылы жүзеге асырылады), шлюздің systemd қызметін басқарады, диагностика жүргізеді, резервтік көшірмелермен айналысады, басқару жазықтығының параметрлерін оқиды және жазады, сондай-ақ лицензияларды белгілейді. Бұл бет барлық командаларды тізімдейді. ## Командалар | Бұйрық | Не істейді | |---|---| | `up` / `install` | Gateway systemd қызметін іске қосыңыз (`systemctl start`). Бұл ештеңе орнатпайды — орнату сіздің жеке сілтемеңізден орнату скрипті арқылы жасалады. | | `update [--check]` | Соңғы нұсқасына жаңартыңыз (қолтаңбаны тексеру + бинарлық файлды ауыстыру + қайта іске қосу); `--check` тек жаңарту бар-жоғын хабарлайды. | | `restart` | Шлюз қызметін қайта іске қосу (`systemctl restart`). | | `stop` | Шлюз қызметін тоқтатыңыз (`systemctl stop`). | | `logs [unit] [--no-follow]` | Бір systemd бірлігінің журналына тіркеліңіз (`journalctl -u`); әдепкіде шлюз құрылғысына түседі. `--no-follow` журналдың соңғы жолдарын басып шығарып, жұмысты аяқтайды; онсыз команда бақылауды жалғастырады. | | `status` | Орнатудың жалпы көрінісі, қызметтердің күйі және шлюздің дайындығы (`/readyz`). **Компоненттер** бөлімі міндетті емес сайдкар-юниттердің (іздеу, браузер, сөйлеуден мәтінге, мәтіннен сөйлеуге, видео) күйін хабарлайды; `systemctl` қолжетімсіз болғанда ол «орнатылмаған» демей, күйдің белгісіз екенін адал айтады. | | `doctor` | Үш үкімді диагностика: бәрі жақсы, ескертулермен жұмыс істейді (N) немесе мәселелер табылды. Node.js және флотта тіркелу материалы тексерулері — ескертулер, сәтсіздіктер емес. | | `backup [dir]` | `pg_dump` PostgreSQL күй жазықтығын файлға шығару; егер көрсетілмесе, әдепкі каталог қолданылады. | | `restore <file>` | PostgreSQL-ді шығарып алынған файлдан қалпына келтіру `backup`. | | `uninstall [flags]` | Орнатуды жойыңыз (төмендегі жалауларға қараңыз). Root құқықтарын қажет етеді — оны іске қосу үшін орындаңыз `sudo`. | | `set-password` / `admin-password` | Жергілікті әкімші құпия сөзін орнату/генерациялау (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Дерекқордағы оқу/жазу басқару-жоспар баптауларын — бұл Settings-каталог бұрандамаларының CLI арқылы қалай бапталатыны `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Лицензияларды басқару: кілт жасау, қол қою, берілген токенді декодтау және тексеру. | | `loadtest` | Шлюзге жүктеме сынағын жүргізіңіз. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Плагин SDK: құрылымдау, тексеру, кілттер, пакеттеу, қол қою және жариялау. | | `version` | Нұсқаны басып шығарыңыз. | | `help` | Көмектесіңіз. | ### `uninstall` тулар | Ту | Әсер | |---|---| | `--purge` | Сонымен қатар деректерді жойыңыз (толық жою). | | `--yes` | Растау сұрауын өткізіп жіберу. | | `--no-backup` | Жою алдында резервтік көшірме жасамаңыз. | | `--backup-dir <dir>` | Алдын ала жою алдындағы сақтық көшірмені осы каталогқа жазыңыз. | ## Қолдану мысалдары ### Орнату және іске қосу Орнату сіздің есептік жазба порталыңыздан алынған жеке орнату сілтемесі арқылы жүзеге асырылады (қараңыз [Орнату](/kk/v1.0/getting-started/installation)); содан кейін CLI басталып, қызметті тексереді: ```bash sudo aihummer up aihummer status ``` ### Жаңарту ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Қызметті басқару және журналдар Бұйрықтар бір шлюзді systemd бірлігіне әсер етеді (`AIHUMMER_SERVICE`, әдепкі `aihummer-gateway`); `logs` кез келген systemd бірлік атын қабылдайды. ```bash sudo aihummer restart aihummer logs # the gateway unit's journal (default; follows) aihummer logs --no-follow # print the tail of the journal and exit aihummer logs aihummer-stt # another systemd unit's journal sudo aihummer stop ``` ### Диагностика ```bash aihummer doctor ``` ### Сақтық көшірме жасау және қалпына келтіру `backup` жүгіреді `pg_dump` PostgreSQL күй жазықтығын файлға шығару; `restore` сол қалдық файлды алады. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres шындықтың көзі болып табылады, бірақ сіздің `AIHUMMER_MASTER_KEY` және дақ > каталог жеке сақталуы керек — басты кілтсіз, шифрланған > құпияларды қалпына келтіру мүмкін емес. ### Әкімші құпиясөзін орнату Пәрмен қабылдайды `[--login admin] [--password X]` және қажеттіліктер `AIHUMMER_DATABASE_URL` — әдетте алынған `gateway.env` орнатушы пайдаланушы ретінде немесе арқылы іске қосқанда `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Басқару жазықтығының параметрлері `settings` каталог баптаулары тетіктерін деректер қорында тікелей оқиды және жазады — веб әкімші UI (Басқару → Баптаулар) өңдейтін сол дүкен. Бұл каталог тетіктерін CLI арқылы осылай конфигурациялайды: `gateway.env` мәндер олар үшін еленбейді. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` тек пайдаланушыға арналған каталог кілттерін көрсетеді (жүйелік және ішкі кілттер жасырылған); әр кілт оның қайдан шыққанын көрсететін тегпен белгіленген — `[db]` сіз орнататын мәндер үшін, `[unset]` басқа жағдайда каталог әдепкісімен. ### Лицензиялар `license show` қажет етеді `<token>` дәлел және `AIHUMMER_LICENSE_PUBKEY` айнымалы: ол шифрды шешеді және тексереді **берілген** токен — ол инстанцияның ағымдағы лицензиясын көрсетпейді. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Жүктеу тесті ```bash aihummer loadtest ``` ### Плагиндер ```bash aihummer plugin init <kind> # scaffold a manifest (connector|service|openapi|mcp) aihummer plugin validate manifest.json # validate a manifest against the contract aihummer plugin keygen # ed25519 author key (.key + .pub) aihummer plugin package ./my-plugin # build a tarball + .sha256 aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz # Publish privately to your instance (public publishing is done in the portal — "My plugins") aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz ``` Толық SDK үшін және порталдан жалпы каталогқа жариялау үшін («Менің плагиндерім»), қараңыз [Плагин SDK](/kk/v1.0/marketplace/sdk) және [Плагинді жариялау](/kk/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` root құқықтарын қажет етеді: іске қосу `sudo aihummer uninstall`. Және > `sudo aihummer uninstall --purge --yes` мәліметтерді жояды және өткізіп жібереді > растау сұрауы — алдымен тексерілген сақтық көшірмеңіздің бар екеніне көз жеткізіңіз. ## Қоршаған орта Айнымалылар `aihummer` құрал өзі оқиды: | Айнымалы | Мақсат | |---|---| | `AIHUMMER_SERVICE` | Шлюздің systemd бірлік атауы (әдепкі `aihummer-gateway`) — нысаны `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Шақыру бетінің URL мекенжайы `status`/`doctor`/`loadtest` (әдепкі `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — қажет `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | CLI шығысы мен анықтаманың тілі: `ru` (әдепкі) немесе `en`. | Көптеген командаларға root қажет (`systemctl`) — оларды іске қосу үшін `sudo`. ## Келесі қайда - Инстанцияны баптау: [Қоршаған орта айнымалылары](/kk/v1.0/reference/env-vars). - Агент қандай құралдарды пайдалана алатынын шешіңіз: [Құралдар каталогы](/kk/v1.0/reference/tools-catalog).