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

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

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

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

   cd kuma-ansible-installer-ha

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

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

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

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

   sudo ./install.sh k0s.inventory.yml

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

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

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

     Пример файла инвентаря k0s.inventory.yml с одним нестандартным портом для всех хостов в секции kuma_control_plane

     all:

     vars:

     ansible_connection: 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:

     kuma_correlator:

     hosts:

     kuma-correlator.example.com:

     kuma_storage:

     hosts:

     kuma-storage-cluster1.server1.example.com

     kuma-storage-cluster1.server2.example.com

     kuma-storage-cluster1.server3.example.com

     kuma-storage-cluster1.server4.example.com

     kuma-storage-cluster1.server5.example.com

     kuma-storage-cluster1.server6.example.com

     kuma-storage-cluster1.server7.example.com

     kuma_k0s:

     children:

     kuma_lb:

     hosts:

     kuma-lb.example.com:

     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:

     vars:

     ansible_port: 2222

     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"

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

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

     all:

     vars:

     ansible_connection: 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:

     kuma_correlator:

     hosts:

     kuma-correlator.example.com:

     kuma_storage:

     hosts:

     kuma-storage-cluster1.server1.example.com

     kuma-storage-cluster1.server2.example.com

     kuma-storage-cluster1.server3.example.com

     kuma-storage-cluster1.server4.example.com

     kuma-storage-cluster1.server5.example.com

     kuma-storage-cluster1.server6.example.com

     kuma-storage-cluster1.server7.example.com

     kuma_k0s:

     children:

     kuma_lb:

     hosts:

     kuma-lb.example.com:

     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_port: 2222

     ansible_host: 10.0.1.11

     kuma_cp3.example.com:

     ansible_port: 2223

     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"

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

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

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

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

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

     sudo ./postinstall.sh k0s.inventory.yml

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

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

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

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

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

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

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

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