Redis-cli客户端连接Redis

本章节介绍使用redis-cli客户端连接Redis实例的方法，更多客户端的使用方法请参考Redis客户端。

以下操作以通过弹性云服务器上的客户端连接Redis实例为例进行说明。

如果是公网访问Redis 3.0实例，请参考Redis-cli客户端公网连接Redis 3.0。

前提条件

已成功创建Redis实例，且状态为“运行中”。创建Redis实例的操作请参考购买Redis实例。
已创建弹性云服务器，创建弹性云服务器的方法，请参见购买弹性云服务器。
如果弹性云服务器为Linux系统，该弹性云服务器必须已经安装gcc编译环境。
如果ECS未安装gcc编译环境，请执行以下命令进行安装：
```
yum install -y make
yum install -y pcre-devel
yum install -y zlib-devel
yum install -y libevent-devel
yum install -y openssl-devel
yum install -y gcc-c++
```
连接实例前确保客户端与Redis实例之间网络互通，具体请参考连接Redis网络要求。

Redis-cli客户端连接Redis（Linux版）

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

请参考查看实例信息，获取实例信息中的“连接地址”或“IP地址”，如图1。关于使用域名地址（连接地址）还是IP地址连接实例，请参考应该选择域名还是IP地址连接Redis实例？。

当客户端公网访问Redis时，请参考开启Redis 4.0/5.0/6.0公网访问并获取公网访问地址，获取实例公网访问地址及端口。

图1 获取实例连接地址
- 本文操作步骤涉及实例端口时，统一以6379为例，连接实例时请根据实际情况替换。
- Redis 4.0及以上版本的Proxy集群实例，“连接地址”和“IP地址”为负载均衡器地址，系统将请求分发到不同的Proxy节点上。
- Redis 3.0 Proxy集群使用“后端服务地址”，可以连接到指定的Proxy节点。
安装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
```
  如果编译的Redis源码为6.0及以上版本，且需要使用支持TLS/SSL的redis-cli，请将以上命令中的make替换为make BUILD_TLS=yes开启TLS。
连接Redis实例。
- 连接Redis非Cluster集群实例。
  如果是单机/主备/Proxy集群/读写分离实例，请执行以下操作。
  1. 执行以下命令连接Redis实例。
```
./redis-cli -h {dcs_instance_address} -p {port}
```
    其中{dcs_instance_address}为Redis实例的IP地址/域名，{port}为连接Redis实例的端口。IP地址/域名和端口获取见1。
    
    以下以使用Redis实例的域名连接地址为示例，具体连接地址和端口请根据实际情况修改：
```
[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 {port} -a {password} -c
```
    其中，{dcs_instance_address}为Redis实例的IP地址/域名，{port}为Redis实例的端口，{password}为Cluster集群实例的密码，-c为连接集群节点时使用。IP地址/域名和端口获取见1。
    在使用redis-cli连接Cluster集群时，请注意连接命令是否已加上-c。在连接Cluster集群节点时务必正确使用连接命令，否则会出现连接失败的问题。
    
    客户端通过内网连接Redis时，{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 nodes查看Cluster集群节点信息。
    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> 
```
当Redis 6.0基础版实例开启了SSL时，需要配置SSL证书路径：
- Cluster集群连接命令：
  ./redis-cli -h {dcs_instance_address} -p {port} -a {password} -c --tls --cacert {certification file path}
- 单机、主备连接命令：
  ./redis-cli -h {dcs_instance_address} -p {port} -a {password} --tls --cacert {certification file path}
（通过SSL加密连接Redis时，请使用6.x及以上版本的redis-cli客户端）