更新时间:2023-08-26 GMT+08:00
分享

使用redis-cli连接Redis实例

介绍使用同一VPC内弹性云服务器ECS上的redis-cli连接Redis实例的方法,更多客户端的使用方法请参考Redis客户端

如果是公网访问Redis实例,请参考步骤三:连接Redis实例(Windows版)

  • Redis 3.0和6.0企业版不支持定义端口,端口固定为6379,Redis 4.0/5.0/6.0基础版支持定义端口,如果不自定义端口,则使用默认端口6379。本文操作步骤涉及实例端口时,统一以默认端口6379为例,如果已自定义端口,请根据实际情况替换。
  • 在使用redis-cli连接Cluster集群时,请注意连接命令是否已加上-c。在连接Cluster集群节点时务必正确使用连接命令,否则会出现连接失败的问题。
    • Cluster集群连接命令:

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

    • 单机、主备、Proxy集群连接命令:

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

    具体连接操作,请参考本章节的操作步骤。

  • 当Redis 6.0基础版实例开启了SSL时,需要配置SSL证书路径:
    • Cluster集群连接命令:

      ./redis-cli -h {dcs_instance_address} -p 6379 -a {password} -c --tls --cacert {certification file path}

    • 单机、主备、Proxy集群连接命令:

      ./redis-cli -h {dcs_instance_address} -p 6379 -a {password} --tls --cacert {certification file path}

    (通过SSL加密连接Redis时,请使用6.x及以上版本的redis-cli客户端)

前提条件

  • 已成功申请Redis实例,且状态为“运行中”。
  • 已创建弹性云服务器,创建弹性云服务器的方法,请参见创建弹性云服务器
  • 如果弹性云服务器为Linux系统,该弹性云服务器必须已经安装gcc编译环境。

操作步骤(Linux版)

  1. 查看并获取待连接Redis实例的IP地址/域名和端口。

    具体步骤请参见查看实例信息

  2. 安装redis-cli客户端。

    以下步骤以客户端安装在Linux系统上为例进行描述。

    1. 登录弹性云服务器。
    2. 执行以下命令,获取Redis客户端源码,下载路径为https://download.redis.io/releases/redis-6.2.13.tar.gz。

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

      此处以安装redis-6.2.13版本为例,您也可以安装其他版本。具体操作,请参见Redis官网

    3. 执行如下命令,解压Redis客户端源码包。

      tar -xzf redis-6.2.13.tar.gz

    4. 进入Redis目录并编译Redis客户端源码。

      cd redis-6.2.13

      make

      cd src

  3. 连接Redis实例。

    • 连接Redis非Cluster集群实例。
      如果是单机/主备/Proxy集群/读写分离实例,请执行以下操作。
      1. 执行以下命令连接Redis实例。

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

        其中{dcs_instance_address}为Redis实例的IP地址/域名,“6379”为Redis实例的端口。IP地址/域名和端口获取见1

        如果是Redis Proxy集群实例,{dcs_instance_address}可以为Redis实例的“连接地址”、“IP地址”,获取方法,在控制台单击实例名称进入实例详情页面即可查看,如图1所示。

        • “连接地址”和“IP地址”为负载均衡器地址,系统将请求分发到不同的Proxy节点上。
        • Redis 3.0 Proxy集群使用“后端服务地址”,可以连接到指定的Proxy节点。
        图1 获取Proxy集群实例连接地址

        以下以使用Redis实例的域名连接地址为示例,具体请根据实际情况修改:

        [root@ecs-redis redis-6.2.13]# 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. 如果Redis实例设置了密码访问,则执行本步骤输入密码,校验通过后才可进行缓存数据读写,免密访问的实例无需该步骤。

        auth {password}

        其中{password}为创建Redis实例时自定义的密码,请按实际情况修改后执行。

        密码访问回显示例如下:

        redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379> auth *******
        OK
        redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379> 
    • 连接Redis Cluster集群实例。

      如果是Cluster集群实例,请执行以下操作。

      1. 执行以下命令连接Redis实例。

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

        其中{dcs_instance_address}为Redis实例的IP地址/域名,“6379”为Redis实例的端口,{password}为Cluster集群实例的密码,-c连接集群节点时使用。IP地址/域名和端口获取见1

        • {dcs_instance_address}参数的值可以为Redis实例“连接地址”、“IP地址”、“实例拓扑”图中分片上的“节点连接地址”。获取方法,在控制台单击实例进入实例详情页面即可查看,如图2所示。
        • 如果实例已开启免密访问,则无需输入实例的访问密码 -a {password},如果忘记密码或需要重置密码请参考重置缓存实例密码
        • “IP地址”字段中提供了多个IP,任意一个IP地址均可用于连接实例,在连接时,任选其中一个IP连接,都表示可以连接上集群实例,在进行数据读写时,key存储在哪个slot中,由Crc16(key) mod 16384的值决定,推荐配置全部IP地址,可靠性更强。
        • 实例拓扑图中分片上的“节点连接地址”,可以直接连接到指定的分片。
        图2 获取Cluster集群实例连接地址
        • 以下以使用Redis实例的IP连接为示例,具体请根据实际情况修改:
          root@ecs-redis:~/redis-6.2.13/src# ./redis-cli -h 192.168.0.85 -p 6379 -a ****** -c
          192.168.0.85:6379> 
        • 以下以使用Redis实例的域名连接为示例,具体请根据实际情况修改:
          root@ecs-redis:~/redis-6.2.13/src# ./redis-cli -h redis-51e463c-dcs-lxy.dcs.huaweicloud.com -p 6379 -a ****** -c
          redis-51e463c-dcs-lxy.dcs.huaweicloud.com:6379> 
      2. 查看Cluster集群节点信息。

        cluster nodes

        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

        备节点只能进行只读操作,不能进行写操作。在进行数据写入时,key存储在哪个slot中,由Crc16(key) mod 16384的值决定。

        如下所示,数据写入时,根据Crc16(key) mod 16384的值决定key存储位置,并跳转到该slot所在的节点上。

        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> 

操作步骤(Windows版)

Windows版本的Redis客户端安装包,请单击这里下载编译包。下载后直接解压安装到自定义目录,然后使用cmd工具进入该目录,执行以下命令连接redis实例:

redis-cli.exe -h XXX -p 6379

其中:“XXX”为Redis实例的IP地址/域名,“6379”为Redis实例的端口。IP地址/域名和端口获取见查看实例信息,请按实际情况修改后执行。

连接Redis实例操作视频

如果需要详细了解连接redis实例的操作,请单击以下链接观看视频。

访问缓存实例操作视频

分享:

    相关文档

    相关产品