Горизонтальное масштабирование

Начиная с версии 5.2, в Staffcop Enterprise доступна возможность горизонтального масштабирования - создания кластера из нескольких отдельных серверов Staffcop.

Горизонтальное масштабирование позволяет:

  • объединять настройки политик для всех АРМ в кластере;

  • отображать информацию со всех АРМ кластера в одной веб-консоли;

  • получать отчёты по всем пользователям кластера;

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

Предварительная настройка

Перед развёртыванием кластера:

  1. Проверьте версию серверов Staffcop, которые будут включены в кластер:

sudo staffcop info

Версии серверов должны быть одинаковыми.

  1. Обновите ПО на всех серверах, которые будут входить в кластер

sudo apt update
sudo apt upgrade

Подготовка мастер-сервера

  1. Установите необходимые пакеты:

  1. Добавьте в список репозиториев системы репозитории 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
  1. Установите пакет оркестрации:

sudo apt install staffcop-orchestration
  1. Установите sshpass:

sudo apt install sshpass
  1. Запустите предварительную настройку кластера.

Важно! Запускайте команду без sudo.

staffcop-cluster deploy prepare
  1. В результате выполнения команды будет создан конфигурационный файл кластера /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

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

Чтобы получить больший контроль над процессом сборки кластера, используйте последовательный набор команд, дублирующих основную.

Пошаговая сборка кластера:

  1. Настройте базу данных PostgreSQL:

staffcop-cluster deploy postgresql
  1. Настройте базу данных Clickhouse:

staffcop-cluster deploy clickhouse
  1. Настройте серверы Staffcop, входящие в кластер:

staffcop-cluster deploy server
  1. Настройте узлы кластера (ноды)

staffcop-cluster deploy node
  1. Если в ходе установки не возникло ошибок, кластер настроен и готов к использованию.

Начало работы

Примечание

Перед началом работы активируйте на мастер-сервере лицензию с включенной опцией Горизонтальное масштабирование. В лицензии должно быть указано количество нод кластера (серверов, входящих в состав кластера с учётом мастер-сервера).

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

В веб-интерфейсе сервера, в разделе выбора используемой базы данных, помимо стандартных PostgreSQL и Clickhouse, станет доступен режим Cluster.

../_images/cluster_1.1.png

При выборе режима отображения Cluster, в Линзе событий будут показаны все события на всех серверах, входящих в состав кластера.

Отследить, на каком из серверов кластера произошло событие можно в Линзе событий, в строке Сервер.

../_images/cluster_1.2.png