Compartilhar via

Usar a ferramenta de linha de comando Redis com o Cache do Azure para Redis

  • Aplica-se a: ✅ Azure Cache for Redis

Este artigo descreve como usar a interface de linha de comando redis-cli para interagir com o Cache do Azure para Redis como um cliente. Você pode usar o redis-cli para interagir diretamente com sua instância de cache redis do Azure e para depuração e solução de problemas.

Pré-requisito

Acesso a uma instância de servidor do Cache do Azure para Redis.

Instalar redis-cli

A ferramenta redis-cli é instalada automaticamente com o pacote Redis, que está disponível para Linux, macOS e Windows. Para obter instruções detalhadas de instalação, consulte a documentação do Redis de software livre.

Instalar no Linux

A ferramenta redis-cli é executada nativamente no Linux e a maioria das distribuições do Linux incluem um pacote Redis que contém redis-cli. Por exemplo, você instala o pacote Redis no Ubuntu com os seguintes comandos:

sudo apt-get update
sudo apt-get install redis

Instalar no Windows

A melhor maneira de usar o redis-cli no Windows é instalar o Subsistema do Windows para Linux (WSL), que permite executar ferramentas do Linux diretamente no Windows. Para instalar o WSL, consulte Como instalar o Linux no Windows com o WSL.

Depois de instalado, use o WSL para instalar uma distribuição do Linux e instale o redis-cli usando o gerenciamento de pacotes disponível para a distribuição do Linux escolhida. A distribuição padrão do WSL é o Ubuntu. Para obter mais informações, consulte a documentação do Redis de software livre.

Conectar-se usando redis-cli

Para usar o redis-cli para se conectar ao cache Redis do Azure como cliente, você deve especificar o nome do host, a porta e as chaves do cache. Você pode recuperar esses valores pelos seguintes métodos:

A seção a seguir descreve como obter esses valores do portal do Azure.

Obter o nome do host de cache, a porta e as chaves de acesso do portal do Azure

Para se conectar ao cache redis do Azure, o cliente de cache precisa do nome do host, das portas e das chaves do cache. Alguns clientes podem se referir a esses itens por nomes um pouco diferentes. Siga estas instruções para obter o nome do host de cache, as portas e as chaves do portal do Azure.

  • Obtenha o nome do host na página Visão geral do cache. O nome do host está no formato <cachename>.redis.cache.windows.net.

  • Selecione o link ao lado de Portas para obter as portas. Os caches da camada Enterprise e Enterprise Flash usam a porta 10000. Os caches de camada Básico, Standard e Premium usam uma porta 6380 para conexões TLS (Transport Layer Security) ou porta 6379 para conexões não TLS.

  • Para obter as chaves de acesso, selecione Mostrar chaves de acesso.

    Captura de tela mostrando as propriedades do cache redis do Azure.

    O painel CacheKeys exibe as chaves.

    Captura de tela mostrando o painel de chaves de acesso do cache redis do Azure.

    Você também pode selecionar Autenticação em Configurações no menu de navegação à esquerda e, em seguida, selecionar a guia Chaves de Acesso .

    Captura de tela mostrando as chaves de acesso do cache do Azure Redis.

Obter outras informações de cache

Talvez você também precise especificar as seguintes opções para redis-cli:

  • TLS: por padrão, as instâncias do Azure Redis usam criptografia TLS para conexões. Se o cache usar TLS, você deverá habilitar o TLS para redis-cli usando a opção --tls .
  • Clustering: se você tiver um cache de camada Premium que usa clustering ou um cache da camada Enterprise ou Enterprise Flash que usa a política de cluster do OSS, adicione a opção -c para garantir que todos os fragmentos possam ser acessados.

Executar o comando de conexão redis-cli

Para se conectar ao cache, abra um shell ou terminal em um computador com o pacote Redis instalado. No Windows, você pode usar o WSL com o Terminal do Windows para abrir uma linha de comando do Linux.

Execute uma das seguintes linhas de comando, dependendo das opções de TLS, porta e clustering. Substitua os <cache name> espaços reservados e <access key> os valores do cache.

  • Conecte-se a uma instância do Azure Redis da camada Básica, Standard ou Premium que usa TLS:

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

  • Conecte-se a uma instância do Azure Redis da camada Básica, Standard ou Premium que não usa TLS:

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

  • Conecte-se a uma instância do Azure Redis de camada Premium que usa TLS e clustering:

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

  • Conecte-se a uma instância de cache da camada Enterprise ou Enterprise Flash que usa a política de cluster Enterprise com o TLS:

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

  • Conecte-se a uma instância de cache da camada Enterprise ou Enterprise Flash que usa a política de cluster do OSS sem TLS:

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

Agora você está conectado à instância de cache redis do Azure.

Usar comandos redis-cli com o cache Redis do Azure

Depois de estabelecer a conexão, você poderá emitir comandos para sua instância do Azure Redis no prompt de comando redis-cli. Os exemplos a seguir mostram uma conexão com um cache chamado contoso que usa a porta 6380.

Uma maneira fácil de testar a conexão é usar o comando PING. O comando retorna PONG no console.

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

Você também pode executar comandos como SET e GET.

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

Alternativas à redis-cli

Embora a cli-redis seja uma ferramenta útil, você também pode usar os seguintes outros métodos para se conectar ao cache para solução de problemas ou teste:

  • O Console do Redis permite que você emita comandos sem precisar instalar o redis-cli. No momento, o Console Redis está disponível apenas para as camadas Basic, Standard e Premium. Se o Console redis estiver disponível, você poderá usá-lo selecionando Console na barra de ferramentas superior da página visão geral do cache no portal do Azure.
  • O RedisInsight é uma ferramenta gráfica avançada de software livre para emitir comandos Redis e exibir o conteúdo de uma instância do Redis. O RedisInsight funciona com o Cache do Azure para Redis e tem suporte no Linux, no Windows e no macOS.

Conteúdo relacionado