Расширение кластера Raft

Расширение кластера Raft в KUMA состоит из следующих этапов:

Подготовка серверов к установке сервисов Ядра KUMA

Чтобы подготовить серверы к установке дополнительных сервисов Ядра KUMA:

1. Убедитесь, что для установки дополнительных сервисов Ядра KUMA вы используете установщик той же версии, который был использован для установки вашего текущего экземпляра KUMA. Полный номер версии должен быть идентичным.
2. На контрольной машине войдите в папку с распакованным установщиком.

   cd kuma-ansible-installer

3. В зависимости от способа активации, выполните одно из следующих действий:
   • Файл ключа.

     Поместите файл ключа license.key в директорию <папка установщика>/roles/kuma/files/:

     cp <license>.key <installer_directory>/roles/kuma/files/license.key

     где:

     • <license> — имя файла ключа.
     • <installer_directory> — директория установщика.
   • Код активации.
   • Действия не требуются. Переходите к следующему пункту инструкции.
4. Скопируйте шаблон expand.inventory.yml.template и создайте файл инвентаря с именем expand.inventory.yml:

   cp expand.inventory.yml.template expand.inventory.yml

   Откройте файл инвентаря expand.inventory.yml и в секции kuma_core_peers укажите в серверы, которые вы добавляете. Общее количество серверов в секциях kuma_core и kuma_core_peers должно быть нечетным.

   Пример файла инвентаря expand.inventory.yml для добавления серверов для дополнительных сервисов Ядра KUMA

   kuma:

   vars:

   no_firewall_actions: false

   ansible_connection: ssh

   ansible_user: root

   children:

   kuma_core_peers:

   hosts:

   kuma-core-4.example.com:

   ip: 0.0.0.0

   kuma-core-5.example.com:

   ip: 0.0.0.0

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

   ./expand.sh expand.inventory.yml

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

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

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

   • Файл ключа.

     Серверы, указанные в файле инвентаря expand.inventory.yml, будут подготовлены к установке дополнительных сервисов Ядра KUMA.

   • Код активации.

     Будет установлено только Ядро KUMA. Вам потребуется активировать решение с помощью кода активации или файла ключа.

На каждую целевую машину, указанную в файле инвентаря expand.inventory.yml, будут добавлены файлы для создания и установки дополнительных сервисов Ядра KUMA.

Создание и установка дополнительных сервисов Ядра KUMA

Чтобы создать и установить дополнительные сервисы Ядра KUMA:

1. В веб-интерфейсе откройте раздел Ресурсы → Активные сервисы.
2. В панели инструментов или в меню нажмите Добавить и выберите Добавить сервис Ядро.
3. В открывшейся панели введите имя Ядра KUMA и нажмите Добавить.

   Добавленное Ядро KUMA отобразится в таблице сервисов.

4. В контекстном меню добавленного Ядра KUMA выберите Копировать идентификатор.

   Вы также можете установить флажок рядом с добавленным Ядром KUMA и в панели инструментов или в меню () нажать Копировать идентификатор.

   Идентификатор понадобится для установки Ядра KUMA на сервере.

5. Установите Ядро KUMA на сервере. Для этого на целевой машине выполните следующую команду.

   sudo /opt/kaspersky/kuma/kuma core --raft.join <FQDN>:7210 --pair.fingerprint <CA_cert_ID> --id <service_ID> --install

   где:

   • <FQDN> — полное доменное имя хоста из секции kuma_core, где запущен первый сервис Ядра KUMA.
   • <CA_cert_ID> — идентификатор отпечатка CA-сертификата, используемый для проверки подлинности при подключении сервиса.

     Параметр --pair.fingerprint является необязательным. При создании сервиса KUMA автоматически добавляет этот параметр в команду установки и указывает идентификатор отпечатка.
     Вы можете выполнить установку сервиса без указания параметра --pair.fingerprint. В этом случае KUMA использует значение insecure по умолчанию, что не обеспечивает проверку подлинности CA-сертификата Ядра KUMA при установлении соединения. Если используется значение insecure, обновление отпечатка после перевыпуска CA-сертификата не требуется.

     Для обеспечения проверки подлинности CA-сертификата Ядра KUMA рекомендуется не удалять параметр --pair.fingerprint с идентификатором отпечатка при установке сервиса. При перевыпуске CA-сертификата необходимо скопировать новый отпечаток сертификата в веб-интерфейсе и перезапустить сервис с обновленным значением параметра.

   • <service_ID> — идентификатор сервиса, скопированный из веб-интерфейса KUMA.

Создайте и установите Ядро KUMA для каждого хоста из секции kuma_core_peers. На каждом хосте может быть установлен только один сервис Ядра KUMA.

Актуализация файла инвентаря distributed.inventory.yml

Впишите секцию kuma_core_peers в файле инвентаря distributed.inventory.yml и укажите серверы для дополнительных сервисов Ядра KUMA, которые вы указали в файле инвентаря expand.inventroy.yml, чтобы в файле инвентаря distributed.inventory.yml были актуальные сведения на случай обновления KUMA.

Результат

Расширение кластера Raft завершено. Сервисы Ядра KUMA добавлены в кластер Raft и подключены к core-1. При установке остальных сервисов KUMA вы можете указать в команде установки несколько URL через запятую для подключения к сервисам Ядра KUMA в кластере Raft.