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` | Шлюздің systemd қызметін іске қосу (`systemctl start`). Ештеңе орнатпайды — орнатуды дербес сілтемедегі орнату сценарийі орындайды. | | `update [--check]` | Соңғы шығарылымға дейін жаңарту; `--check` тек жаңартудың бар-жоғын хабарлайды. | | `restart` | Қызметтерді қайта іске қосу. | | `stop` | Қызметтерді тоқтату. | | `logs [svc]` | Журналдарды бақылау; сүзу үшін қызмет атауын беріңіз. | | `status` | Қызмет күйін көрсету. | | `doctor` | Диагностика / денсаулық тексерулерін орындау. | | `backup [dir]` | Сақтық көшірме жасау (қажет болса мақсатты каталогқа). | | `restore <file>` | Сақтық көшірме файлынан қалпына келтіру. | | `uninstall [flags]` | Орнатуды жою (төмендегі жалаушаларды қараңыз). Root талап етеді — `sudo` арқылы іске қосыңыз. | | `set-password` / `admin-password` | Жергілікті әкімші құпиясөзін орнату. | | `settings {set\|get\|list}` | Дерекқордағы control-plane параметрлерін оқу/жазу — Параметрлер каталогының тетіктері осылай `gateway.env` орнына CLI-дан бапталады. | | `license {keygen\|sign\|show}` | Лицензияларды басқару (кілт жасау, қол қою, көрсету). | | `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 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 > каталогының сақтық көшірмесін бөлек жасау керек — мастер кілтсіз шифрланған > құпияларды қалпына келтіру мүмкін емес. ### Әкімші құпиясөзін орнату ```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](/en/v1.0/marketplace/sdk) және [Плагинді жариялау](/en/v1.0/marketplace/publishing) бөлімдерін қараңыз. > [!WARNING] > `uninstall` root талап етеді: `sudo aihummer uninstall` деп іске қосыңыз. Ал > `sudo aihummer uninstall --purge --yes` деректерді жояды және растау сұрауын > өткізіп жібереді — алдымен тексерілген сақтық көшірмеңіздің бар екеніне көз > жеткізіңіз. ## Әрі қарай қайда - CLI нені орнататынын баптаңыз: [Орта айнымалылары](/en/v1.0/reference/env-vars). - Агент қандай құралдарды қолдана алатынын шешіңіз: [Құралдар каталогы](/en/v1.0/reference/tools-catalog).