CLI шилтемеси

aihummer install
aihummer status

# Жаңы релиз бар-жогун гана текшерүү
aihummer update --check

# Жаңылоону колдонуу
aihummer update

aihummer restart
aihummer logs                 # all services
aihummer logs gateway         # one service
aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/backup-2026-06-26.tar

aihummer set-password

aihummer settings set AIHUMMER_STT_URL http://localhost: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          # show the current license

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) or publicly (PR to the catalog)
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz
aihummer plugin publish --public --dir ./my-plugin --key author.key \
  --artifact-url https://you.example/my-plugin-1.0.0.tar.gz --publisher you \
  --description "..." --icon https://you.example/icon.svg

`aihummer` командалык-сап куралы хост-нативдик орнотууну башкарат: ал gateway'ди ишке киргизет жана жаңылайт (орнотуунун өзү жеке кабинеттеги жеке орнотуу шилтемеси аркылуу аткарылат), systemd кызматтарын башкарат, диагностиканы иштетет, резервдик көчүрмөлөрдү иштетет, control-plane жөндөөлөрүн окуйт/жазат жана лицензияларга кол коёт. Бул бет ар бир команданы тизмелейт. ## Командалар | Команда | Эмне кылат | |---|---| | `up` / `install` | Gateway'дин systemd кызматын ишке киргизет (`systemctl start`). Эч нерсе орнотпойт — орнотууну жеке шилтемедеги орнотуу скрипти аткарат. | | `update [--check]` | Акыркы релизге жаңылоо; `--check` жаңылоо бар-жогун гана кабарлайт. | | `restart` | Кызматтарды кайра иштетет. | | `stop` | Кызматтарды токтотот. | | `logs [svc]` | Логдорду чыгарат; чыпкалоо үчүн кызмат атын бериңиз. | | `status` | Кызмат абалын көрсөтөт. | | `doctor` | Диагностиканы / ден соолук текшерүүлөрүн иштетет. | | `backup [dir]` | Резервдик көчүрмө түзөт (милдеттүү эмес максаттуу каталогго). | | `restore <file>` | Резервдик көчүрмө файлынан калыбына келтирет. | | `uninstall [flags]` | Орнотууну алып салат (төмөндөгү флагдарды караңыз). Root талап кылат — `sudo` менен иштетиңиз. | | `set-password` / `admin-password` | Жергиликтүү admin сырсөзүн коёт. | | `settings {set\|get\|list}` | Маалымат базасындагы control-plane жөндөөлөрүн окуйт/жазат — Жөндөөлөр каталогунун параметрлери `gateway.env` ордуна CLI'ден ушинтип коюлат. | | `license {keygen\|sign\|show}` | Лицензияларды башкарат (ачкыч түзүү, кол коюу, көрсөтүү). | | `loadtest` | Gateway'ге каршы жүк тестин иштетет. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Плагин SDK: scaffold, текшерүү, ачкычтар, пакеттөө, кол коюу жана жарыялоо (жеке/ачык). | | `version` | Версияны басып чыгарат. | | `help` | Жардамды көрсөтөт. | ### `uninstall` флагдары | Флаг | Эффект | |---|---| | `--purge` | Дайындарды да алып салат (толук алып салуу). | | `--yes` | Ырастоо сурамын өткөрүп жиберет. | | `--no-backup` | Алып салуудан мурда резервдик көчүрмө албайт. | | `--backup-dir <dir>` | Алып салуудан мурдагы резервдик көчүрмөнү бул каталогго жазат. | ## Колдонуу мисалдары ### Орнотуу жана ишке киргизүү Орнотууну жеке кабинеттеги жеке орнотуу шилтемеси аткарат ([Орнотууну](/ky/v1.0/getting-started/installation) караңыз); андан кийин CLI кызматты ишке киргизип, текшерет: ```bash aihummer install aihummer status ``` ### Жаңылоо ```bash # Жаңы релиз бар-жогун гана текшерүү aihummer update --check # Жаңылоону колдонуу aihummer update ``` ### Кызматты башкаруу жана логдор ```bash aihummer restart aihummer logs # all services aihummer logs gateway # one service aihummer stop ``` ### Диагностика ```bash aihummer doctor ``` ### Резервдик көчүрмө жана калыбына келтирүү ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/backup-2026-06-26.tar ``` > [!TIP] > Postgres — чындыктын булагы, бирок сиздин `AIHUMMER_MASTER_KEY` жана blob > каталогуңуз өзүнчө резервделиши керек — мастер ачкычсыз шифрленген сырлар > калыбына келтирилбейт. ### Admin сырсөзүн коюу ```bash aihummer set-password ``` ### Жөндөөлөр ```bash aihummer settings set AIHUMMER_STT_URL http://localhost:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` Каталогдун колдонуучуга багытталган ачкычтарын гана көрсөтөт (системалык жана кызматтык ачкычтар жашырылган); ар бир ачкычтын жанында булагы белгиленген — сиз койгон маанилер үчүн `[db]`, демейки мааниси менен тургандар үчүн `[unset]`. ### Лицензиялар ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show # show the current license ``` ### Жүк тести ```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) or publicly (PR to the catalog) aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz aihummer plugin publish --public --dir ./my-plugin --key author.key \ --artifact-url https://you.example/my-plugin-1.0.0.tar.gz --publisher you \ --description "..." --icon https://you.example/icon.svg ``` Толук SDK жана эки жарыялоо режими үчүн [Плагин SDK](/ky/v1.0/marketplace/sdk) жана [Плагин жарыялоо](/ky/v1.0/marketplace/publishing) бөлүмдөрүн караңыз. > [!WARNING] > `uninstall` root талап кылат: `sudo aihummer uninstall` деп иштетиңиз. Ал эми > `sudo aihummer uninstall --purge --yes` дайындарды алып салат жана ырастоо > сурамын өткөрүп жиберет — адегенде текшерилген резервдик көчүрмөңүз бар > экенине ынаныңыз. ## Андан ары кайда - CLI эмнени орнотоорун конфигурациялаңыз: [Чөйрө өзгөрмөлөрү](/ky/v1.0/reference/env-vars). - Агент кайсы куралдарды колдоно аларын аныктаңыз: [Куралдар каталогу](/ky/v1.0/reference/tools-catalog).