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` | Шлюз системасын иштетүү үчүн 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>` | Алдын ала өчүрүүдөн мурун камдык көчүрмөнү ушул каталогго жазуу. | ## Колдонуу мисалдары ### Орнотуу жана ишке киргизүү Орнотууну жеке эсеп порталдан алган орнотуу шилтемеси аркылуу жасоого болот (караңыз [Орнотуу](/ky/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 (Management → Settings) редакциялаган ошол эле дүкөн. Каталогдун тетиктери 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` variable: ал кодду чечет жана текшерет **берилген** токен — ал анын учурдагы лицензиясын көрсөтпөйт. ```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](/ky/v1.0/marketplace/sdk) жана [Плагин жарыялоо](/ky/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` root талап кылынат: иштетүү `sudo aihummer uninstall`. Жана > `sudo aihummer uninstall --purge --yes` маалыматты өчүрөт жана өткөрүп келет > тастыктоо сурамчы — алды менен текшерилген резервдик көчүрмөңүз бар экендигине ынануу. ## Айлана-чөйрө Айнымалылар `aihummer` куралдын өзү мындай окуйт: | Өзгөрмө | Максат | |---|---| | `AIHUMMER_SERVICE` | Эшик системасынын unit аталышы (адатта) `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`. ## Келерки кайда - Инстанцияны конфигурациялоо: [Айлана-чөйрө өзгөрмөлүүлөр](/ky/v1.0/reference/env-vars). - Агент колдоно турган куралдарды чечип алыңыз: [Куралдар каталогу](/ky/v1.0/reference/tools-catalog).