Справочник CLI

aihummer install
aihummer status

# Только проверить наличие нового релиза
aihummer update --check

# Применить обновление
aihummer update

aihummer restart
aihummer logs                 # все сервисы
aihummer logs gateway         # один сервис
aihummer stop

aihummer doctor

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

aihummer set-password

aihummer license keygen        # сгенерировать ключ подписи
aihummer license sign          # подписать лицензию
aihummer license show          # показать текущую лицензию

aihummer loadtest

aihummer plugin init <kind>            # каркас манифеста (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # проверить манифест по контракту
aihummer plugin keygen                 # ed25519-ключ автора (.key + .pub)
aihummer plugin package ./my-plugin    # собрать tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Публикация: приватно (в свой инстанс) или публично (PR в каталог)
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` управляет host-native установкой: устанавливает и обновляет gateway, управляет systemd-сервисами, запускает диагностику, обрабатывает бэкапы и подписывает лицензии. На этой странице перечислены все команды. ## Команды | Команда | Что делает | |---|---| | `up` / `install` | Установить (или поднять) gateway и сайдкары. | | `update [--check]` | Обновить до последнего релиза; `--check` только сообщает, есть ли обновление. | | `restart` | Перезапустить сервисы. | | `stop` | Остановить сервисы. | | `logs [svc]` | Показывать логи; передайте имя сервиса для фильтра. | | `status` | Показать статус сервисов. | | `doctor` | Запустить диагностику / проверки здоровья. | | `backup [dir]` | Создать бэкап (опционально в указанный каталог). | | `restore <file>` | Восстановить из файла бэкапа. | | `uninstall [flags]` | Удалить установку (флаги ниже). | | `set-password` / `admin-password` | Установить локальный пароль администратора. | | `license {keygen\|sign\|show}` | Управление лицензиями (генерация ключа, подпись, показ). | | `loadtest` | Запустить нагрузочный тест против gateway. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | SDK плагинов: каркас, валидация, ключи, упаковка, подпись и публикация (private/public). | | `version` | Вывести версию. | | `help` | Показать справку. | ### Флаги `uninstall` | Флаг | Эффект | |---|---| | `--purge` | Также удалить данные (полное удаление). | | `--yes` | Пропустить запрос подтверждения. | | `--no-backup` | Не делать бэкап перед удалением. | | `--backup-dir <dir>` | Записать бэкап перед удалением в этот каталог. | ## Примеры использования ### Установка и запуск ```bash aihummer install aihummer status ``` ### Обновление ```bash # Только проверить наличие нового релиза aihummer update --check # Применить обновление aihummer update ``` ### Управление сервисами и логи ```bash aihummer restart aihummer logs # все сервисы aihummer logs gateway # один сервис 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 license keygen # сгенерировать ключ подписи aihummer license sign # подписать лицензию aihummer license show # показать текущую лицензию ``` ### Нагрузочный тест ```bash aihummer loadtest ``` ### Плагины ```bash aihummer plugin init <kind> # каркас манифеста (connector|service|openapi|mcp) aihummer plugin validate manifest.json # проверить манифест по контракту aihummer plugin keygen # ed25519-ключ автора (.key + .pub) aihummer plugin package ./my-plugin # собрать tarball + .sha256 aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz # Публикация: приватно (в свой инстанс) или публично (PR в каталог) 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 и обоих режимов публикации — в [Plugin SDK](/v1.0/marketplace/sdk) и [Публикации плагина](/v1.0/marketplace/publishing). > [!WARNING] > `aihummer uninstall --purge --yes` удаляет данные и пропускает подтверждение. > Сначала убедитесь, что у вас есть проверенный бэкап. ## Куда дальше - Настройка того, что устанавливает CLI: [Переменные окружения](/v1.0/reference/env-vars). - Выбор доступных агенту инструментов: [Каталог инструментов](/v1.0/reference/tools-catalog).