Установка KUMA на одном сервере

01 октября 2026

ID 222159

Вы можете установить все компоненты KUMA на одном сервере с помощью инструмента Ansible и файла инвентаря single.inventory.yml.

Чтобы установить KUMA на одном сервере:

  1. Скачайте на сервер дистрибутив KUMA kuma-ansible-installer-<номер сборки>.tar.gz и распакуйте его. Архив распаковывается в директорию kuma-ansibleinstaller.
  2. Войдите в директорию с распакованным установщиком.
  3. В зависимости от типа активации решения, который вы планируете использовать, выберите один из вариантов:
    • Если вы планируете использовать активацию решения файлом ключа, поместите файл ключа в директорию <директория установщика>/roles/kuma/files/.

      Файл ключа должен иметь название license.key.

      sudo cp <файл ключа>.key <директория установщика>/roles/kuma/files/license.key

    • Если вы планируете использовать активацию решения с помощью лицензионного кода, переходите к следующему пункту инструкции.

      Активация решения с помощью лицензионного кода доступна только для KUMA 3.4 и более поздних версий. Для более ранних версий KUMA используется активация решения файлом ключа.

  4. Запустите установку компонентов с использованием подготовленного файла инвентаря single.inventory.yml с помощью следующей команды:

    sudo ./install.sh single.inventory.yml

    Если для повышения привилегий требуется указать пароль, выполните следующую команду и укажите пароль по запросу:

    sudo ./install.sh single.inventory.yml --ask-become-pass

  5. Примите условия Лицензионного соглашения.

    Если вы не примете условия Лицензионного соглашения, решение не будет установлено.

    В зависимости от типа активации решения результатом запуска установщика будет один из следующих вариантов:

    • Если вы планируете использовать активацию решения файлом ключа и поместили файл ключа в директорию <директория установщика>/roles/kuma/files/, в результате запуска установщика с файлом инвентаря single.inventory.yml будет установлено Ядро KUMA, все заданные в файле инвентаря сервисы и OOTB-ресурсы. Если в файле инвентаря был задан параметр deploy_example_services=true, демонстрационные сервисы будут установлены.
    • Если вы планируете использовать активацию решения с помощью лицензионного кода или планируете предоставить лицензионный файл позднее, в результате запуска установщика с файлом инвентаря single.inventory.yml будет установлено только Ядро KUMA и сервис Метрики.

      Чтобы установить сервисы, в консоли командной строки укажите лицензионный код. Затем запустите установщик postinstall.sh с файлом инвентаря single.inventory.yml.

      sudo ./postinstall.sh single.inventory.yml

      В результате будут созданы заданные сервисы. Вы можете выбрать, какие ресурсы вы хотите импортировать из репозитория.

  6. По окончании установки войдите в веб-интерфейс KUMA и в строке браузера введите адрес веб-интерфейса KUMA, а затем на странице входа введите учетные данные.

    Адрес веб-интерфейса KUMA – https://<FQDN хоста, на котором установлена KUMA>:7220.

    Учетные данные для входа по умолчанию:
    - логин – admin
    - пароль – mustB3Ch@ng3d!

    После первого входа измените пароль учетной записи admin

Все компоненты KUMA установлены и выполнен вход в веб-интерфейс.

Мы рекомендуем сохранить файл инвентаря, который вы используете для установки решения. С помощью этого файла инвентаря можно будет дополнить систему компонентами или удалить KUMA.

Установку можно расширить до распределенной.

Вам помогла эта статья?
Что нам нужно улучшить?
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!