Kaspersky Symphony XDR: Open Single Management Platform

Подготовка файла инвентаря KUMA

Развернуть все | Свернуть все

Файл инвентаря KUMA – это файл в формате YAML, который содержит параметры установки для развертывания сервисов KUMA, не включенных в кластер Kubernetes. Путь к файлу инвентаря KUMA включен в конфигурационный файл, который используется Kaspersky Deployment Toolkit для развертывания Open Single Management Platform.

Шаблоны файла инвентаря KUMA находятся в дистрибутиве. Если вы хотите установить сервисы KUMA (хранилище, коллектор и коррелятор) на одном устройстве, используйте файл single.inventory.yaml. Чтобы установить сервисы на нескольких устройствах в сетевой инфраструктуре, используйте файл distributed.inventory.yaml.

Рекомендуется создать резервную копию файла инвентаря KUMA, который вы использовали для установки сервисов KUMA. Вы можете использовать его для удаления KUMA.

Чтобы подготовить файл инвентаря KUMA,

откройте шаблон файла инвентаря KUMA, расположенный в дистрибутиве, и измените переменные в файле инвентаря.

Файл инвентаря KUMA содержит следующие блоки:

  • all block

    Блок all содержит переменные, которые применяются ко всем устройствам, указанным в файле инвентаря. Переменные находятся в разделе vars.

  • kuma block

    Блок kuma содержит переменные, которые применяются к устройствам, на которых будут установлены сервисы KUMA. Эти устройства перечислены в блоке kuma в разделе children. Переменные находятся в разделе vars.

В таблице ниже перечислены возможные переменные, их описания, возможные значения и блоки файла инвентаря KUMA, в которых могут быть расположены эти переменные.

Список возможных переменных в разделе vars

Переменная

Описание

Возможные значения

Блок

Переменные, расположенные в разделе vars в блоках all и kuma

ansible_connection

Метод, используемый для подключения к устройствам с сервисами KUMA.

  • ssh – подключение к целевым устройствам по SSH установлено.
  • local – подключение к целевым устройствам не установлено.

Чтобы обеспечить правильную установку сервисов KUMA, в блоке all установите для переменной ansible_connection значение local.

В блоке kuma вам нужно указать переменную ansible_connection и установить для ansible_connection значение ssh, чтобы обеспечить подключение к устройствам, на которых установлены сервисы KUMA с помощью SSH.

  • all
  • kuma

ansible_user

Имя пользователя, используемое для подключения к устройствам с сервисами KUMA и для установки внешних сервисов KUMA.

Если пользователь root заблокирован на целевых устройствах, укажите имя пользователя, у которого есть право устанавливать SSH-соединения и повышать привилегии с помощью su или sudo.

Чтобы обеспечить правильную установку сервисов KUMA, в блоке all установите для переменной ansible_user значение nonroot.

В блоке kuma вам нужно изменить переменную ansible_user и указать для переменной ansible_user имя пользователя учетной записи, которая может подключаться к удаленным устройствам через SSH, чтобы подготовить их к установке сервисов KUMA.

  • all
  • kuma

deploy_example_services

Переменная указывает на создание предопределенных сервисов во время установки.

  • false – службы не требуются. Значение по умолчанию для шаблона файла инвентаря KUMA.

    Установите для переменной deploy_example_services значение false для стандартного развертывания сервисов KUMA.

  • true – сервисы должны быть созданы во время установки.

    Установите для переменной deploy_example_services значение true только для демонстрационного развертывания сервисов KUMA.

all

ansible_become

Переменная, указывает на необходимость повышения прав учетной записи пользователя, которая используется для установки компонентов KUMA.

  • false – если значение ansible_userroot.
  • true – если значение ansible_user – не root.

kuma

ansible_become_method

Метод, используемый для повышения привилегий учетной записи пользователя, которая используется для установки компонентов KUMA.

su или sudo, если значение ansible_user не root.

kuma

Переменные, расположенные в дочернем разделе блока kuma

kuma_utils

Группа устройств, на которых хранятся служебные файлы и утилиты KUMA.

Устройство может быть включено в группу kuma_utils и в группы kuma_collector, kuma_correlator или kuma_storage одновременно. Группа kuma_utils может содержать несколько устройств.

Во время развертывания Open Single Management Platform на устройствах, входящих в kuma_utils, в директорию /opt/kaspersky/kuma/utils/ копируются следующие файлы:

  • kuma – исполняемый файл, с которым устанавливаются сервисы KUMA.
  • kuma.exe – исполняемый файл, с помощью которого агенты KUMA устанавливаются на устройства с операционной системой Windows.
  • LEGAL_NOTICES – файл с информацией о стороннем коде.
  • maxpatrol-tool, kuma-ptvm.tar.gz – утилиты для интеграции с MaxPatrol.
  • ootb-content – архив с готовыми ресурсами для сервисов KUMA.

Группа устройств содержит переменную ansible_host, которая указывает уникальное полное доменное имя устройства и IP-адрес.

kuma

kuma_collector

Группа устройств коллекторов KUMA. Эта группа может содержать несколько устройств.

Группа устройств коллекторов KUMA содержит переменную ansible_host, которая указывает уникальный FQDN устройства и IP-адрес.

kuma

kuma_correlator

Группа устройств корреляторов KUMA. Эта группа может содержать несколько устройств.

Группа устройств корреляторов KUMA содержит переменную ansible_host, которая указывает уникальный FQDN устройства и IP-адрес.

kuma

kuma_storage

Группа устройств хранилищ KUMA. Эта группа может содержать несколько устройств.

Группа устройств хранилищ KUMA содержит переменную ansible_host, которая указывает уникальный FQDN устройства и IP-адрес.

В этой группе также можно указать структуру хранилища, если вы устанавливаете примеры сервисов во время демонстрационного развертывания (deploy_example_services: true). Для стандартного развертывания (deploy_example_services: false) укажите структуру хранилища в интерфейсе Консоли KUMA.

kuma

Пример шаблона файла инвентаря KUMA для установки сервисов KUMA на отдельном устройстве (файл single.inventory.yaml)

Пример шаблона файла инвентаря KUMA для установки сервисов KUMA на нескольких устройствах (файл distributed.inventory.yaml)