Горизонтальное масштабирование¶
Начиная с версии 5.2, в Staffcop Enterprise доступна возможность горизонтального масштабирования - создания кластера из нескольких отдельных серверов Staffcop.
Горизонтальное масштабирование позволяет:
объединять настройки политик для всех АРМ в кластере;
отображать информацию со всех АРМ кластера в одной веб-консоли;
получать отчёты по всем пользователям кластера;
всем администраторам системы иметь доступ ко всем узлам кластера.
Предварительная настройка¶
Перед развёртыванием кластера:
Проверьте версию серверов Staffcop, которые будут включены в кластер:
sudo staffcop infoВерсии серверов должны быть одинаковыми.
Обновите ПО на всех серверах, которые будут входить в кластер
sudo apt update sudo apt upgrade
Подготовка мастер-сервера¶
Установите необходимые пакеты:
Добавьте в список репозиториев системы репозитории Staffcop:
wget -O - http://distr.staffcop.su/beta5.2/staffcop.gpg | sudo apt-key add- echo "deb http://distr.staffcop.su/stable5.2 stable5.2 non-free" | sudo tee /etc/apt/source.list.d/staffcop.list
Установите пакет оркестрации:
sudo apt install staffcop-orchestration
Установите sshpass:
sudo apt install sshpass
Установите пакет оркестрации:
sudo dpkg -i staffcop-orchestration-0.2.5-master.deb
Запустите предварительную настройку кластера.
Важно! Запускайте команду без sudo.
staffcop-cluster deploy prepare
В результате выполнения команды будет создан конфигурационный файл кластера /etc/staffcop/cluster.cfg.
Если конфигурационный файл успешно создан, предварительная настройка закончена. Переходите к развёртыванию кластера.
Развёртывание кластера¶
Настройка конфигурации¶
Откройте конфигурационный файл /etc/staffcop/cluster.cfg.
Примерное содержание файла /etc/staffcop/cluster.cfg
[all:vars]
ansible_ssh_common_args='-o StrictHostKeyChecking=no'
# Connection to node
ansible_connection=ssh
ansible_user=support
ansible_ssh_pass=support
ansible_sudo_pass=support
ansible_python_interpreter=/usr/bin/python3
# Cluster configuration
clickhouse_database=staffcop
clickhouse_host=localhost
clickhouse_port=9000
clickhouse_user=staffcop
clickhouse_password=password2
sql_host=localhost
sql_port=5432
sql_database=staffcop
sql_user=staffcop
sql_password=password1
# Master server
api_key=apikey1
master_api_key=apikey1
master_server=10.10.14.71
[node]
node1 node=0 ansible_host=10.10.14.71 name="Мастер сервер"
node2 node=1 ansible_host=10.10.14.72 name="Слейв 1"
node3 node=2 ansible_host=10.10.14.73 name="Слейв 2"
В созданном файле необходимо изменить следующие строки:
Строка |
Содержимое |
master_server= |
Адрес мастер-сервера. |
node1 node=0 ansible_host=… name=»…» |
Адрес и имя мастер-сервера. |
node2 node=1 ansible_host=… name=»…» |
Адрес и имя первого слейв-сервера. |
node3 node=2 ansible_host=… name=»…» |
Адрес и имя второго слейв-сервера. |
clickhouse_password= |
Пароль от базы данных Clickhouse. |
sql_password= |
Пароль от базы данных PostgreSQL. |
Примечание
Пароли для баз данных указывайте только если мастер-сервер дополнительно настраивался и эти пароли были изменены.
После внесения всех изменений, проверьте правильность настроек и доступность узлов кластера. Для этого заново запустите:
staffcop-cluster deploy prepare
После успешной проверки, переходите непосредственно к сборке кластера.
Сборка кластера¶
Примечание
В ходе сборки будут настроены все основные элементы кластера. Недостающие элементы (сервер Staffcop, PostgreSQL, Clickhouse) будут установлены и настроены.
Сборка кластера осуществляется командой
staffcop-cluster deploy
Это комплексная команда, включающая в себя все необходимые процедуры и дополнительные настройки. Выполнение этой команды может занять длительное время.
Чтобы получить больший контроль над процессом сборки кластера, используйте последовательный набор команд, дублирующих основную.
Пошаговая сборка кластера:
Настройте базу данных PostgreSQL:
staffcop-cluster deploy postgresql
Настройте базу данных Clickhouse:
staffcop-cluster deploy clickhouse
Настройте серверы Staffcop, входящие в кластер:
staffcop-cluster deploy server
Настройте узлы кластера (ноды)
staffcop-cluster deploy node
Если в ходе установки не возникло ошибок, кластер настроен и готов к использованию.
Начало работы¶
Примечание
Перед началом работы активируйте на мастер-сервере лицензию с включенной опцией Горизонтальное масштабирование. В лицензии должно быть указано количество нод кластера (серверов, входящих в состав кластера с учётом мастер-сервера).
После создания кластера, слейв-сервера будут периодически синхронизироваться с мастер-сервером, получая обновления по настройкам, политикам и списку администраторов системы.
В веб-интерфейсе сервера, в разделе выбора используемой базы данных, помимо стандартных PostgreSQL и Clickhouse, станет доступен режим Cluster.
При выборе режима отображения Cluster, в Линзе событий будут показаны все события на всех серверах, входящих в состав кластера.
Отследить, на каком из серверов кластера произошло событие можно в Линзе событий, в строке Сервер.