Установка KUMA в распределенной конфигурации

Установка KUMA производится помощью инструмента Ansible и YML-файла инвентаря. Установка производится с контрольной машины, при этом все компоненты KUMA устанавливаются на целевых машинах.

Чтобы установить KUMA:

1. На контрольной машине войдите в директорию с распакованным установщиком.

   cd kuma-ansible-installer

2. В зависимости от типа активации решения, который вы планируете использовать, выберите один из вариантов:
   • Для активации решения с помощью файла ключа, поместите файл ключа в директорию <папка установщика>/roles/kuma/files/.

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

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

   • Для активации решения с помощью кода активации, переходите к следующему пункту инструкции.
3. Запустите установку компонентов с использованием подготовленного файла инвентаря distributed.inventory.yml, находясь в директории с распакованным установщиком:

   sudo ./install.sh distributed.inventory.yml

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

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

4. Если вы хотите использовать нестандартный порт для подключения по протоколу SSH в ходе установки, выберите один из следующих вариантов:
   • Если порт одинаковый для группы хостов, укажите в файле инвентаря в группе vars.

     Пример файла инвентаря distributed.inventory.yml с одним нестандартным портом для группы хостов хранилища

     all:

     vars:

     deploy_to_k8s: false

     need_transfer: false

     generate_etc_hosts: false

     deploy_example_services: false

     no_firewall_actions: false

     kuma:

     vars:

     ansible_connection: ssh

     ansible_user: root

     children:

     kuma_core:

     hosts:

     kuma-core-1.example.com:

     ip: 0.0.0.0

     kuma_collector:

     hosts:

     kuma-collector-1.example.com:

     ip: 0.0.0.0

     kuma_correlator:

     hosts:

     kuma-correlator-1.example.com:

     ip: 0.0.0.0

     kuma_storage:

     vars:

     ansible_port: 2222

     hosts:

     kuma-storage-cluster1-server1.example.com:

     ip: 0.0.0.0

     shard: 1

     replica: 1

     keeper: 0

     kuma-storage-cluster1-server2.example.com:

     ip: 0.0.0.0

     shard: 1

     replica: 2

     keeper: 0

     kuma-storage-cluster1-server3.example.com:

     ip: 0.0.0.0

     shard: 2

     replica: 1

     keeper: 0

     kuma-storage-cluster1-server4.example.com:

     ip: 0.0.0.0

     shard: 2

     replica: 2

     keeper: 0

     kuma-storage-cluster1-server5.example.com:

     ip: 0.0.0.0

     shard: 0

     replica: 0

     keeper: 1

     kuma-storage-cluster1-server6.example.com:

     ip: 0.0.0.0

     shard: 0

     replica: 0

     keeper: 2

     kuma-storage-cluster1-server7.example.com:

     ip: 0.0.0.0

     shard: 0

     replica: 0

     keeper: 3

   • Если для подключения к каждому хосту используется отдельный нестандартный порт, укажите порт для каждого хоста в файле инвентаря, например:

     Пример файла инвентаря distributed.inventory.yml с отдельным нестандартным портом для каждого хоста хранилища

     all:

     vars:

     deploy_to_k8s: false

     need_transfer: false

     generate_etc_hosts: false

     deploy_example_services: false

     no_firewall_actions: false

     kuma:

     vars:

     ansible_connection: ssh

     ansible_ssh_private_key_file: <полный путь к файлу с ключом SSH>

     ansible_user: <пользователь из группы sudo>

     ansible_become: true

     children:

     kuma_core:

     hosts:

     kuma-core-1.example.com:

     raft_node_addr: ""

     ip: 0.0.0.0

     kuma_metrics:

     hosts:

     kuma-metrics.example.com

     ip: 0.0.0.0

     kuma_collector:

     hosts:

     kuma-collector-1.example.com:

     ansible_port: 2222

     ip: 0.0.0.0

     kuma_correlator:

     hosts:

     kuma-correlator-1.example.com:

     ansible_port: 2223

     ip: 0.0.0.0

     kuma_storage:

     vars:

     ansible_port: 2224

     hosts:

     kuma-storage-cluster1-server1.example.com:

     ip: 0.0.0.0

     shard: 1

     replica: 1

     keeper: 0

     kuma-storage-cluster1-server2.example.com:

     ip: 0.0.0.0

     shard: 1

     replica: 2

     keeper: 0

     kuma-storage-cluster1-server3.example.com:

     ip: 0.0.0.0

     shard: 2

     replica: 1

     keeper: 0

     kuma-storage-cluster1-server4.example.com:

     ip: 0.0.0.0

     shard: 2

     replica: 2

     keeper: 0

     kuma-storage-cluster1-server5.example.com:

     ip: 0.0.0.0

     shard: 0

     replica: 0

     keeper: 1

     kuma-storage-cluster1-server6.example.com:

     ip: 0.0.0.0

     shard: 0

     replica: 0

     keeper: 2

     kuma-storage-cluster1-server7.example.com:

     ip: 0.0.0.0

     shard: 0

     replica: 0

     keeper: 3

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

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

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

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

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

     sudo ./postinstall.sh distributed.inventory.yml

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

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

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

   Учетные данные для входа по умолчанию:

   • логин: admin
   • пароль: mustB3Ch@ng3d!

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

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

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