Поделиться через

Использование программы командной строки Redis с Кэшем Azure для Redis

  • Применяется к: ✅ Azure Cache for Redis

В этой статье описывается, как использовать интерфейс командной строки redis-cli для взаимодействия с кэшем Azure для Redis в качестве клиента. С помощью redis-cli можно напрямую взаимодействовать с экземпляром кэша Redis Azure, а также для отладки и устранения неполадок.

Предпосылка

Доступ к экземпляру сервера кэша Azure Cache для Redis.

Установка redis-cli

Средство redis-cli устанавливается автоматически с пакетом Redis, который доступен для Linux, macOS и Windows. Подробные инструкции по установке см. в документации redis с открытым кодом.

Установка в Linux

Средство redis-cli работает изначально в Linux, и большинство дистрибутивов Linux включают пакет Redis, содержащий redis-cli. Например, вы устанавливаете пакет Redis в Ubuntu со следующими командами:

sudo apt-get update
sudo apt-get install redis

Установка в Windows

Лучший способ использовать redis-cli в Windows — установить подсистему Windows для Linux (WSL), которая позволяет запускать средства Linux непосредственно в Windows. Чтобы установить WSL, см. статью "Установка Linux в Windows с помощью WSL".

После установки используйте WSL для установки дистрибутива Linux, а затем установите redis-cli с помощью доступного управления пакетами для выбранного дистрибутива Linux. Дистрибутив по умолчанию для WSL — Ubuntu. Дополнительные сведения см. в документации Redis с открытым кодом.

Подключение с помощью redis-cli

Чтобы использовать redis-cli для подключения к кэшу Redis в качестве клиента, необходимо указать имя узла кэша, порт и ключи. Эти значения можно получить следующими методами:

В следующем разделе описывается, как получить эти значения на портале Azure.

Получение имени узла кэша, порта и ключей доступа на портале Azure

Чтобы подключиться к кэшу Redis Azure, клиент кэша должен иметь имя узла кэша, порты и ключи. Некоторые клиенты могут ссылаться на эти элементы с помощью незначительно различающихся имен. Следуйте этим инструкциям, чтобы получить имя узла кэша, порты и ключи на портале Azure.

  • Получите имя узла на странице обзора кэша. Имя узла имеет форму <cachename>.redis.cache.windows.net.

  • Выберите ссылку рядом с портами , чтобы получить порты. Кэши уровня Enterprise и Enterprise Flash используют порт 10000. Кэши уровня "Базовый", "Стандартный" и "Премиум" используют порт 6380 для подключений tls или портов 6379 , отличных от TLS.

  • Чтобы получить ключи доступа, выберите "Показать ключи доступа".

    Снимок экрана: свойства кэша Redis для Azure.

    В области CacheKeys отображаются ключи.

    Снимок экрана: панель ключей доступа к кэшу Redis для Azure.

    Вы также можете выбрать проверку подлинности в разделе "Параметры " в меню навигации слева и выбрать вкладку "Ключи доступа ".

    Снимок экрана: ключи доступа кэша Redis для Azure.

Получение других сведений о кэше

Также может потребоваться указать следующие параметры для redis-cli:

  • TLS. По умолчанию экземпляры Redis Azure используют шифрование TLS для подключений. Если кэш использует TLS, необходимо включить TLS для redis-cli с помощью --tls параметра.
  • Кластеризация. Если у вас есть кэш уровня "Премиум", использующий кластеризацию, или кэш уровня Enterprise или Enterprise Flash, использующий политику кластера OSS, добавьте -c параметр, чтобы обеспечить доступ ко всем сегментам.

Выполните команду подключения redis-cli

Чтобы подключиться к кэшу, откройте оболочку или терминал на компьютере с установленным пакетом Redis. В Windows можно использовать WSL с терминалом Windows для открытия командной строки Linux.

Выполните одну из следующих командных строк в зависимости от параметров TLS, порта и кластеризации. Замените заполнители <cache name> и <access key> значениями для вашего кэша.

  • Подключитесь к экземпляру Azure Redis уровня "Базовый", "Стандартный" или "Премиум", использующим TLS:

    redis-cli -p 6380 -h <cache name>.redis.cache.windows.net -a <access key> --tls

  • Подключитесь к экземпляру Azure Redis уровня "Базовый", "Стандартный" или "Премиум", который не использует TLS:

    redis-cli -p 6379 -h <cache name>.redis.cache.windows.net -a <access key>

  • Подключитесь к экземпляру Azure Redis уровня "Премиум", который использует TLS и кластеризацию:

    redis-cli -p 6380 -h <cache name>.redis.cache.windows.net -a <access key> --tls -c

  • Подключитесь к экземпляру кэша на уровне Enterprise или Enterprise Flash, использующему политику кластера Enterprise с TLS:

    redis-cli -p 10000 -h <cache name>.eastus.redisenterprise.cache.azure.net -a <access key> --tls

  • Подключитесь к экземпляру кэша уровня Enterprise или Enterprise Flash, использующим политику кластера OSS без TLS:

    redis-cli -p 10000 -h <cache name>.eastus.redisenterprise.cache.azure.net -a <access key> -c

Теперь вы подключены к экземпляру кэша Redis Azure.

Использование команд redis-cli с кэшем Azure Redis

После установки подключения можно выполнить команды в экземпляре Azure Redis в командной строке redis-cli. В следующих примерах показано подключение к кэшу, названному contoso, который использует порт 6380.

Одним из простых способов проверки подключения является использование PING команды. Команда возвращает PONG в консоль.

contoso.redis.cache.windows.net:6380> PING
PONG

Вы также можете выполнять такие команды, как SET и GET.

contoso.redis.cache.windows.net:6380> SET hello world
OK
contoso.redis.cache.windows.net:6380> GET hello
"world"

Альтернативные варианты redis-cli

Хотя redis-cli является полезным инструментом, вы также можете использовать следующие другие методы для подключения к кэшу для устранения неполадок или тестирования:

  • Консоль Redis позволяет выдавать команды, не устанавливая redis-cli. Консоль Redis в настоящее время доступна только для уровней "Базовый", "Стандартный" и "Премиум". Если консоль Redis доступна, ее можно использовать, выбрав консоль на верхней панели инструментов страницы обзора кэша на портале Azure.
  • RedisInsight — это широкий графический инструмент с открытым кодом для выдачи команд Redis и просмотра содержимого экземпляра Redis. RedisInsight работает с кэшем Azure для Redis и поддерживается в Linux, Windows и macOS.

Связанный контент