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

Используйте средство командной строки redis-cli для взаимодействия с Кэш Azure для Redis в качестве клиента. Используйте это средство для непосредственного взаимодействия с экземпляром Кэш Azure для Redis, а также для отладки и устранения неполадок.

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

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

Linux

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

sudo apt-get update
sudo apt-get install redis

Windows

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

После установки WSL можно установить redis-cli с помощью любого управления пакетами в дистрибутиве Linux, выбранном для WSL.

Сбор сведений для доступа к кэшу

Вы можете собрать сведения, необходимые для доступа к кэшу, с помощью следующих методов:

• С помощью Azure CLI и команды az redis list-keys.
• С помощью Azure PowerShell и командлета Get-AzRedisCacheKey.
• Использование портала Azure

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

Получение имени узла, портов и ключа доступа

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

• Чтобы получить ключ доступа для кэша, выполните приведенные далее действия.

  1. В портал Azure перейдите в кэш.
  2. В меню службы в разделе "Параметры" выберите "Проверка подлинности".
  3. На панели проверки подлинности перейдите на вкладку "Ключи доступа".
  4. Чтобы скопировать значение ключа доступа, щелкните значок копирования в поле ключа.

  

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

  1. В портал Azure перейдите в кэш.
  2. В меню службы выберите "Обзор".
  3. В разделе Essentials для имени узла щелкните значок "Копировать", чтобы скопировать значение имени узла. Значение имени узла имеет форму <DNS name>.redis.cache.windows.net.
  4. Для портов щелкните значок копирования , чтобы скопировать значения портов.

  

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

Откройте оболочку или терминал на компьютере с установленным пакетом Redis. При использовании WSL можно использовать Терминал Windows для открытия командной строки Linux. Прежде чем подключаться к redis-cli, проверьте:

1. Требуется ли доступ TLS. По умолчанию Кэш Azure для Redis экземпляры используют шифрование TLS для подключений. Всякий раз, когда TLS используется на стороне сервера, протокол TLS в redis-cli должен быть включен с помощью --tls параметра.
2. Используемый порт — все кэши уровня Enterprise и Enterprise Flash используют порт 10000. Однако кэши уровня "Базовый", "Стандартный" и "Премиум" используют порт 6379 для подключений, отличных от TLS, или портов 6380 для подключений TLS.
3. Используется ли экземпляр кэша кластеризация. Если вы используете кэш уровня "Премиум", использующий кластеризацию или кэш уровня Enterprise/Enterprise Flash, использующий политику кластера OSS, добавьте -cпараметр, чтобы обеспечить доступ ко всем сегментам.

Примеры

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

   redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls
   

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

   redis-cli -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey
   

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

   redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c
   

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

   redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls
   

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

   redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey -c
   

Тестирование подключения

После установки подключения можно выдавать команды Кэш Azure для Redis экземпляру. Одним из простых способов проверки подключения является использование PING команды. Эта команда возвращается PONG в консоли.

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

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

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

Теперь вы подключены к экземпляру Кэш Azure для Redis с помощью redis-cli.

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

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

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

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

Начало работы с созданием экземпляра кэша уровня Enterprise.