Usar a ferramenta de linha de comando Redis com o Cache do Azure para Redis
Use a ferramenta de linha de comando redis-cli para interagir com um Cache do Azure para Redis como um cliente. Use essa ferramenta para interagir diretamente com sua instância do Cache do Azure para Redis e para depuração e solução de problemas.
Instalar redis-cli
A ferramenta redis-cli é instalada automaticamente com o pacote Redis, que está disponível para vários sistemas operacionais. Consulte o guia de código aberto instalar Redis para obter a documentação mais detalhada em seu sistema operacional preferido.
Linux
redis-cli é executada nativamente no Linux e a maioria das distribuições incluem um pacote Redis que contém a ferramenta redis-cli. No Ubuntu, por exemplo, instale o pacote Redis com os seguintes comandos:
sudo apt-get update
sudo apt-get install redis
Windows
A melhor maneira de usar redis-cli em um computador Windows é instalar o Subsistema do Windows para Linux (WSL). O subsistema Linux permite que você executa ferramentas do Linux diretamente no Windows. Para instalar o WSL, siga as instruções de instalação do WSL.
Depois que o WSL estiver instalado, você poderá instalar redis-cli usando qualquer gerenciamento de pacote disponível na distribuição do Linux que você escolheu para o WSL.
Coletar informações de acesso do cache
Você pode coletar as informações necessárias para acessar o cache usando esses métodos:
- Usando a CLI do Azure az redis list-keys
- Com o Azure PowerShell usando Get-AzRedisCacheKey
- Usando o portal do Azure
Nesta seção, você recupera as chaves do Portal do Azure.
Recuperar o nome de host, as portas e as chaves de acesso do portal do Azure
Para conectar seu servidor do Cache do Azure para Redis, o cliente de cache precisa do nome do host, das portas e de uma chave para o cache. Alguns clientes podem se referir a esses itens por nomes um pouco diferentes. Você pode obter o nome do host, as portas e as chaves do portal do Azure.
Para obter as chaves de acesso, selecione Autenticação no menu Recurso. Em seguida, selecione a guia Chaves de acesso.
Para obter o nome do host e as portas do cache, selecione Visão geral no menu Recurso. O nome do host está no formato <nome DNS>.redis.cache.windows.net.
Conectar-se usando redis-cli
Abra um shell ou terminal em um computador com o pacote Redis instalado. Se estiver usando o WSL, você poderá usar o Terminal do Windows para abrir uma linha de comando do Linux. Antes de se conectar a redis-cli, verifique:
- Se o acesso TLS é necessário – por padrão, as instâncias do Cache do Azure para Redis usam criptografia TLS para conexões. Sempre que o TLS é usado no lado do servidor, o TLS na redis-cli deve ser habilitado usando a opção
--tls
. - A porta usada – todos os caches das camadas Enterprise e Enterprise Flash usam a porta
10000
. No entanto, os caches das camadas Básico, Standard e Premium usam a porta6379
para conexões não TLS ou a porta6380
para conexões TLS. - Se a instância de cache usa clustering – se você estiver usando um cache de camada Premium que usa clustering ou um cache de camada de serviço Enterprise/Enterprise Flash que esteja usando a política de cluster de software de código aberto, adicione a opção
-c
para garantir que todos os fragmentos possam ser acessados.
Exemplos
Use o seguinte comando para se conectar a uma instância do Cache do Azure para Redis da camada Básica, Standard ou Premium usando TLS:
redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls
Conectar-se a uma instância do Cache do Azure para Redis da camada Básico, Standard ou Premium que não usa TLS:
redis-cli -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey
Conectar-se a uma instância do Cache do Azure para Redis da camada Básico, Standard ou Premium usando TLS e clustering:
redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c
Conectar-se a uma instância de cache da camada Enterprise ou Enterprise Flash usando a política de cluster Enterprise com TLS:
redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls
Conectar-se a uma instância de cache da camada Enterprise ou Enterprise Flash usando a política de cluster de software de código aberto sem TLS:
redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey -c
Testar a conexão
Depois que a conexão for estabelecida, você poderá emitir comandos para a instância do Cache do Azure para Redis. Uma maneira fácil de testar a conexão é usar o comando PING
. Esse comando retorna PONG
no console.
yourcachename.redis.cache.windows.net:6380> PING
PONG
Você também pode executar comandos como SET
e GET
:
yourcachename.redis.cache.windows.net:6380> SET hello world
OK
yourcachename.redis.cache.windows.net:6380> GET hello
"world"
Agora você está conectado à sua instância do Cache do Azure para Redis usando redis-cli.
alternativas a redis-cli
Embora redis-cli seja uma ferramenta útil, você pode se conectar ao cache de outras maneiras para solucionar problemas ou fazer testes:
- O Cache do Azure para Redis oferece um Console do Redis integrado ao portal do Azure, no qual você pode emitir comandos sem precisar instalar a ferramenta de linha de comando. Atualmente, o recurso Console do Redis só está disponível nas camadas Básico, Standard e Premium.
- RedisInsight é uma ferramenta gráfica de software livre avançada para emitir comandos do Redis e exibir o conteúdo de uma instância do Redis. Ela funciona com o Cache do Azure para Redis e tem suporte no Linux, no Windows e no macOS.
Conteúdo relacionado
Comece criando uma nova instância de cache da camada Enterprise.