Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda> Distributed Cache Service> Guía del usuario> Acceso a una instancia de DCS para Redis> Acceso en diferentes idiomas> redis-cli
Actualización más reciente 2022-11-07 GMT+08:00
Ver PDF

redis-cli

Esta sección describe cómo utilizar redis-cli en un ECS en la misma VPC que una instancia de DCS Redis para conectarse a la instancia. Para obtener más información sobre más clientes, consulte el sitio web oficial de Redis.

Para obtener más información sobre cómo acceder a una instancia de DCS Redis a través de redes públicas, consulte Paso 3: Acceda a una instancia de DCS Redis en Windows.

  • Redis 3.0 no admite la personalización de puertos y solo permite el puerto 6379. Para Redis 4.0 y 5.0, puede especificar un puerto o utilizar el puerto predeterminado 6379. A continuación se utiliza el puerto predeterminado 6379. Si ha especificado un puerto, reemplace 6379 por el puerto real.
  • Cuando se conecte a una instancia de Clúster Redis, asegúrese de que se agrega -c al comando. De lo contrario, la conexión fallará.
    • Ejecute el siguiente comando para conectarse a una instancia de Clúster Redis:

      ./redis-cli -h {dcs_instancia_dirección} -p 6379 -a {contraseña} -c

    • Ejecute el siguiente comando para conectarse a una instancia de nodo único, principal/en standby o de Clúster Proxy:

      ./redis-cli -h {dcs_instancia_dirección} -p 6379 -a {contraseña}

    Para más detalles, consulte 3.

Prerrequisitos:

  • Se ha creado una instancia de DCS Redis y se encuentra en el estado Running.
  • Se ha creado un ECS. Para obtener más información sobre cómo crear un ECS, consulte Compra de un ECS.
  • Si el ECS ejecuta el SO de Linux, asegúrese de que el entorno de compilación de GCC se ha instalado en el ECS.

Procedimiento (Linux)

  1. Vea la dirección IP/nombre de dominio y el número de puerto de la instancia de DCS Redis a la que se debe acceder.Para más detalles, consulte Consulta de detalles de instancia.
  2. Para obtener más información sobre cómo instalar el cliente redis-cli, consulte las instrucciones oficiales de Redis.

    Los siguientes pasos asumen que su cliente está instalado en el SO de Linux.

    1. Inicie sesión en el ECS.
    2. Ejecute el siguiente comando para descargar el paquete de código fuente de su cliente Redis desde http://download.redis.io/releases/redis-5.0.8.tar.gz:

      wget http://download.redis.io/releases/redis-5.0.8.tar.gz

    3. Ejecute el siguiente comando para descomprimir el paquete de código fuente de su cliente Redis:

      tar -xzf redis-5.0.8.tar.gz

    4. Ejecute los siguientes comandos para ir al directorio Redis y compilar el código fuente de su cliente Redis:

      cd redis-5.0.8

      make

      cd src

  3. Acceda a la instancia de DCS Redis.

    • Acceda a una instancia DCS de un tipo distinto de Clúster Redis.
      Realice el siguiente procedimiento para acceder a una instancia de DCS Redis 3.0 o a una instancia de DCS Redis 4.0 o 5.0 de nodo único, principal/en standby o de Clúster Proxy.
      1. Ejecute el siguiente comando para acceder a la instancia de DCS Redis elegida:

        ./redis-cli -h {dcs_instancia_dirección} -p 6379

        {dcs_instancia_dirección} indica la dirección IP/nombre de dominio de la instancia DCS y 6379 es el puerto utilizado para acceder a la instancia. La dirección IP/nombre de dominio y el número de puerto se obtienen en 1.

        Para una instancia de Clúster Proxy DCS Redis, puede usar la Connection Address o la IP Address para {dcs_instancia_dirección}. Las direcciones se pueden obtener en la página de información básica de la instancia en la consola, como se muestra en Figura 1.

        • Connection Address y IP Address son las direcciones de LB. Las solicitudes se distribuyen entre nodos proxy.
        • Puede utilizar Backend Addresses para conectarse directamente al nodo proxy especificado de una instancia de DCS Redis 3.0 de Clúster Proxy.
        Figura 1 Obtención de las direcciones para conectarse a instancias de Clúster Proxy DCS

        En el ejemplo siguiente se utiliza la dirección de nombre de dominio de una instancia de DCS Redis. Cambie el nombre de dominio y el puerto según sea necesario.

        [root@ecs-redis redis-5.0.8]# cd src
[root@ecs-redis src]# ./redis-cli -h redis-069949a-dcs-lxy.dcs.huaweicloud.com -p 6379
redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379>
      2. Si ha establecido una contraseña para la instancia DCS, introduzca la contraseña en este paso. Puede leer y escribir datos almacenados en caché solo después de verificar la contraseña.

        auth {contraseña}

        {contraseña} indica la contraseña utilizada para iniciar sesión en la instancia de DCS Redis elegida. Esta contraseña se define durante la creación de una instancia de DCS Redis.

        La salida del comando es la siguiente:

        redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379> auth *******
OK
redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379>
    • Acceda a una instancia DCS del tipo Clúster Redis.

      Realice el siguiente procedimiento para acceder a una instancia de DCS Redis 4.0 o 5.0 en tipo Clúster Redis.

      1. Ejecute el siguiente comando para acceder a la instancia de DCS Redis elegida:

        ./redis-cli -h {dcs_instancia_dirección} -p 6379 -a {contraseña} -c

        {dcs_instancia_dirección} indica la dirección IP/nombre de dominio de la instancia de DCS Redis, 6379 es el puerto utilizado para acceder a la instancia, {contraseña} es la contraseña de la instancia, y -c se utiliza para acceder a los nodos de Clúster Redis. La dirección IP/nombre de dominio y el número de puerto se obtienen en 1.

        Puede establecer {dcs_instancia_dirección} en Connection Address o IP Address en la sección Connection o IP Address en la sección Instance Topology. Las direcciones se pueden obtener en la página de información básica de la instancia en la consola, como se muestra en Figura 2.

        • El campo IP Address proporciona dos direcciones IP. Puede utilizar cualquiera de ellos para conectarse a la instancia. El algoritmo CRC16 (clave) mod 16384 se usa para calcular cuál es el intervalo hash de una clave dada.
        • Mediante el uso de IP Address en la sección Instance Topology, puede conectarse al partición especificado.
        Figura 2 Obtención de las direcciones para conectarse a instancias de Clúster Redis DCS
        • En el ejemplo siguiente se utiliza la dirección IP de una instancia de DCS Redis. Cambie la dirección IP y el puerto según sea necesario.
          root@ecs-redis:~/redis-5.0.8/src# ./redis-cli -h 192.168.0.85 -p 6379 -a ****** -c
192.168.0.85:6379>
        • En el ejemplo siguiente se utiliza el nombre de dominio de una instancia de DCS para Redis. Cambie el nombre de dominio y el puerto según sea necesario.
          root@ecs-redis:~/redis-5.0.8/src# ./redis-cli -h redis-51e463c-dcs-lxy.dcs.huaweicloud.com -p 6379 -a ****** -c
redis-51e463c-dcs-lxy.dcs.huaweicloud.com:6379>
      2. Ejecute el siguiente comando para ver la información del nodo Clúster Redis:

        cluster nodes

        Cada partición de un Clúster Redis tiene un principal y una réplica por defecto. El comando de procedimiento proporciona toda la información de los nodos del clúster.

        192.168.0.85:6379> cluster nodes
0988ae8fd3686074c9afdcce73d7878c81a33ddc 192.168.0.231:6379@16379 slave f0141816260ca5029c56333095f015c7a058f113 0 1568084030
000 3 connected
1a32d809c0b743bd83b5e1c277d5d201d0140b75 192.168.0.85:6379@16379 myself,master - 0 1568084030000 2 connected 5461-10922
c8ad7af9a12cce3c8e416fb67bd6ec9207f0082d 192.168.0.130:6379@16379 slave 1a32d809c0b743bd83b5e1c277d5d201d0140b75 0 1568084031
000 2 connected
7ca218299c254b5da939f8e60a940ac8171adc27 192.168.0.22:6379@16379 master - 0 1568084030000 1 connected 0-5460
f0141816260ca5029c56333095f015c7a058f113 192.168.0.170:6379@16379 master - 0 1568084031992 3 connected 10923-16383
19b1a400815396c6223963b013ec934a657bdc52 192.168.0.161:6379@16379 slave 7ca218299c254b5da939f8e60a940ac8171adc27 0 1568084031
000 1 connected

        Las operaciones de escritura solo se pueden realizar en nodos principals. El algoritmo CRC16 (clave) mod 16384 se usa para calcular cuál es el intervalo hash de una clave dada.

        Como se muestra a continuación, el valor del CRC16 (KEY) mode 16384 determina el intervalo hash en el que está situada una clave dada y redirige al cliente al nodo en el que está situada el intervalo hash.

        192.168.0.170:6379> set hello world
-> Redirected to slot [866] located at 192.168.0.22:6379
OK
192.168.0.22:6379> set happy day
OK
192.168.0.22:6379> set abc 123
-> Redirected to slot [7638] located at 192.168.0.85:6379
OK
192.168.0.85:6379> get hello
-> Redirected to slot [866] located at 192.168.0.22:6379
"world"
192.168.0.22:6379> get abc
-> Redirected to slot [7638] located at 192.168.0.85:6379
"123"
192.168.0.85:6379>

Procedimiento (Windows)

Descargue el paquete de instalación del cliente Windows Redis. Descomprima el paquete, abra la herramienta CLI cmd.exe y vaya al directorio donde se guarda el paquete de instalación del cliente de Redis descomprimido. A continuación, ejecute el siguiente comando para acceder a la instancia de DCS Redis:

redis-cli -h XXX -p 6379

XXX indica la dirección IP/nombre de dominio de la instancia DCS y 6379 es un número de puerto de ejemplo usado para acceder a la instancia DCS. Para obtener más información sobre cómo obtener la dirección IP/nombre de dominio y el puerto, consulte Consulta de detalles de instancia. Cambie la dirección IP/nombre de dominio y el puerto según sea necesario.