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

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

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

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

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

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

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

   2. Справа сверху нажмите кнопку Создать каталог.

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

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

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

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

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

3. Убедитесь, что для создания кластера у вашего аккаунта есть роль vpc.user и роль managed-redis.editor или выше.

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

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

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

   sudo apt install redis-tools
   

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

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

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

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

   Linux (Bash)/macOS (Zsh)

   Windows (PowerShell)

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

   Сертификат будет сохранен в файле ~/.redis/YandexInternalRootCA.crt.

   mkdir $HOME\.redis; curl.exe -o $HOME\.redis\YandexInternalRootCA.crt https://storage.yandexcloud.net/cloud-certs/CA.pem
   

   Сертификат будет сохранен в файле $HOME\.redis\YandexInternalRootCA.crt.

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

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

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

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

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

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

Что дальшеЧто дальше

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