Как начать работать с Managed Service for Redis

Чтобы начать работу с сервисом:

1. Создайте кластер.
2. Подключитесь к кластеру.

Перед началом работы

1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь, если вы еще не зарегистрированы.

2. Если у вас еще нет каталога, создайте его:

   1. На странице облака нажмите кнопку Создать каталог.

   2. Введите имя каталога. Требования к имени:

      • Длина — от 3 до 63 символов.
      • Может содержать строчные буквы латинского алфавита, цифры и дефисы.
      • Первый символ — буква. Последний символ — не дефис.

   3. (опционально) Введите описание каталога.

   4. Выберите опцию Создать сеть по умолчанию. Будет создана сеть с подсетями в каждой зоне доступности. Также в этой сети будет создана группа безопасности по умолчанию, внутри которой весь сетевой трафик разрешен.

   5. Нажмите кнопку Создать.

3. Подключиться к кластеру можно только изнутри Yandex Cloud. Для подключения создайте виртуальную машину в той же облачной сети, что и кластер Redis (на основе Linux или Windows).

4. Подключитесь к ВМ по SSH.

5. Установите на ВМ утилиту {redis}-cli, например, так (для Ubuntu 20.04 LTS):

   sudo apt install redis-tools
   

Создайте кластер

1. В консоли управления выберите каталог, в котором нужно создать кластер Redis.
2. Выберите сервис Managed Service for Redis.
3. Нажмите кнопку Создать кластер.
4. Задайте параметры кластера и нажмите кнопку Создать кластер. Процесс подробно рассмотрен в разделе Создание Redis-кластера.
5. Дождитесь, когда кластер будет готов к работе: его статус на панели Managed Service for Redis сменится на Running, а состояние — на Alive. Это может занять некоторое время.

Подключитесь к кластеру

1. Если в вашем кластере включена поддержка TLS, настройте SSL-сертификат:

   sudo mkdir ~/.redis && \
   sudo wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
       --output-document=~/.redis/YandexCA.crt && \
   sudo chmod 0655 ~/.redis/YandexCA.crt
   

   Для использования графических IDE скачайте сертификат и укажите путь к нему в настройках подключения.

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

3. Подключитесь к кластеру, используя redis-cli.

   Примечание

   Для подключения к кластеру с поддержкой SSL скачайте архив с исходным кодом утилиты и выполните сборку версии утилиты с TLS командой make BUILD_TLS=yes.

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

   Нешардированный кластер

   Шардированный кластер

   Чтобы подключиться с помощью Sentinel (без SSL):

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

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

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

      redis-cli \
          -hostname c-<идентификатор кластера>.rw.mdb.yandexcloud.net \
          -password <пароль> \
          -port 6380 \
          --tls \
          --cacert ~/.redis/YandexCA.crt
      

   Чтобы подключиться напрямую к мастеру (без SSL):

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

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

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

   Чтобы подключиться без SSL:

   redis-cli -h <FQDN хоста-мастера в любом шарде> \
     -p 6379 \
     -a <пароль Redis>
   

   Чтобы подключиться с SSL:

   redis-cli -h <FQDN хоста-мастера в любом шарде> \
     -p 6380 \
     -a <пароль Redis> \
     --tls \
     --cacert ~/.redis/YandexCA.crt
   

4. После успешного подключения отправьте команду PING. Redis должен вернуть ответ PONG.

Что дальше

• Изучите концепции сервиса.
• Узнайте подробнее о создании кластера и подключении к кластеру.
• Ознакомьтесь с вопросами и ответами.