Связаться с экспертомПопробовать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ООО «Яндекс.Облако»

Подключение к кластеру Valkey™ из приложений

Статья создана
Обновлена 22 июля 2026 г.
Открыть в Markdown

К кластеру Valkey™ можно подключиться с помощью инструментов командной строки, из графических IDE и Docker-контейнера. О подключении из кода вашего приложения смотрите Примеры кода.

Инструменты командной строки

Примеры кода с заполненным FQDN хоста доступны в консоли управления по нажатию кнопки Подключиться на странице кластера.

Способ настройки зависит от того, включено ли в кластере шардирование.

valkey-cli (redis-cli)

Для кластеров Valkey™ поддерживается шифрованное соединение через порт 6380 и нешифрованное через порт 6379.

Важно

Используя SSL-соединение, можно подключаться только к кластерам с включенной настройкой Поддержка TLS.

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

  1. Перед подключением установите зависимости:

    sudo apt update && sudo apt install -y redis-tools

  2. Подключитесь напрямую к мастеру:

    • нешардированного кластера:

      redis-cli \
    -h c-<идентификатор_кластера>.rw.mdb.yandexcloud.net \
    -a <пароль>

    • шардированного кластера:

       redis-cli \
     -c \
     -h <FQDN_хоста-мастера_в_нужном_шарде> \
     -a <пароль>

  1. Перед подключением установите зависимости:

    1. Перейдите в директорию, куда хотите скачать дистрибутив Valkey™.

    2. Скачайте нужную версию Valkey™ и выполните сборку и установку с поддержкой TLS:

      wget https://github.com/valkey-io/valkey/archive/refs/tags/<версия>.tar.gz && \
tar -xzvf <версия>.tar.gz && \
cd valkey-<версия> && \
make BUILD_TLS=yes && \
sudo make install && \
sudo cp ./src/valkey-cli /usr/bin/

  2. Подключитесь напрямую к мастеру:

    • нешардированного кластера:

      valkey-cli \
    -h c-<идентификатор_кластера>.rw.mdb.yandexcloud.net \
    -a <пароль> \
    -p 6380 \
    --tls \
    --cacert ~/.redis/YandexInternalRootCA.crt

    • шардированного кластера:

      valkey-cli \
    -c \
    -h <FQDN_хоста-мастера_в_нужном_шарде> \
    -a <пароль> \
    -p 6380 \
    --tls \
    --cacert ~/.redis/YandexInternalRootCA.crt \

  1. Перед подключением установите зависимости:

    1. Подключите репозиторий, в котором находится утилита redis-tools с поддержкой TLS:

      sudo apt-add-repository ppa:redislabs/redis

      Пакеты в этом репозитории уже собраны с флагом BUILD_TLS=yes.

    2. Установите утилиту:

      sudo apt update && sudo apt install -y redis-tools

  2. Подключитесь напрямую к мастеру:

    • нешардированного кластера:

      redis-cli \
    -h c-<идентификатор_кластера>.rw.mdb.yandexcloud.net \
    -a <пароль> \
    -p 6380 \
    --tls \
    --cacert ~/.redis/YandexInternalRootCA.crt

    • шардированного кластера:

      redis-cli \
    -c \
    -h <FQDN_хоста-мастера_в_нужном_шарде> \
    -a <пароль> \
    -p 6380 \
    --tls \
    --cacert ~/.redis/YandexInternalRootCA.crt \

О том, как получить FQDN хоста, читайте в инструкции.

После подключения к кластеру выполните команды:

SET foo bar
GET foo

При успешном подключении к кластеру и выполнении тестового запроса будет выведена строка bar.

Valkey™ Sentinel

Valkey™ Sentinel — это система управления хостами Valkey™, позволяющая проводить мониторинг, отправлять уведомления о состояниях хостов, переключать мастер и передавать клиентам актуальные адреса хостов.

Для нешардированных кластеров поддерживается нешифрованное соединение через порт 26379 с любой версией Valkey™.

Если клиентское приложение не поддерживает подключение через Sentinel, подключитесь напрямую к мастеру. Если в прямом подключении нет необходимости, используйте Sentinel для более надежной работы с хостами кластера:

  1. Перед подключением установите зависимости:

    sudo apt update && sudo apt install -y redis-tools

  2. Получите адрес хоста-мастера, используя Sentinel и любой хост Valkey™:

    redis-cli \
    -h <FQDN_любого_хоста_Valkey™> \
    -p 26379 \
    sentinel \
    get-master-addr-by-name <имя_кластера_Valkey™> | head -n 1

  3. Подключитесь к хосту с этим адресом:

    redis-cli \
    -h <адрес_хоста-мастера_Valkey™> \
    -a <пароль_Valkey™>

О том, как получить FQDN хоста, читайте в инструкции.

После подключения к кластеру выполните команды:

SET foo bar
GET foo

При успешном подключении к кластеру и выполнении тестового запроса будет выведена строка bar.

Подробнее о Sentinel читайте в разделе Репликация и персистентность в Yandex Managed Service for Valkey™ и документации Valkey™.

Подключение из графических IDE

Подключение проверялось в следующем окружении:

  • MacOS Big Sur 11.3.
  • DBeaver Enterprise: 21.0.

Подключаться из графических IDE к хостам кластера можно только через SSH-туннель с помощью созданной ВМ. Перед подключением подготовьте сертификат.

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

Поддержка подключения к кластеру Valkey™ доступна только в коммерческих редакциях DBeaver.

Чтобы подключиться к кластеру:

  1. Создайте новое соединение с БД:
    1. Выберите в меню База данных пункт Новое соединение.
    2. Выберите из списка БД Valkey™.
    3. Нажмите кнопку Далее.
    4. Укажите параметры подключения на вкладке Главное:
      • Хост — FQDN хоста-мастера или особый FQDN, всегда указывающий на текущий хост-мастер.
        При подключении к шардированному кластеру укажите через запятую FQDN хостов-мастеров каждого шарда.
      • Порт — 6379 для обычного кластера или 6380 для кластера с включенным SSL-шифрованием.
      • В блоке Аутентификация укажите пароль от кластера.
    5. На вкладке SSH:
      1. Включите настройку Использовать туннель SSH.
      2. Укажите параметры SSH-туннеля:
        • Хост/IP — публичный IP-адрес ВМ для подключения;
        • Имя пользователя — логин для подключения к ВМ;
        • Метод аутентификации — Публичный ключ;
        • Секретный ключ — путь к файлу закрытого ключа для подключения к ВМ;
        • Passphrase — пароль от закрытого ключа.
    6. На вкладке SSL:
      1. Включите настройки Использовать SSL и Пропустить валидацию имени хоста.
      2. В блоке Параметры:
        1. Выберите Способ — Набор сертификатов.
        2. В поле Корневой сертификат укажите путь к сохраненному файлу SSL-сертификата.
  2. Нажмите кнопку Тест соединения ... для проверки соединения с БД. При успешном подключении будет выведен статус подключения, информация о СУБД и драйвере.
  3. Нажмите кнопку Готово, чтобы сохранить настройки соединения с БД.

Подготовка к подключению из Docker-контейнера

Чтобы подключаться к кластеру Yandex Managed Service for Valkey™ из Docker-контейнера, добавьте в Dockerfile строки:

# Собрать вручную утилиту valkey-tools с поддержкой TLS.
RUN apt-get update && \
    apt-get install wget make gcc libssl-dev --yes && \
    wget https://github.com/valkey-io/valkey/archive/refs/tags/<версия_Valkey™>.tar.gz && \
    tar -xzvf <версия_Valkey™>.tar.gz && \
    cd valkey-<версия_Valkey™> && \
    make BUILD_TLS=yes MALLOC=libc && \
    make install && \
    cp ./src/valkey-cli /usr/bin/

# Собрать вручную утилиту valkey-tools с поддержкой TLS.
RUN apt-get update && \
    apt-get install wget make gcc libssl-dev --yes && \
    wget https://github.com/valkey-io/valkey/archive/refs/tags/<версия_Valkey™>.tar.gz && \
    tar -xzvf <версия_Valkey™>.tar.gz && \
    cd valkey-<версия_Valkey™> && \
    make BUILD_TLS=yes MALLOC=libc && \
    make install && \
    cp ./src/valkey-cli /usr/bin/ && \
    # Получить SSL-сертификат.
    mkdir --parents ~/.redis && \
    wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
         --output-document ~/.redis/YandexInternalRootCA.crt && \
    chmod 0655 ~/.redis/YandexInternalRootCA.crt

Версию можно посмотреть на странице релизов Valkey™.

Предыдущая
FQDN хостов
Следующая
Обзор