Перейти к содержанию

Управление кластером Платформы

Управление кластером Платформы

Раздел «Кластер» предоставляет инструментарий для упрощенного управления Платформой без необходимости подключения к серверам через терминальные соединения.

Раздел предоставляет следующие возможности (см. Рисунок 1):

  • управление узлами кластера и контроль состояния узлов;

  • управление скриптами установки и конфигурационные файлами сервисов;

  • управление учетными записями для сбора данных, протоколами и API ключами.

Рисунок 1 - Главный экран раздела «Кластер»

Концепция кластера Платформы Радар

Кластер Платформы Радар состоит из трех составляющих:

  • Агент управления узлом кластера;

  • Менеджер управления агентами;

  • Интерфейс управления менеджером.

На каждый узел кластера необходимо установить Агент управления, через который будет осуществляться управление и контроль состояния узла.

Интерфейс и Менеджер управления агентами должны находиться на одном сервере, по умолчанию они находятся на сервере с ролью MASTER (подробнее в документе "Руководство по установке").

Добавление узла кластера

Для добавления нового узла должно быть соблюдено несколько подготовительных условий:

  • Узел развернут и готов принимать внешние соединения.

  • На узле установлена ОС - Debian 9 x64.

  • На узле поднят ssh сервер.

  • Узел разрешает соединения под привилегированным пользователем root с паролем.

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

Для добавления узла и начала установки Агента на узел необходимо выполнить следующие действия :

  1. На вкладке "Узлы системы" выбрать подраздел "Узлы" (см. Рисунок 2).
  2. Заполнить форму "Добавление нового узла". Все поля формы обязательны к заполнению.
  3. Для создания кластера нажать на кнопку "Добавить".
  4. Присвоить новому кластеру одну или несколько ролей, указав их в области "Добавление ролей к узлам". Для добавления роли необходимо выбрать нужную роль из списка и нажать либо на кнопку «+», либо на кнопку «Добавить все» (см. Рисунок 2).

Рисунок 2 - Экран добавления узла Платформы

По умолчанию все необходимое программное обеспечение для узла регулируется ролью закрепленной за узлом (подробнее см. документ "Руководство по установке").

После добавления узла, назначение ему роли и установки Агента станет доступно управление узлом кластера, расположенное на специальном экране "Управление хостом <адрес хоста>" - см. раздел "Управление узлом кластера". Данный экран содержит функции редактирования роли кластера.

Управление узлом кластера

Экран управления узлом, общее описание

Управление узлом кластера осуществляется на отдельном экране интерфейса, перейти на который возможно следующим способом:

  • из подраздела "Узлы", область "Добавление ролей к узлам" при нажатии на название узла (IP-адреса, см. Рисунок 2) ;
  • из подраздела «Проверка» - нажать на кнопку «Настройка» рядом с названием узла (см. Рисунок 3).

Рисунок 3 - Переход на экран управления узлом кластера из подраздела "Проверка"

Экран управления узлом предоставляет следующие возможности (см. Рисунок 4):

  • управление серверными ролям узла;

  • управление сервисами узла;

  • контроль состояния работы сервисов;

  • контроль работы узла;

  • выполнение скриптов на узле.

Рисунок 4 - Экран управления узлом

Управление сервисами узла кластера

Функции управления сервисами расположены в области "Все сервисы узла" (см. Рисунок 4). Каждый сервис узла кластера может предоставить информацию о своем статусе и последних логах. Для получения информации необходимо нажать на кнопку «Действия» и выбрать соответствующий пункт меню (см. Рисунок 5). Так же через данное меню доступны:

  • переустановка сервиса;
  • обновление конфигурационных файлов сервиса;
  • перезапуск сервиса.

Рисунок 5 - Информация о статусе и последних логах выбранного узла кластера

Установка сервиса на узел кластера

Для установки на узел отдельно выбранного сервиса (не рекомендуется так делать) на экране управления узлом кластера необходимо выполнить следующие действий:

  1. В области "Дополнительные сервисы узла" выбрать в раскрывающемся списке дополнительных сервисов необходимый сервис (см. Рисунок 6).

  2. Нажать на кнопку «Добавить». Сервис добавится в общий список сервисов на узле в области "Все сервисы узла" .

  3. В строке нового сервиса нажать на кнопку «Действия» и в раскрывшемся меню выбрать функцию «Переустановить сервис» (см. Рисунок 5). Дождаться завершения процесса.

  4. В строке нового сервиса нажать на кнопку «Действия» и в раскрывшемся меню выбрать функцию «Обновить конфиг» (см. Рисунок 5). Дождаться завершения процесса.

В процессе переустановки сервиса будет показан лог действий установщика.

Рисунок 6 - Выбор дополнительного сервиса

Установка серверной роли на узел кластера

Рекомендуется использовать серверные роли как абстракцию установки программного обеспечения на узел кластера.

На экране управления узлом кластера для присвоение новой роли узлу необходимо выполнить следующие действия (см. Рисунок 6):

  1. В области "Роли узла" в раскрывающемся списке выбрать нужную роль.

  2. Нажать на кнопку «Добавить». Выбранная роль будет добавлена к списку ниже.

  3. В строке добавленной роли нажать на кнопку «Раскатить роль» для запуска процесса установки на узел кластера ПО, соответствующего роли.

Процесс установки представлен в виде обновляемого лога установки.

Рисунок 7 - Установка серверной роли на узел кластера

Управление сервисами

Набор сервисов, добавление/удаление сервисов

В интерфейсе Платформы Радар набор доступных сервисов платформы отображается в разделе "Управление кластером" на вкладке "Сервисы" в виде таблицы. Область справа от таблицы позволяет добавлять новые сервисы (см. Рисунок 8). Можно удалить существующий сервис из таблицы нажав на кнопку "Удалить" в строке соответствующего сервиса.

Рисунок 8 - Набор сервисов Платформы

Экран управления сервисами

При выборе в таблице интересующего сервиса открывается экран управления данным сервисом, который содержит следующие области задач (см. Рисунок 9):

  • область "Ассоциирован с ролями" - обеспечивает настройку списка ролей, с которыми ассоциирован данный сервис;

  • область "Ассоциированные конфиги" - обеспечивает настройку списка конфигурационных файлов, ассоциированных с данным сервисом;

  • область "Доступные скрипты" - содержит перечень скриптов, доступных для данного сервиса;

  • область "Ассоциирован с узлами" - содержит список названий (ролей) кластерного узла с которыми ассоциирован данный сервис.

Рисунок 9 - Экран управления сервисами

Настройка списка ролей, с которыми ассоциирован сервис

Для проведения ассоциации сервиса с новой ролью необходимо:

  1. Перейти на вкладку «Сервисы».
  2. Выбрать нужный сервис в таблице. Откроется форма настроек сервиса (см. Рисунок 10).
  3. В области "Ассоциирован с ролями" и выбрать нужную роль в раскрывающемся списке.
  4. Нажать кнопку «Добавить».

Указанная роль отобразится в списке ролей, с которыми ассоциирован выбранный сервис.

Для удалении роли из списка нажать на кнопку "Удалить" в строке данной роли.

Рисунок 10 - Область настройки ролей, с которыми ассоциирован сервис

Настройка списка конфигурационных файлов, ассоциированных с сервисом

Для ассоциации конфигурационного файла с сервисом, необходимо:

  1. Перейти на вкладку «Сервисы».
  2. Выбрать нужный сервис в таблице. Откроется форма настроек сервиса (см. Рисунок 11).
  3. Выбрать настройку «Ассоциированные конфиги» и выбрать нужный конфигурационный файл в раскрывающемся списке.
  4. Нажать кнопку «Добавить».

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

Для удаления конфигурационного файла из списка нажать на кнопку "Удалить" в строке данного файла.

Рисунок 11 - Область настройки конфигурационных файлов ассоциированных с сервисом

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

Набор конфигурационных файлов, добавление/удаление файлов

Внимание! Не рекомендуется вносить изменения в конфигурационные файлы без консультации с разработчиками.

Все конфигурационные файлы сервисов Платформы лежат по адресу: /opt/pangeoradar/configs/.

В интерфейсе Платформы Радар данный набор конфигурационных файлов отображается в разделе "Управление кластером" на вкладке "Конфигурационные файлы" в виде таблицы. Область справа от таблицы позволяет переопределить конфигурационные файлы по умолчанию из этой или вложенных директорий путем создания одноименных файлов (см. Рисунок 12).

В названии файла допускается использовать относительный путь от директории хранения конфигурационных файлов, например - termite/test.conf.

Для удаления конфигурационного файла из списка нажать на кнопку "Удалить" в строке интересующего файла.

Рисунок 12 - Набор конфигурационных файлов Платформы

Экран редактирования конфигурационного файла

Внимание! Не рекомендуется вносить изменения в конфигурационные файлы без консультации с разработчиками.

При необходимости текст конфигурационного файла можно отредактировать. Для это надо надо выбрать интересующий файл в списке конфигурационных файлов. На экране откроется текст выбранного файла, доступный для редактирования (см. Рисунок 13). Введенные изменения сохраняются при нажатии на кнопку "Изменить".

Рисунок 13 - Редактирование конфигурационного файла Платформы

Ассоциация конфигурационного файла с сервисом

См. раздел "Настройка списка конфигурационных файлов, ассоциированных с сервисом".

Управление инсталляционными скриптами кластера

Набор скриптов, добавление/удаление скриптов

Внимание! Не рекомендуется вносить в скрипты изменения без консультации с разработчиками.

Инсталляционные скрипты необходимы при установке или переустановке сервисов.

Языком описания скрипта является bash.

В интерфейсе Платформы Радар набор скриптов отображается в разделе "Управление кластером" на вкладке "Скрипты" в виде таблицы. Область справа от таблицы позволяет переопределить скрипты по умолчанию (см. Рисунок 14).

Рисунок 14 - Набор скриптов Платформы

Экран редактирования скрипта

При выборе в таблице интересующего скрипта открывается экран управления данным скриптом, который содержит следующие области задач (см. Рисунок 15):

  • слева расположен текст выбранного скрипта, доступный для редактирования.;
  • область "Ассоциация скрипта с ролью" - обеспечивает ассоциацию скрипта с ролью, выбранной из раскрывающегося списка;
  • область "Ассоциация скрипта с сервисом"- содержит список сервисов, с которыми ассоциирован данный скрипт на текущий момент, и раскрывающийся список сервисов, с которыми можно провести ассоциацию данного скрипта.

Рисунок 15 - Редактирование скрипта Платформы

Управление API ключами кластера

Доверенные ключи API используются для меж-сервисного взаимодействия. Управление ключами API реализовано на вкладке "API ключи". Экран содержит (см. Рисунок 16):

  • текущий список API ключей;
  • область добавления новых ключей.

Не рекомендуется удалять ключ global_api_key во избежание потери работоспособности Платформы.

Рисунок 16 - Управление API ключами

Управление учетными записями для сбора данных

На вкладке "Учетные записи для сбора данных" реализовано управление авторизационными данными для сборщика данных с хостов при процедуре инвентаризации (подробнее см. документ "Руководство пользователя"). Вкладка содержит (см. Рисунок 17):

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

Изменение созданной записи не предусмотренно. Возможно только удаление и повторное создание.

Рисунок 17 - Управление списком учетных записей для сбора данных

Управление транспортами сбора данных

Внимание! Не рекомендуется вносить изменения в набор транспортов без консультации с разработчиками.

На вкладке "Транспорт" реализовано управление словарем для формы добавления учетных записей для сбора данных (см. Рисунок 17). Вкладка содержит (см. Рисунок 18):

  • область "Список транспортов платформы" - текущий список транспортов с возможностью удаления транспорта из списка;
  • область "Добавление транспорта" - содержит форму для добавления нового транспорта .

Рисунок 18 - Управление транспортами сбора данных