search string side menu

ELMA365 On-Premises > Подготовка инфраструктуры ELMA365 On-Premises > Базы данных > Отказоустойчивая инфраструктура / Кластер Redis

Кластер Redis

Для корректной работы системы требуется Redis версии 5 или 6.2. В статье описана установка Redis 6.2.12 для ОС Ubuntu Linux 20.04 и 22.04. Вы также можете ознакомиться с руководством в официальной документации Redis.

начало внимание

В связи с изменением лицензионной политики Redis рекомендуем устанавливать Valkey в качестве альтернативного решения. Подробнее об установке читайте в статье «Кластер Valkey».

конец внимание

Развёртывание кластера Redis включает этапы:

  1. Подготовка нод (серверов).
  2. Установка Redis и Sentinel.
  3. Настройка Redis.
  4. Настройка Sentinel.
  5. Подключение к Redis.

Шаг 1. Подготовка нод (серверов)

начало внимание

Минимальное количество серверов для организации кластера — три.

конец внимание

  1. Создайте три ноды (сервера) с последовательно пронумерованными именами хостов:
  • redis-server1.your_domain;
  • redis-server2.your_domain;
  • redis-server3.your_domain.
  1. Создайте необходимые сопоставления имён хостов в DNS. Если такой возможности нет, внесите нужные записи в /etc/hosts.

Шаг 2. Установка Redis и Sentinel

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

sudo apt install lsb-release curl gpg

  1. Импортируйте необходимые ключи и добавьте репозиторий Redis:

curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list

  1. Обновите кеш пакетов:

sudo apt-get update

  1. Установите Redis:

sudo apt-get -y install redis=6:6.2.12-1rl1~$(lsb_release -cs)1 redis-server=6:6.2.12-1rl1~$(lsb_release -cs)1 redis-tools=6:6.2.12-1rl1~$(lsb_release -cs)1 redis-sentinel=6:6.2.12-1rl1~$(lsb_release -cs)1

Шаг 3. Настройка Redis

Начало примечание

Примечание

Для пароля разрешается применять следующие символы:

  • заглавные латинские буквы: от A до Z;
  • строчные латинские буквы: от a до z;
  • цифры от 0 до 9;
  • символы:  -_.

Зарезервированные (недопустимые) символы:

! * ' ( ) ; : @ & = + $ , / ? % # [ ]

конец примечание

Для настройки отредактируйте файл /etc/redis/redis.conf на каждом из серверов:

sudo nano /etc/redis/redis.conf

  1. Сделайте сервера доступными для всех IP-адресов данного сервера. Это делает сервис Redis доступным со всех внешних адресов:

bind 0.0.0.0 

  1. Увеличьте максимальное количество клиентов, изменив значение параметра maxclients на 20000. Раскомментируйте строку, убрав знак решетки #:

maxclients 20000

  1. Задайте политику вытеснения ключей, изменив значение параметра maxmemory-policy на allkeys-lfu. Раскомментируйте строку, убрав знак решетки #:

maxmemory-policy allkeys-lfu

  1. Отключите создание snapshots, изменив значение параметра save на "". Раскомментируйте строку, убрав знак решетки #:

save ""

  1. Отключите AOF (сохранение базы данных Redis в файл). Для этого замените значение параметра appendonly на no. Раскомментируйте строку, убрав знак решетки #:

appendonly no

  1. Укажите пароль к мастеру:

masterauth SecretPassword

  1. Укажите домен (FQDN) для представления ноды в кластере:
  • на ноде redis-server1.your_domain:

replica-announce-ip redis-server1.your_domain

  • на ноде redis-server2.your_domain:

replica-announce-ip redis-server2.your_domain

  • на ноде redis-server3.your_domain:

replica-announce-ip redis-server3.your_domain

  1. Укажите пароль для доступа:

requirepass SecretPassword

  1. На нодах redis-server2.your_domain и redis-server3.your_domain укажите домен (FQDN) и порт для подключения к ноде Мастера (redis-server1.your_domain):

replicaof redis-server1.your_domain 6379

  1. Перезапустите все сервера (сначала мастер, затем слейвы):

sudo systemctl restart redis-server
sudo systemctl enable redis-server

  1. Проверьте статус репликации на ноде redis-server1.your_domain:

sudo redis-cli -a SecretPassword info replication

Если не возникло ошибки, настройки проведена успешно.

Настройка включения TLS/SSL в Redis

 
Для включения поддержки TLS/SSL в Redis необходимо в файле конфигурации redis.conf:

  1. Отключить незащищённые подключения, выставив 0 в параметре port.
  2. Задать порт для TLS подключений, расскоментировав параметр tls-port.
  3. В параметре tls-cert-file указать путь до файла сертификата сервера.
  4. В параметре tls-key-file указать путь до файла закрытого ключа.
  5. В параметре tls-ca-cert-file указать путь до файла корневого CA.

port 0
tls-port 6379
tls-cert-file /path/to/redis.crt
tls-key-file /path/to/redis.key
tls-ca-cert-file /path/to/ca.crt

  1. Перезапустить все сервера (сначала мастер, затем слейвы):

sudo systemctl restart redis-server
sudo systemctl enable redis-server

  1. Проверить статус репликации на ноде redis-server1.your_domain:

sudo redis-cli -p 6379 -h redis-server1.your_domain --tls --cacert /path/to/ca.crt --cert /path/to/redis.crt --key /path/to/redis.key -a SecretPassword info replication

 
Подробнее о настройке TLS/SSL в Redis читайте в официальной документации Redis.

Шаг 4. Настройка Sentinel

Чтобы настроить Sentinel, отредактируйте файл /etc/redis/sentinel.conf на каждом из серверов.

Начало внимание 

Для корректной работы соблюдайте указанный порядок записей в файле /etc/redis/sentinel.conf.

Конец внимание

  1. Сделайте сервера доступными для всех IP-адресов данного сервера. Это делает сервис Sentinel доступным со всех внешних адресов:

bind 0.0.0.0 

  1. Укажите домен (FQDN) для представления нод Sentinel:
  • на ноде redis-server1.your_domain:

sentinel announce-ip redis-server1.your_domain

  • на ноде redis-server2.your_domain:

sentinel announce-ip redis-server2.your_domain

  • на ноде redis-server3.your_domain:

sentinel announce-ip redis-server3.your_domain

  1. Укажите домен (FQDN) и порт мастера, а также значение для достижения кворума:

sentinel monitor mymaster redis-server1.your_domain 6379 2

  1. Укажите пароль для доступа к мастеру:

sentinel auth-pass mymaster SecretPassword

  1. Укажите время, после которого мастер будет считаться упавшим:

sentinel down-after-milliseconds mymaster 3000

  1. Укажите время ожидания после смены ролей слейва на мастер в случае, если мастер вышел из строя:

sentinel failover-timeout mymaster 6000

  1. Включите поддержку разрешения имён хостов:

sentinel resolve-hostnames yes
sentinel announce-hostnames yes

  1. Для повышения безопасности настройте для пользователя default доступ к Sentinel только по паролю:

user default on >SecretPassword sanitize-payload ~* &* +@all

  1. После этого перезапустите все сервера:

sudo systemctl restart redis-sentinel
sudo systemctl enable redis-sentinel

  1. Проверьте статус Sentinel и состояние кворума на ноде redis-server1.your_domain, используя разные команды в зависимости от использования TLS/SSL и настройки Sentinel:
  • без TLS/SSL, если доступ к Sentinel по паролю не включён:

sudo redis-cli -p 26379 info sentinel
sudo redis-cli -p 26379 sentinel ckquorum mymaster

  • без TLS/SSL, если настроен доступ к Sentinel только по паролю:

sudo redis-cli -p 26379 -a SecretPassword info sentinel
sudo redis-cli -p 26379 -a SecretPassword sentinel ckquorum mymaster

  • с TLS/SSL, если доступ к Sentinel по паролю не включён:

sudo redis-cli -p 26379 -h redis-server1.your_domain --tls --cacert /path/to/ca.crt --cert /path/to/redis.crt --key /path/to/redis.key info sentinel
sudo redis-cli -p 26379 -h redis-server1.your_domain --tls --cacert /path/to/ca.crt --cert /path/to/redis.crt --key /path/to/redis.key sentinel ckquorum mymaster

  • с TLS/SSL, если настроен доступ к Sentinel только по паролю:

sudo redis-cli -p 26379 -a SecretPassword -h redis-server1.your_domain --tls --cacert /path/to/ca.crt --cert /path/to/redis.crt --key /path/to/redis.key info sentinel
sudo redis-cli -p 26379 -a SecretPassword -h redis-server1.your_domain --tls --cacert /path/to/ca.crt --cert /path/to/redis.crt --key /path/to/redis.key sentinel ckquorum mymaster

Настройка включения TLS/SSL в Sentinel

 
Для включения поддержки TLS/SSL в Sentinel необходимо в файле конфигурации sentinel.conf:

  1. Отключить незащищённые подключения, выставив 0 в параметре port.
  2. Задать порт для TLS подключений, добавив параметр tls-port.
  3. Добавить параметр tls-cert-file и указать в нём путь до файла сертификата сервера.
  4. Добавить параметр tls-key-file и указать в нём путь до файла закрытого ключа.
  5. Добавить параметр tls-ca-cert-file и указать в нём путь до файла корневого CA.
  6. Добавить параметр tls-replication и включить поддержку TLS, указав значение yes.

port 0
tls-port 26379
tls-cert-file /path/to/redis.crt
tls-key-file /path/to/redis.key
tls-ca-cert-file /path/to/ca.crt
tls-replication yes

  1. После этого перезапустить все сервера:

sudo systemctl restart redis-sentinel
sudo systemctl enable redis-sentinel

  1. Проверить статус Sentinel и состояние кворума на ноде redis-server1.your_domain:

sudo redis-cli -p 26379 -h redis-server1.your_domain --tls --cacert /path/to/ca.crt --cert /path/to/redis.crt --key /path/to/redis.key info sentinel
sudo redis-cli -p 26379 -h redis-server1.your_domain --tls --cacert /path/to/ca.crt --cert /path/to/redis.crt --key /path/to/redis.key sentinel ckquorum mymaster

 
Подробнее о настройке TLS/SSL в Sentinel читайте в официальной документации Redis.

Шаг 5. Подключение к Redis

Подключитесь к Redis. Строка подключения зависит от использования TLS/SSL и настройки Sentinel:

  • без TLS/SSL, если доступ к Sentinel только по паролю не включён:

redis://:SecretPassword@redis-server1.your_domain:26379,redis-server2.your_domain:26379,redis-server3.your_domain:26379/0?masterName=mymaster

  • без TLS/SSL, если настроен доступ к Sentinel только по паролю:

redis://:SecretPassword@redis-server1.your_domain:26379,redis-server2.your_domain:26379,redis-server3.your_domain:26379/0?masterName=mymaster&sentinelUsername=default&sentinelPassword=SecretPassword

  • с TLS/SSL, если доступ к Sentinel по паролю не включён:

rediss://:SecretPassword@redis-server1.your_domain:26379,redis-server2.your_domain:26379,redis-server3.your_domain:26379/0?masterName=mymaster

  • с TLS/SSL, если настроен доступ к Sentinel только по паролю:

rediss://:SecretPassword@redis-server1.your_domain:26379,redis-server2.your_domain:26379,redis-server3.your_domain:26379/0?masterName=mymaster&sentinelUsername=default&sentinelPassword=SecretPassword

cluster-redis-to-valkey.html configure-rabbitmq.html