Usare lo strumento da riga di comando Redis con cache di Azure per Redis

Usare lo strumento da riga di comando redis-cli per interagire con un'istanza della cache di Azure per Redis come client. Usare questo strumento per interagire direttamente con l'istanza della cache di Azure per Redis e per il debug e la risoluzione dei problemi.

Installare redis-cli

Lo strumento redis-cli viene installato automaticamente con il pacchetto Redis, disponibile per più sistemi operativi. Per la documentazione più dettagliata sul sistema operativo preferito, vedere la guida open source all'installazione di Redis.

Linux

redis-cli viene eseguita in modo nativo in Linux e la maggior parte delle distribuzioni include un pacchetto Redis che contiene lo strumento redis-cli. In Ubuntu, ad esempio, si installa il pacchetto Redis con i comandi seguenti:

sudo apt-get update
sudo apt-get install redis

Finestre

Il modo migliore per usare redis-cli in un computer Windows consiste nell'installare il sottosistema Windows per Linux (WSL). Il sottosistema Linux consente di eseguire gli strumenti Linux direttamente in Windows. Per installare WSL, seguire le istruzioni di installazione di WSL.

Dopo aver installato WSL, è possibile installare redis-cli usando qualsiasi gestione dei pacchetti disponibile nella distribuzione Linux scelta per WSL.

Raccogliere le informazioni di accesso alla cache

È possibile raccogliere le informazioni necessarie per accedere alla cache nelle modalità seguenti:

In questa sezione si recuperano le chiavi dal portale di Azure.

Ottieni il nome host e la chiave di accesso

Per connettere il server cache di Azure per Redis, il client della cache deve avere il nome host della cache, le porte e una chiave di accesso. Alcuni client possono fare riferimento a questi elementi usando nomi leggermente diversi. È possibile ottenere il nome host, le porte e le chiavi nel portale di Azure.

  • Per ottenere una chiave di accesso per la cache:

    1. Nel portale di Azure, passare alla cache.
    2. Nel menu del servizio, in Impostazioni, seleziona Autenticazione.
    3. Nel pannello Autenticazione, selezionare la scheda Chiavi di accesso.
    4. Per copiare il valore per una chiave di accesso, selezionare l'icona Copia nel campo della chiave.

    Screenshot che mostra come trovare e copiare una chiave di accesso per un'istanza di cache di Azure per Redis.

  • Per ottenere il nome host e le porte della cache:

    1. Nel portale di Azure, passare alla cache.
    2. Nel menù del servizio, selezionare Panoramica.
    3. In Essentials, per Nome host, selezionare l'icona Copia per copiare il valore del nome host. Il valore del nome host ha la forma <DNS name>.redis.cache.windows.net.
    4. Per Porte, selezionare l'icona Copia per copiare i valori della porta.

    Screenshot che mostra come trovare e copiare il nome host e le porte per un'istanza di cache di Azure per Redis.

Connettersi con redis-cli

Aprire una shell o un terminale in un computer con il pacchetto Redis installato. Se si usa WSL, è possibile usare il terminale Windows per aprire una riga di comando Linux. Prima di connettersi con redis-cli, controllare:

  1. Se è necessario l'accesso TLS: per impostazione predefinita, le istanze della cache di Azure per Redis usano la crittografia TLS per le connessioni. Ogni volta che si usa TLS sul lato server, TLS in redis-cli deve essere abilitata usando l'opzione --tls.
  2. La porta usata: tutte le cache del livello Enterprise ed Enterprise Flash usano la porta 10000. Le cache di livello Basic, Standard e Premium, tuttavia, usano la porta 6379 per le connessioni non TLS o la porta 6380 per le connessioni TLS.
  3. Se l'istanza della cache usa il clustering: se si usa una cache di livello Premium che utilizza il clustering o una cache del livello Enterprise/Enterprise Flash con i criteri del cluster del software open source, aggiungere l'opzione -c per assicurarsi che sia possibile accedere a tutte le partizioni.

Esempi

  1. Usare il comando seguente per connettersi a un'istanza della cache di Azure per Redis di livello Basic, Standard o Premium usando TLS:

    redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls
    
  2. Connettersi a un'istanza della cache di Azure per Redis di livello Basic, Standard o Premium che non usa TLS:

    redis-cli -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey
    
  3. Connettersi a un'istanza della cache di Azure per Redis di livello Basic, Standard o Premium usando TLS e clustering:

    redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c
    
  4. Connettersi a un'istanza della cache del livello Enterprise o Enterprise Flash usando i criteri del cluster Enterprise con TLS:

    redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls
    
  5. Connettersi a un'istanza della cache del livello Enterprise o Enterprise Flash usando i criteri del cluster del software open source senza TLS:

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

Test della connessione

Dopo aver stabilito la connessione, è possibile eseguire comandi all'istanza della cache di Azure per Redis. Un modo semplice per testare la connessione consiste nell'usare il comando PING. Questo comando restituisce PONG nella console.

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

È anche possibile eseguire comandi come SET e GET:

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

A questo momento si è connessi all'istanza della cache di Azure per Redis usando redis-cli.

Alternative a redis-cli

Anche se redis-cli è uno strumento utile, è possibile connettersi alla cache in altri modi per la risoluzione dei problemi o i test:

  • La Cache di Azure per Redis offre una console Redis incorporata nel portale di Azure in cui è possibile eseguire comandi senza dover installare lo strumento da riga di comando. La funzionalità Console Redis è attualmente disponibile solo nei livelli Basic, Standard e Premium.
  • RedisInsight è uno strumento grafico open source avanzato per l'emissione di comandi Redis e la visualizzazione del contenuto di un'istanza di Redis. Funziona con la cache di Azure per Redis ed è supportato in Linux, Windows e macOS.

Per iniziare, creare una nuova istanza della cache di livello Enterprise.