redis-cli

Pré-requisitos

• Uma instância do DCS Redis foi criada e está no estado Running.
• Foi criado um ECS. Para obter detalhes sobre como criar um ECS, consulte Comprando um ECS .
• Se o ECS executar o SO de Linux, verifique se o ambiente de compilação GCC foi instalado no ECS.

Procedimento (Linux)

1. Visualize o endereço IP/nome do domínio e o número da porta da instância do DCS Redis a ser acessada.

   Para mais detalhes, consulte Exibindo Detalhes da Instância.

2. Para obter detalhes sobre como instalar o cliente redis-cli, consulte as instruções oficiais do Redis.

   As etapas a seguir pressupõem que seu cliente esteja instalado no SO de Linux.

   1. Acesse o ECS.
   2. Execute o seguinte comando para baixar o pacote de código-fonte do seu cliente Redis do http://download.redis.io/releases/redis-5.0.8.tar.gz:

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

   3. Execute o seguinte comando para descompactar o pacote de código-fonte do seu cliente Redis:

      tar -xzf redis-5.0.8.tar.gz

   4. Execute os seguintes comandos para ir para o diretório do Redis e compilar o código-fonte do seu cliente Redis:

      cd redis-5.0.8

      make

      cd src

3. Acesse a instância do DCS Redis.
   • Acessar uma instância de DCS de um tipo diferente do Cluster do Redis.
     Execute o procedimento a seguir para acessar uma instância do DCS Redis 3.0 ou uma instância do DCS Redis 4.0 ou 5.0 de cluster de nó único, principal/em espera ou proxy.

     1. Execute o seguinte comando para acessar a instância do DCS Redis escolhida:

        ./redis-cli -h {dcs_instance_address} -p 6379

        {dcs_instance_address} indica o endereço IP/nome de domínio da instância DCS e 6379 é a porta usada para acessar a instância. O endereço IP/nome do domínio e o número da porta são obtidos em 1.

        

        Para uma instância do Cluster de Proxy DCS Redis, você pode usar Connection Address ou IP Address para {dcs_instance_address}. Os endereços podem ser obtidos na página de informações básicas da instância no console, conforme mostrado na Figura 1.

        • Connection Address e IP Address são os endereços LB. As solicitações são distribuídas pelos nós proxy.
        • Você pode usar Backend Addresses para se conectar diretamente ao nó proxy especificado de uma instância do DCS Redis 3.0 de cluster de proxy.
        Figura 1 Obtendo os endereços para conexão a instâncias de DCS do Cluster de Proxy
        

        O exemplo a seguir usa o endereço de nome de domínio de uma instância do DCS Redis. Altere o nome de domínio e a porta conforme necessário.

        [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. Se você definiu uma senha para a instância do DCS, digite a senha nesta etapa. Você pode ler e gravar dados em cache somente depois que a senha for verificada.

        auth {password}

        {password} indica a senha usada para efetuar login na instância do DCS Redis escolhida. Essa senha é definida durante a criação da instância do DCS Redis.

        A saída do comando é a seguinte:

        redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379> auth *******
        OK
        redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379> 
   • Acesse uma instância de DCS do tipo Cluster do Redis.

     Execute o procedimento a seguir para acessar uma instância do DCS Redis 4.0 ou 5.0 no tipo de cluster do Redis.

     1. Execute o seguinte comando para acessar a instância do DCS Redis escolhida:

        ./redis-cli -h {dcs_instance_address} -p 6379 -a {password} -c

        {dcs_instance_address} indica o endereço IP/nome de domínio da instância do DCS Redis, 6379 é a porta usada para acessar a instância, {password} é a senha da instância, e -c é usado para acessar nós do Cluster do Redis. O endereço IP/nome do domínio e o número da porta são obtidos em 1.

        

        Você pode definir {dcs_instance_address} como Connection Address ou IP Address na seção Connection ou IP Address na seção Instance Topology. Os endereços podem ser obtidos na página de informações básicas da instância no console, conforme mostrado na Figura 2.

        • O campo IP Address fornece dois endereços IP. Você pode usar qualquer um deles para se conectar à instância. O algoritmo CRC16 (chave) mod 16384 é usado para calcular o que é o slot de hash de uma determinada chave.
        • Usando o IP Address na seção Instance Topology, você pode se conectar ao estilhaço especificado.
        Figura 2 Obtendo os endereços para conexão com uma instância de DCS do Cluster do Redis
        
        • O exemplo a seguir usa o endereço IP de uma instância do DCS Redis. Altere o endereço IP e a porta conforme necessário.

          root@ecs-redis:~/redis-5.0.8/src# ./redis-cli -h 192.168.0.85 -p 6379 -a ****** -c
          192.168.0.85:6379> 
        • O exemplo a seguir usa o nome de domínio de uma instância do DCS Redis. Altere o nome de domínio e a porta conforme necessário.

          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. Execute o seguinte comando para exibir as informações de nó do Cluster do Redis:

        cluster nodes

        Cada estilhaço em um cluster do Redis tem um principal e uma réplica por padrão. O comando procedente fornece todas as informações dos nós do cluster.

        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

        As operações de gravação só podem ser executadas em nós principais. O algoritmo CRC16 (chave) mod 16384 é usado para calcular qual é o slot de hash de uma determinada chave.

        Conforme mostrado a seguir, o valor do CRC16 (KEY) mode 16384 determina o hash slot em que uma determinada chave está localizada e redireciona o cliente para o nó em que o hash slot está localizado.

        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> 

Procedimento (Windows)

Download o pacote de instalação do cliente Windows Redis. Descompacte o pacote, abra a ferramenta CLI cmd.exe e vá para o diretório onde o pacote de instalação do cliente Redis descompactado foi salvo. Em seguida, execute o seguinte comando para acessar a instância do DCS Redis:

redis-cli -h XXX -p 6379

XXX indica o endereço IP/nome de domínio da instância DCS e 6379 é um número de porta de exemplo usado para acessar a instância DCS. Para obter detalhes sobre como obter o endereço IP/nome do domínio e a porta, consulte Exibindo Detalhes da Instância. Altere o endereço IP/nome do domínio e a porta conforme necessário.