Установка в отказоустойчивой конфигурации в кластере Kubernetes

Эта инструкция является частью сценария развертывания и первоначальной настройки.

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

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

Чтобы установить Kaspersky SIEM в кластере Kubernetes, перейдите на контрольную машину и выполните следующие действия:

Поместите архив с установщиком на контрольную машину

В личном кабинете на портале Kaspersky CompanyAccount скачайте архив с установщиком, а затем скопируйте архив kuma-ansible-installer-ha-<номер версии KUMA>.tar.gz на контрольную машину и распакуйте его с помощью следующей команды (потребуется около 2 ГБ дискового пространства):

tar -xpf kuma-ansible-installer-ha-<номер версии KUMA>.tar.gz

Войдите в директорию с установщиком и предоставьте пользователю ОС, от имени которого запускается установщик KUMA, доступ к файлам в директории

Для этого последовательно выполните следующие команды:

cd kuma-ansible-installer

chown -R <user_name>:<group> kuma-ansible-installer

где:

• <user_name> — пользователь ОС, от имени которого запускается установщик KUMA и которому следует выдать права на директорию с установщиком. Также у пользователя должны быть права на запись в директорию, в которую этот архив будет распаковываться.
• <group> — основная группа пользователя.

Активируйте решение

В зависимости от способа активации, выполните следующие действия:

• Файл ключа.

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

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

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

  Действия не требуются, переходите к следующему пункту инструкции.

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

1. Скопируйте шаблон k0s.inventory.yml.template и создайте файл инвентаря с именем k0s.inventory.yml:

   cp k0s.inventory.yml.template k0s.inventory.yml

   Шаблон содержит базовый набор параметров, но его недопустимо использовать при установке без изменений.

2. Заполните значения параметров в файле инвентаря k0s.inventory.yml в соответствии с выполняемым сценарием. Доступные значения параметров приведены в таблице параметров в файле инвентаря.
   1. В шаблоне файла инвентаря k0s.inventory.yml приведены примеры имен хостов для разных групп сервисов KUMA. Перед установкой замените эти примеры на действительные FQDN в формате <имя хоста>.<домен> и при необходимости укажите IPv4-адрес или IPv6-адрес серверов вашей инфраструктуры, на которые будут устанавливаться соответствующие сервисы.
   2. Если вы используете нестандартную директорию для хранения SSH-ключей, укажите полный путь к SSH-ключу в параметре ansible_ssh_private_key_file в файле инвентаря в секции kuma: vars:, чтобы обеспечить доступ установщика к целевым машинам.
   3. Если вы хотите использовать нестандартный порт для подключения по протоколу SSH в ходе установки, выберите один из следующих вариантов:
      • Если порт одинаковый для группы хостов, укажите порт в параметре ansible_port в файле инвентаря в секции vars.
      • Если для подключения к каждому хосту используется отдельный нестандартный порт, укажите порт в параметре ansible_port для каждого хоста в файле инвентаря.
   4. Если вы хотите, чтобы при установке были созданы предустановленные сервисы (коллектор, коррелятор, хранилище), присвойте параметру deploy_example_services значение true.

      Предустановленные сервисы будут созданы и автоматически запущены на указанных в файле инвентаря хостах. Созданные сервисы будут доступны в веб-интерфейсе Kaspersky SIEM. Дополнительно устанавливать или запускать их не требуется. При необходимости вы можете удалить предустановленные сервисы.

   5. В файле инвентаря для рабочего узла, через который будет осуществляться доступ к Ядру KUMA, в параметре extra_args укажите значение kaspersky.com/kuma-ingress=true. Для доступа к Ядру KUMA используйте URL в следующем формате: https://<FQDN рабочего узла>:<порт рабочего узла>. По умолчанию для подключения к веб-интерфейсу используется порт 7220. Доступны порты 7209, 7210, 7220, 7222 и 7223.

      Параметр extra_args можно указать для нескольких узлов. Одновременное подключение к веб-интерфейсу Kaspersky SIEM на нескольких рабочих узлах с помощью одинаковых учетных данных невозможно. Активным останется последнее установленное подключение.

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

   Ниже приведен пример заполнения файла инвентаря k0s.inventory.yml с 3 контроллерами, 2 рабочими узлами, 1 балансировщиком, с указанием полного пути к SSH-ключу, без развертывания предустановленных сервисов, с указанием отдельного нестандартного порта для подключения по протоколу SSH для коллектора и коррелятора и общего нестандартного порта для группы хостов хранилища.

   Пример файла инвентаря для установки в отказоустойчивой конфигурации в кластере Kubernetes

   all:

   vars:

   ansible_connection: ssh

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

   ansible_user: root

   deploy_to_k8s: true

   need_transfer: false

   generate_etc_hosts: false

   deploy_example_services: false

   no_firewall_actions: false

   metrics_disk_request: 150Gi

   core_disk_request: 100Gi

   kuma:

   children:

   kuma_collector:

   hosts:

   kuma-collector.example.com:

   ansible_port: 2221

   ip: 0.0.0.0

   kuma_correlator:

   hosts:

   kuma-correlator.example.com:

   ansible_port: 2222

   ip: 0.0.0.0

   kuma_storage:

   vars:

   ansible_port: 2223

   hosts:

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

   ip: 0.0.0.0

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

   ip: 0.0.0.0

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

   ip: 0.0.0.0

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

   ip: 0.0.0.0

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

   ip: 0.0.0.0

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

   ip: 0.0.0.0

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

   ip: 0.0.0.0

   kuma_k0s:

   children:

   kuma_lb:

   hosts:

   kuma-lb.example.com:

   ip: 0.0.0.0

   kuma_managed_lb: true

   kuma_control_plane_master:

   hosts:

   kuma_cpm.example.com:

   ansible_host: 10.0.1.10

   kuma_control_plane_master_worker:

   kuma_control_plane:

   hosts:

   kuma_cp2.example.com:

   ansible_host: 10.0.1.11

   kuma_cp3.example.com:

   ansible_host: 10.0.1.12

   kuma_control_plane_worker:

   kuma_worker:

   hosts:

   kuma-w1.example.com:

   ansible_host: 10.0.2.11

   extra_args: "--labels=kaspersky.com/kuma-core=true,kaspersky.com/kuma-ingress=true,node.longhorn.io/create-default-disk=true"

   kuma-w2.example.com:

   ansible_host: 10.0.2.12

   extra_args: "--labels=kaspersky.com/kuma-core=true,kaspersky.com/kuma-ingress=true,node.longhorn.io/create-default-disk=true"

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

Запустите установщик

Запустите установщик install.sh с подготовленным файлом инвентаря k0s.inventory.yml:

Для пользователя с root-правами

./install.sh k0s.inventory.yml

Для пользователя без root-прав требуется ввести пароль для повышения привилегий

./install.sh k0s.inventory.yml --ask-become-pass

При установке Kaspersky SIEM автоматически проверяется соответствие хостов аппаратным требованиям.

Если условия не выполняются, установка прерывается. Проверку соответствия аппаратным требованиям при установке для демонстрации можно выключить, указав в файле инвентаря переменную:

low_resources: true

Ознакомьтесь с условиями Лицензионного соглашения

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

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

yes

Завершение установки

Для завершения установки выполните действия в зависимости от способа активации решения:

Файл ключа

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

На этом установка считается завершенной. Вы можете вернуться к сценарию развертывания и продолжить работу с этапа Действия после установки.