ELMA365 On-Premises > Подготовка инфраструктуры ELMA365 On-Premises > Базы данных > Подготовка внешних баз данных / Valkey

Valkey

Valkey — высокопроизводительная NoSQL СУБД, разработанная на основе Redis для современных облачных и распределённых систем.

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

Для корректной работы системы требуется Valkey версии 7.2.8 и выше.

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

В статье приведена установка Valkey 8.1.1 для ОС Ubuntu Linux 22.04 и 24.04. Вы можете найти установочные файлы Valkey для вашей операционной системы на следующих ресурсах:

Подробнее о работе с СУБД читайте в официальной документации Valkey.

О том, как заменить Redis на Valkey, смотрите в статье «Переход с Redis на Valkey».

Подготовка СУБД к работе включает этапы:

  1. Установка Valkey.
  2. Настройка Valkey.
  3. Подключение к Valkey.

Шаг 1. Установка Valkey

  1. Установите пакеты:

sudo apt install -y apt-transport-https ca-certificates curl

  1. Импортируйте ключи:

sudo curl -fsSL https://repo.elma365.tech/deb/elma365-keyring.gpg | gpg --dearmor > /etc/apt/trusted.gpg.d/elma365-keyring.gpg

  1. Добавьте репозиторий ELMA365:

echo "deb [arch=amd64] https://repo.elma365.tech/deb $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/elma365.list
sudo apt update

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

sudo apt install elma365-valkey-server

Шаг 2. Настройка Valkey

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

Примечание

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

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

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

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

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

Задайте настройки для установленной СУБД:

  1. Разрешите подключение к серверу Valkey. Для этого отредактируйте конфигурационный файл /etc/Valkey/Valkey.conf и добавьте IP-адрес машины, например 192.168.10.10:

sudo nano /etc/valkey/valkey.conf
bind 127.0.0.1 ::1 192.168.10.10

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

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

maxclients 20000

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

maxmemory-policy allkeys-lfu

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

save ""

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

appendonly no

  1. Отключите защищённый режим, если используется параметр bind 0.0.0.0 или отсутствует настройка requirepass:

protected-mode no

  1. Перезапустите Valkey:

sudo systemctl restart valkey-server

Шаг 3. Подключение к Valkey

Строка для подключения к Valkey:

redis://<valkey-server-address>:6379/0

Строка для подключения к Valkey c TLS/SSL:

rediss://<valkey-server-address>:6379/0