Compartir vía

Uso de la herramienta de línea de comandos de Redis con Azure Managed Redis (versión preliminar)

  • Artículo

Use la herramienta de línea de comandos redis-cli para interactuar con una instancia de Azure Managed Redis (versión preliminar) como cliente. Use esta herramienta para interactuar directamente con la instancia de Azure Managed Redis y para depurar y solucionar problemas.

Instalación de redis-cli

La herramienta redis-cli se instala automáticamente con el paquete de Redis, que está disponible para varios sistemas operativos. Consulte la guía de código abierto de instalación de Redis para obtener la documentación más detallada sobre su sistema operativo preferido.

Linux

redis-cli se ejecuta de forma nativa en Linux y la mayoría de las distribuciones incluyen un paquete de Redis que contiene la herramienta redis-cli. En Ubuntu, por ejemplo, instale el paquete de Redis con los siguientes comandos:

sudo apt-get update
sudo apt-get install redis

Windows

La mejor manera de usar redis-cli en un equipo Windows es instalar el Subsistema de Windows para Linux (WSL). El subsistema para Linux permite ejecutar herramientas de Linux directamente en Windows. Para instalar WSL, siga las instrucciones de instalación de WSL.

Una vez instalado WSL, puede instalar redis-cli mediante la administración de paquetes que esté disponible en la distribución de Linux que eligió para WSL.

Recopilar información de acceso a la caché

Puede recopilar la información necesaria para acceder a la memoria caché mediante estos métodos:

En esta sección, se recuperan las claves de Azure Portal.

Recuperación del nombre de host, los puertos y las claves de acceso desde Azure Portal

Para conectar el servidor de Azure Cache for Redis, el cliente de dicha caché necesita el nombre de host, los puertos y una clave para la caché. Es posible que algunos clientes utilicen nombres ligeramente diferentes para estos elementos. Puede obtener el nombre de host, los puertos y las claves de Azure Portal.

  • Para obtener las claves de acceso, seleccione Autenticación en el menú Recurso. A continuación, seleccione la pestaña Claves de acceso.

    Captura de pantalla que muestra las claves de acceso de Azure Cache for Redis.

  • Para obtener el nombre de host y los puertos de la memoria caché, seleccione Información general en el menú Recurso. El nombre de host tiene el formato <nombre_DNS>.redis.cache.windows.net.

    Captura de pantalla que muestra las propiedades Azure Cache for Redis.

Conexión mediante redis-cli

Abra un shell o terminal en un equipo con el paquete de Redis instalado. Si usa WSL, puede usar el terminal de Windows para abrir una línea de comandos de Linux. Antes de conectarse con redis-cli, compruebe lo siguiente:

  1. Si se necesita acceso TLS: de manera predeterminada, las instancias de Azure Managed Redis usan cifradoTLS para las conexiones. Cada vez que se usa TLS en el servidor, se debe habilitar TLS en redis-cli mediante la opción --tls.
  2. Puerto usado: todas las instancias de Azure Managed Redis usan el puerto 10000. Tenga en cuenta que esto es diferente del valor predeterminado de la edición de la comunidad de Redis, que es 6379.
  3. Si la instancia de caché usa la directiva de clúster de OSS: si usa la directiva de clúster del sistema operativo, agregue la opción -c para asegurarse de que se puede acceder a todas las particiones.

Ejemplos

  1. Conéctese a una instancia de Azure Managed Redis mediante la directiva de clúster enterprise con TLS:

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls

  2. Conéctese a una instancia de Azure Managed Redis mediante la directiva de clúster de OSS y TLS:

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls -c

Prueba de la conexión

Una vez establecida la conexión, puede emitir comandos a la instancia de Azure Managed Redis. Una manera sencilla de probar la conexión es usar el comando PING. Este comando devuelve PONG en la consola.

yourcachename.region.redis.azure.net:10000> PING
PONG

También puede ejecutar comandos como SET y GET:

yourcachename.region.redis.azure.net:10000> SET hello world
OK
yourcachename.region.redis.azure.net:10000> GET hello
"world"

Ahora, está conectado a la instancia de Azure Managed Redis mediante redis-cli.

Alternativas a redis-cli

Aunque redis-cli es una herramienta útil, puede conectarse a la memoria caché de otras maneras para solucionar problemas o realizar pruebas:

  • RedisInsight es una herramienta gráfica de código abierto enriquecida para emitir comandos de Redis y ver el contenido de una instancia de Redis. Funciona con Azure Managed Redis y es compatible con Linux, Windows y macOS.

Contenido relacionado

Para empezar, cree una nueva instancia de Azure Managed Redis Instance.