Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Managed Service for Valkey™
  • Начало работы
    • Все инструкции
      • Предварительная настройка
      • FQDN хостов
      • Подключение из приложений
      • Обновление цепочки TLS-сертификатов
  • Управление доступом
  • Инспекции и рекомендации
  • Правила тарификации
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  • Вопросы и ответы

В этой статье:

  • Инструменты командной строки
  • valkey-cli (redis-cli)
  • Valkey™ Sentinel
  • Подключение с аутентификацией через IAM
  • Подключение из графических IDE
  • Подготовка к подключению из Docker-контейнера
  1. Пошаговые инструкции
  2. Подключение
  3. Подключение из приложений

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

Статья создана
Yandex Cloud
Обновлена 9 ноября 2026 г.
Открыть в Markdown
  • Инструменты командной строки
    • valkey-cli (redis-cli)
    • Valkey™ Sentinel
    • Подключение с аутентификацией через IAM
  • Подключение из графических IDE
  • Подготовка к подключению из Docker-контейнера

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

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

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

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

valkey-cli (redis-cli)valkey-cli (redis-cli)

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

Важно

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

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

Подключение без SSL
Подключение с SSL через valkey-cli
Подключение с SSL через redis-cli
  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™ SentinelValkey™ Sentinel

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

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

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

Подключение без SSL
  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™.

Подключение с аутентификацией через IAMПодключение с аутентификацией через IAM

К базе данных в кластере Valkey™ можно подключиться с помощью интерфейса командной строки Yandex Cloud (CLI), используя авторизацию через IAM. Для этого нужно привязать к пользователю Valkey™ аккаунт на Яндексе. Подключаться с авторизацией через IAM можно только к кластеру с включенным TLS и публичным доступом на хостах.

Подготовьте кластер Valkey™ к подключению:

Консоль управления
  1. В консоли управления выберите каталог с нужным кластером.

  2. Перейдите в сервис Yandex Managed Service for Valkey™.

  3. Выберите нужный кластер.

  4. Включите публичный доступ к хостам кластера.

  5. Назначьте роль аккаунту пользователя, который будет подключаться к БД по IAM:

    1. Выберите вкладку Права доступа и нажмите кнопку Назначить роли.
    2. Введите электронную почту пользователя, к которой привязан аккаунт.
    3. Нажмите кнопку Добавить роль и выберите роль managed-redis.clusters.connector.
    4. Нажмите кнопку Сохранить.
  6. Создайте пользователя в кластере Valkey™ со способом авторизации IAM. Для этого способа авторизации выберите нужный аккаунт на Яндексе в поле Пользователь.

Подключитесь к БД в кластере Valkey™:

  1. Создайте IAM-токен для пользователя:

    yc iam create-token
    
  2. Выполните команду для подключения:

    redis-cli \
    -h "<FQDN_хоста>" \
    -p 6380 \
    --tls \
    --cacert ~/.redis/YandexInternalRootCA.crt \
    --user "<email_пользователя>" \
    --pass "<IAM_токен>"
    

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

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

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

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

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

DBeaver

Поддержка подключения к кластеру 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-контейнераПодготовка к подключению из Docker-контейнера

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

Подключение без SSL
Подключение с SSL
# Собрать вручную утилиту 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/RootCA.pem" \
         --output-document ~/.redis/YandexInternalRootCA.crt && \
    chmod 0655 ~/.redis/YandexInternalRootCA.crt

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

Была ли статья полезна?

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