Как начать работать с Managed Service for Redis
Чтобы начать работу с сервисом:
Перед началом работы
-
Перейдите в консоль управления
, затем войдите в Yandex Cloud или зарегистрируйтесь, если вы еще не зарегистрированы. -
Если у вас еще нет каталога, создайте его:
-
В консоли управления
в списке слева выберите нужное облако. -
Справа сверху нажмите кнопку
Создать каталог. -
Введите имя каталога. Требования к имени:
- длина — от 3 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
-
(Опционально) Введите описание каталога.
-
Выберите опцию Создать сеть по умолчанию. Будет создана сеть с подсетями в каждой зоне доступности. Также в этой сети будет создана группа безопасности по умолчанию, внутри которой весь сетевой трафик разрешен.
-
Нажмите кнопку Создать.
-
-
Убедитесь, что для создания кластера у вашего аккаунта есть роль vpc.user и роль managed-redis.editor или выше.
-
Если для кластера не настроен публичный доступ, подключиться к нему можно только изнутри Yandex Cloud. Для подключения создайте виртуальную машину в той же облачной сети, что и кластер Redis (на основе Linux).
-
Подключитесь к ВМ по SSH.
-
Установите на ВМ утилиту redis-cli
, например, так (для Ubuntu 20.04 LTS):sudo apt install redis-tools
Создайте кластер
- В консоли управления выберите каталог, в котором нужно создать кластер Redis.
- Выберите сервис Managed Service for Redis.
- Нажмите кнопку Создать кластер.
- Задайте параметры кластера и нажмите кнопку Создать кластер. Процесс подробно рассмотрен в разделе Создание кластера.
- Дождитесь, когда кластер будет готов к работе: его статус на панели Managed Service for Redis сменится на Running, а состояние — на Alive. Это может занять некоторое время.
Подключитесь к кластеру
-
Если в вашем кластере включена поддержка 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
. -
Если вы используете группы безопасности для облачной сети, настройте их так, чтобы был разрешен весь необходимый трафик между кластером и хостом, с которого выполняется подключение.
-
Подключитесь к кластеру, используя
redis-cli
.Примечание
Для подключения к кластеру с поддержкой SSL скачайте
архив с исходным кодом утилиты и выполните сборку версии утилиты с TLS командойmake BUILD_TLS=yes
.Примеры кода с заполненным FQDN хоста доступны в консоли управления
по нажатию кнопки Подключиться на странице кластера.Нешардированный кластерШардированный кластерЧтобы подключиться с помощью Sentinel
(без SSL):-
Получите адрес хоста-мастера, используя Sentinel и любой хост Redis:
redis-cli -h <FQDN_любого_хоста_Redis> \ -p 26379 \ sentinel get-master-addr-by-name <имя_кластера_Redis> | head -n 1
-
Подключитесь к хосту с этим адресом:
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
-
-
После успешного подключения отправьте команду
PING
. Redis должен вернуть ответPONG
.
Что дальше
- Изучите концепции сервиса.
- Узнайте подробнее о создании кластера и подключении к кластеру.
- Ознакомьтесь с вопросами и ответами.