Codis 3介绍
对于有好多种,基本常用的就是twemproxy,codis、redis cluster这三种解决方案,本人有幸工作中都大量使用过,各有利有弊,下面这篇文章详解讲解一下豌豆尖的Codis 3。由于业务中还使用有Codis 2,所以对于Codis 2也写了一篇文章。Codis总体来说还算不错,仅供大家学习和参考。
Codis是一个分布式Redis解决方案, 对于上层的应用来说, 连接到Codis Proxy和连接原生的Redis Server没有显著区别 (), 上层应用可以像使用单机的Redis一样使用, Codis 底层会处理请求的转发, 不停机的数据迁移等工作, 所有后边的一切事情, 对于前面的客户端来说是透明的, 可以简单的认为后边连接的是一个内存无限大的Redis服务。
Codis 3.x由以下组件组成:
• Codis Server:基于 redis-2.8.21 分支开发。增加了额外的数据结构,以支持 slot 有关的操作以及数据迁移指令。具体的修改可以参考文档 redis 的修改。
• Codis Proxy:客户端连接的Redis代理服务, 实现了Redis协议。 除部分命令不支持以外(不支持的命令列表),表现的和原生的Redis没有区别(就像Twemproxy)。
对于同一个业务集群而言,可以同时部署多个codis-proxy实例;
不同codis-proxy之间由codis-dashboard保证状态同步。
• Codis Dashboard:集群管理工具,支持codis-proxy、codis-serve的添加、删除,以及据迁移等操作。在集群状态发生改变时,codis-dashboard 维护集群下所有 codis-proxy的状态的一致性。
对于同一个业务集群而言,同一个时刻 codis-dashboard 只能有 0个或者1个;
所有对集群的修改都必须通过 codis-dashboard 完成。
• Codis Admin:集群管理的命令行工具。
可用于控制codis-proxy、codis-dashboard状态以及访问外部存储。
• Codis FE:集群管理界面。
多个集群实例共享可以共享同一个前端展示页面;
通过配置文件管理后端codis-dashboard列表,配置文件可自动更新。
• Codis HA:为集群提供高可用。
依赖codis-dashboard实例,自动抓取集群各个组件的状态;
会根据当前集群状态自动生成主从切换策略,并在需要时通过codis-dashboard完成主从切换。
• Storage:为集群状态提供外部存储。
提供Namespace概念,不同集群的会按照不同product name进行组织;
目前仅提供了Zookeeper和Etcd两种实现,但是提供了抽象的interface可自行扩展。
安装配置Codis 3集群
此次试验服务部署架构方式如下:
10.0.60.152 | zk、fe、dashboard、proxy、codis |
10.0.60.153 | zk、proxy、codis |
10.0.60.154 | zk、proxy、codis |
system:CentOS 7版本此次试验用到的软件及版本如下:
Jdk:1.8版本
Zookeeper:3.4版本()
Go:go1.5.2.Linux-amd64.tar.gz版本()
Codis:3.0.3版本()
安装参考文档:
1、安装配置zookeeper
Zookeeper分布式服务框架,是Apache Hadoop的一个子项目,它主要是用来解决分布式应用中经常遇到的一些数据管理问题,如:统一命名服务、状态同步服务、集群管理、分布式应用配置项的管理等。Codis依赖zookeeper才能协同工作。
首先安装开发工具及openjdk,zookeeper是由Java语言开发的,所以需要openjdk环境。
$ yum groupinstall "Development tools" "Compatibility libraries" -y$ yum install openssl-devel openssl -y$ yum install java-1.8.0-openjdk-devel java-1.8.0-openjdk -y$ yum install -y gcc make gcc-c++ automake lrzsz openssl-devel zlib-* bzip2-* readline* zlib-* bzip2-* git$ yum install -y nmap unzip wget lsof xz net-tools mercurial
确定Java运行环境正常
$ java -versionopenjdk version "1.8.0_101"OpenJDK Runtime Environment (build 1.8.0_101-b13)OpenJDK 64-Bit Server VM (build 25.101-b13, mixed mode)
安装二进制版本的zookeeper
$ tar xvf zookeeper-3.4.9.tar.gz -C /usr/local/$ ln -s /usr/localzookeeper-3.4.9/ /usr/local/zookeeper$ cd /usr/local/zookeeper/conf$ cp zoo_sample.cfg zoo.cfg
编译zookeeper配置文件/usr/local/zookeeper/conf/zoo.cfg
maxClientCnxns=60tickTime=2000initLimit=10syncLimit=5dataDir=/data/zookeeper/dbdataLogDir=/data/zookeeper/logclientPort=2181# cluster configureserver.1=10.0.60.152:2888:3888server.2=10.0.60.153:2888:3888server.3=10.0.60.154:2888:3888
$ mkdir /data/zookeeper/{db,log} -p
下面需要生成ID,这里需要注意,myid对应的zoo.cfg的server.ID,比如第二台zookeeper主机对应的myid应该是2,以此类推,三个主机分别为:其中2888表示zookeeper程序监听端口,3888表示zookeeper选举通信端口。
10.0.60.152$ echo 1 > /data/zookeeper/db/myid10.0.60.153$ echo 2 > /data/zookeeper/db/myid10.0.60.154$ echo 3 > /data/zookeeper/db/myid
然后输出环境变量。
$ export PATH=$PATH:/usr/local/zookeeper/bin/$ source /etc/profile
然后就可以启动zookeeper了。
$ zkServer.sh start
查看各个zookeeper节点的状态(会有一个leader节点,两个follower节点)。
[root@node1 ~]# zkServer.sh statusMode: follower[root@node2 ~]# zkServer.sh statusMode: leader[root@node3 ~]# zkServer.sh statusMode: follower
客户端连接,可以查看相关信息。
$ zkCli.sh -server 127.0.0.1:2181
至此,zookeeper已经搞定了。
2、go安装(codis是go语言写的,所以这些机器需要安装go环境)
首先下载go二进制安装包
官方界面介绍了如何,对于GO运行环境来说,有一些特定的GOROOT和GOPATH环境变量需要设置,这是必须的,不然无法运行go程序。这里最好安装go1.5.2版本,不然后面编译Codis有些小问题。
$ tar xvf go1.5.2.linux-amd64.tar.gz -C /usr/local
解压完成后,GO就安装完了,下面设置一个GOPATH目录,其实就是go程序运行目录。
$ mkdir /usr/local/codis
然后就可以设置GO需要的环境变量,路径看好,千万别搞错了。
$ cat /etc/profile.d/go.sh#!/bin/bash#export GOROOT=/usr/local/goexport GOPATH=/usr/local/codis/export PATH=$PATH:$GOROOT/bin
应用一下go.sh
$ chmod a+x /etc/profile.d/go.sh$ source /etc/profile.d/go.sh
查看GO版本
$ go versiongo version go1.5.2 linux/amd64
3、安装godep
Codis的编译使用了godep,如果没有安装的话就会报godep command not found的错误,godep是golang的一个包管理工具,类似于Python的pip。
$ mkdir -p $GOPATH/src/github.com/tools$ cd $GOPATH/src/github.com/tools$ go get -u github.com/tools/godep$ cd godep$ go install ./
其中go install ./命令会将godep执行程序生成到$GOPATH/bin下。
$ ll $GOPATH/bin-rwxr-xr-x. 1 root root 10329080 Oct 11 11:00 godep
然后将$GOPATH/bin加到/etc/profile.d/go.sh中,主要是引用godep命令:
$ cat /etc/profile.d/go.sh#!/bin/bash#export GOROOT=/usr/local/goexport GOPATH=/usr/local/codis/export PATH=$PATH:$GOROOT/binexport PATH=$GOROOT/bin:$GOPATH/bin:$PATH
$ source /etc/profile.d/go.sh
查看godep效果
$ which godep/usr/local/codis/bin/godep$ godep versiongodep v74 (linux/amd64/go1.5.2)
4、下载并编译安装codis 3
$ cd /root$ wget https://github.com/CodisLabs/codis/archive/3.0.3.zip$ unzip 3.0.3.zip$ mkdir /usr/local/codis/src/github.com/CodisLabs$ cp -fr ./codis-3.0.3/ /usr/local/codis/src/github.com/CodisLabs/codis$ cd /usr/local/codis/src/github.com/CodisLabs/codis$ make
编译完成后,查看一下Codis产生的文件。
$ lltotal 52drwxr-xr-x. 3 root root 4096 Oct 11 11:08 bindrwxr-xr-x. 7 root root 4096 Oct 11 11:05 cmddrwxr-xr-x. 5 root root 4096 Oct 11 11:05 doc-rw-r--r--. 1 root root 338 Oct 11 11:05 Dockerfiledrwxr-xr-x. 5 root root 4096 Oct 11 11:05 externdrwxr-xr-x. 3 root root 4096 Oct 11 11:06 Godeps-rw-r--r--. 1 root root 1352 Oct 11 11:05 Makefile-rw-r--r--. 1 root root 1076 Oct 11 11:05 MIT-LICENSE.txtdrwxr-xr-x. 6 root root 4096 Oct 11 11:05 pkg-rw-r--r--. 1 root root 2966 Oct 11 11:05 README.mddrwxr-xr-x. 2 root root 4096 Oct 11 11:05 scripts-rwxr-xr-x. 1 root root 418 Oct 11 11:05 version-rw-r--r--. 1 root root 1081 Oct 11 11:05 wandoujia_license.txt
输出Codis执行文件,添加最后一行PATH变量。在bin文件夹内生成codis-admin、codis-dashboard、codis-fe、codis-ha、codis-proxy、codis-server六个可执行文件。另外, bin/assets文件夹是codis-dashboard http服务需要的前端资源, 需要和codis-dashboard放置在同一文件夹下。
$ cat /etc/profile.d/go.sh#!/bin/bash#export GOROOT=/usr/local/goexport GOPATH=/usr/local/codis/export PATH=$PATH:$GOROOT/binexport PATH=$GOROOT/bin:$GOPATH/bin:$PATHexport PATH=$PATH:/usr/local/codis/src/github.com/CodisLabs/codis/bin/
$ source /etc/profile.d/go.sh
至此,Codis安装完成。但需要注意的是,如果你是用golang 1.5 beta3以上的版本进行编译,还有可能出现的一个问题是:
GOPATH=godep path godep restoreError: GO15VENDOREXPERIMENT is enabled and the vendor/ directory is not a valid Go workspace.godep: Error restore requires GOPATH but it is empty.make: *** [godep] Error 1
这是因为golang 1.5 beta3之后go添加了GO15VENDOREXPERIMENT这个特性,并在1.6版本就默认开启,你可以参照Codis issue715里面的方案解决。最简单就是在编译前
export GO15VENDOREXPERIMENT=0
Codis安装完成后,就可以为Codis创建一些标准的目录,用来存储Codis的脚本目录、配置文件目录、日志目录、PID目录、Redis配置目录等。
5、为Codis创建标准目录
$ mkdir -p /data/codis/sh$ mkdir -p /data/codis/conf$ mkdir -p /data/codis/log$ mkdir -p /data/codis/run$ mkdir -p /data/codis/redis/bin$ mkdir -p /data/codis/redis/redis-6379$ mkdir -p /data/codis/redis/redis-6380
复制Codis自带的redis-2.8.21相关工具到标准目录中。
$ cd /usr/local/codis/src/github.com/CodisLabs/codis/extern/redis-2.8.21/src/$ cp ./{redis-benchmark,redis-cli,redis-sentinel,redis-server} /data/codis/redis/bin/
添加环境变量
$ cat /etc/profile.d/go.sh#!/bin/bash#export GOROOT=/usr/local/goexport GOPATH=/usr/local/codis/export PATH=$PATH:$GOROOT/binexport PATH=$GOROOT/bin:$GOPATH/bin:$PATHexport PATH=$PATH:/usr/local/codis/src/github.com/CodisLabs/codis/bin/export PATH=$PATH:/data/codis/redis/bin
$ source /etc/profile.d/go.sh
6、配置启动Codis各组件—-启动Redis
考虑到性能,主库关闭aof和rdp,从库只开启aof即可。下面这份配置就是生产环境中的配置,具体的含义可以看本博客的章节。
主库:/data/codis/redis/redis-6379/redis.conf
###基本参数###daemonize yespidfile /data/codis/run/redis-6379.pidport 6379tcp-backlog 65535bind 0.0.0.0timeout 0tcp-keepalive 0loglevel noticelogfile "/data/codis/log/redis-6379.log"databases 16lua-time-limit 5000maxclients 10000###慢日志参数###slowlog-log-slower-than 10000slowlog-max-len 128###内存参数###maxmemory 3Gmaxmemory-policy noeviction###RDB持久化参数####save 3600 1#stop-writes-on-bgsave-error yes#rdbcompression yes#rdbchecksum yes#dbfilename dump.rdb###AOF持久化参数####no-appendfsync-on-rewrite yes#appendonly yes#appendfilename "appendonly.aof"#appendfsync no#auto-aof-rewrite-min-size 512mb#auto-aof-rewrite-percentage 100#aof-load-truncated yes#aof-rewrite-incremental-fsync yes###客户端Buffer参数###client-output-buffer-limit normal 0 0 0client-output-buffer-limit slave 256mb 64mb 60client-output-buffer-limit pubsub 32mb 8mb 60###其他参数###hash-max-ziplist-entries 512hash-max-ziplist-value 64list-max-ziplist-entries 512list-max-ziplist-value 64set-max-intset-entries 512zset-max-ziplist-entries 128zset-max-ziplist-value 64hll-sparse-max-bytes 3000activerehashing yeslatency-monitor-threshold 0###安全参数####requirepass 123456789
从库:/data/codis/redis/redis-6380/redis.conf
###基本参数###daemonize yespidfile /data/codis/run/redis-6380.pidport 6380tcp-backlog 65535bind 0.0.0.0timeout 0tcp-keepalive 0loglevel noticelogfile "/data/codis/log/redis-6380.log"databases 16lua-time-limit 5000maxclients 10000###慢日志参数###slowlog-log-slower-than 10000slowlog-max-len 128###内存参数###maxmemory 3Gmaxmemory-policy noeviction###RDB持久化参数####save 3600 1#stop-writes-on-bgsave-error yes#rdbcompression yes#rdbchecksum yes#dbfilename dump.rdb###AOF持久化参数###no-appendfsync-on-rewrite yesappendonly yesappendfilename "appendonly.aof"appendfsync noauto-aof-rewrite-min-size 512mbauto-aof-rewrite-percentage 100aof-load-truncated yesaof-rewrite-incremental-fsync yes###客户端Buffer参数###client-output-buffer-limit normal 0 0 0client-output-buffer-limit slave 256mb 64mb 60client-output-buffer-limit pubsub 32mb 8mb 60###其他参数###hash-max-ziplist-entries 512hash-max-ziplist-value 64list-max-ziplist-entries 512list-max-ziplist-value 64set-max-intset-entries 512zset-max-ziplist-entries 128zset-max-ziplist-value 64hll-sparse-max-bytes 3000activerehashing yeslatency-monitor-threshold 0###安全参数####requirepass 123456789
可以使用codis-server启动redis了。
$ codis-server /data/codis/redis/redis-6379/redis.conf$ codis-server /data/codis/redis/redis-6380/redis.conf
7、配置启动Codis各组件—-启动dashboard(集群中某一个节点)
首先生成默认的配置文件:
$ codis-dashboard --default-config | tee /data/codis/conf/dashboard.toml
修改配置文件参数如下:
# Set Coordinator, only accept "zookeeper" & "etcd"coordinator_name = "zookeeper"coordinator_addr = "10.0.60.152:2181,10.0.60.153:2181,10.0.60.154:2181"# Set Codis Product {Name/Auth}.product_name = "codis-demo"product_auth = ""# Set bind address for admin(rpc), tcp only.admin_addr = "0.0.0.0:18080"
配置文件参数说明:
coordinator_name:外部存储类型,接受zookeeper/etcd,这里我们使用的zookeeper集群。coordinator_addr:外部存储地址。
product_name:集群名称,满足正则\w[\w\.\-]*。
product_auth:集群密码,默认为空。
admin_addr:RESTful API端口。
启动dashboard
$ nohup codis-dashboard --ncpu=2 --config=/data/codis/conf/dashboard.toml --log=/data/codis/log/dashboard.log --log-level=WARN &
参数解释:
–ncpu=N:最大使用CPU个数。
-c CONF, –config=CONF:指定启动配置文件。
-l FILE, –log=FILE:设置log输出文件。
–log-level=LEVEL:设置log输出等级:INFO,WARN,DEBUG,ERROR,默认INFO,推荐WARN。
PS:dashboard只需要在一个节点启动即可,启动时会向zookeeper注册信息(topom),如果有其他节点也启动dashboard时,向zookeeper注册信息发现里面有信息时,就会无法启动的。另外,如果dashboard异常退出,请看后面的异常处理案例。
8、配置启动Codis各组件—-启动codis-proxy(集群中所有节点)
首先生成默认的配置文件:
$ codis-proxy --default-config | tee /data/codis/conf/proxy.toml
修改配置文件参数如下:
product_name = "codis-demo"product_auth = ""admin_addr = "0.0.0.0:11080"proto_type = "tcp4"proxy_addr = "0.0.0.0:19000"#jodis_addr = "10.0.60.152:2181,10.0.60.153:2181,10.0.60.154:2181"jodis_addr = ""jodis_timeout = 10backend_ping_period = 5session_max_timeout = 1800session_max_bufsize = 131072session_max_pipeline = 1024session_keepalive_period = 60
配置文件参数介绍:
product_name:产品名称, 这个codis集群的名字, 可以认为是命名空间, 不同命名空间的codis没有交集。product_auth:集群密码,默认为空。Codis 3.x支持AUTH,但是要求所有组件使用的AUTH必须完全相同。
admin_addr:RESTful API端口。
proto_type:Redis端口类型,接受tcp/tcp4/tcp6/unix/unixpacket。
proxy_addr:Redis端口地址或者路径。
jodis_addr:Jodis注册zookeeper地址。
jodis_timeout:Jodis注册session timeout时间,单位second。
backend_ping_period:与codis-server探活周期,单位second,0表示禁止。
session_max_timeout:与client连接最大读超时,单位second,0表示禁止。
session_max_bufsize:与client连接读写缓冲区大小,单位byte。
session_max_pipeline:与client连接最大的pipeline大小。
session_keepalive_period:与client的tcp keepalive周期,仅tcp有效,0表示禁止。
启动codis-proxy
$ nohup codis-proxy --ncpu=2 --config=/data/codis/conf/proxy.toml --log=/data/codis/log/proxy.log --log-level=WARN &
-c CONF, –config=CONF:指定启动配置文件。
–ncpu=N:最大使用CPU个数。
-l FILE, –log=FILE:设置log输出文件。
–log-level=LEVEL:设置log输出等级:INFO,WARN,DEBUG,ERROR;默认INFO,推荐WARN。
–ulimit=NLIMIT:检查ulimit -n的结果,确保运行时最大文件描述不少于NLIMIT。
codis-proxy启动后,处于waiting状态,监听proxy_addr地址,但是不会accept连接,添加到集群并完成集群状态的同步,才能改变状态为online。添加的方法有以下两种:
第一种:通过codis-fe添加,通过Add Proxy按钮,将admin_addr加入到集群中,如下图(具体操作要等到后面codis-fe启动后才可以):
第二种:通过codis-admin命令行工具添加,方法如下(添加3个proxy):
$ codis-admin --dashboard=10.0.60.152:18080 --create-proxy -x 10.0.60.152:11080$ codis-admin --dashboard=10.0.60.152:18080 --create-proxy -x 10.0.60.153:11080$ codis-admin --dashboard=10.0.60.152:18080 --create-proxy -x 10.0.60.154:11080
1)获取proxy信息,对集群name以及auth进行验证,并将其信息写入到外部存储中;其中–dashboard需要指定codis-dashboard的管理地址,–create-proxy指定为和codis-proxy的admin_addr地址,。添加过程中,codis-dashboard会完成如下一系列动作:
2)同步slots状态;
3)标记proxy状态为online,此后proxy开始accept连接并开始提供服务;
PS:在添加codis-proxy的时候需要特别注意,这个地方容易出现各种问题,最好能一次性添加成功,不然就需要删除zookeeper数据了,然后重新开始。还有一点需要注意的是,测试中发现一旦删除掉某个proxy后,再次添加就会报错。
9、配置启动Codis各组件—-启动codis-fe(可选组件)
首先生成默认的配置文件,配置文件codis.json可以手动编辑,也可以通过codis-admin从外部存储(这里是zookeeper)中拉取,如下操作:
$ codis-admin --dashboard-list --zookeeper=127.0.0.1:2181 | tee /data/codis/conf/codis.json
拉去的配置文件信息:
$ cat /data/codis/conf/codis.json[ { "name": "codis-demo", "dashboard": "10.0.60.152:18080" }]
启动codis-fe,注意启动codis-fe的时候,必须要使用codis-fe的全路径进行启动,因为codis-fe需要找到前端静态文件,也就是要找到/usr/local/codis/src/github.com/CodisLabs/codis/bin/assets目录。
$ nohup `which codis-fe` --ncpu=2 --log=/data/codis/log/fe.log --log-level=WARN --dashboard-list=/data/codis/conf/codis.json \--listen=0.0.0.0:8080 &
10、添加Redis Server Group(在集群中一台服务器上操作即可,也可以在面板图形界面操作)
web监控端口是801端口,我们可以在浏览器打开http://10.0.60.152:8080看看图形化界面。
首先使用codis-admin工具创建组,按照上面的规划的,我们创建2个组即可:
$ codis-admin --dashboard=10.0.60.152:18080 --create-group --gid=1$ codis-admin --dashboard=10.0.60.152:18080 --create-group --gid=2
然后使用codis-admin工具给组添加Redis主机(2个主机为一个组):
$ codis-admin --dashboard=10.0.60.152:18080 --group-add --gid=1 --addr=10.0.60.152:6379$ codis-admin --dashboard=10.0.60.152:18080 --group-add --gid=1 --addr=10.0.60.154:6379
$ codis-admin --dashboard=10.0.60.152:18080 --group-add --gid=2 --addr=10.0.60.153:6380$ codis-admin --dashboard=10.0.60.152:18080 --group-add --gid=2 --addr=10.0.60.154:6380
把从库跟主库同步:
$ codis-admin --dashboard=10.0.60.152:18080 --sync-action --create --addr=10.0.60.154:6379$ codis-admin --dashboard=10.0.60.152:18080 --sync-action --create --addr=10.0.60.154:6380
若slave需要提升为master,操作如下:需要注意的是如果当从库运行一段时间后挂掉了,那么重新启动后需要人为手动地将主从进行同步,执行上面的命令即可,或者图形界面操作(反之,如果主库挂了,马上又好了,这时候从库会自动重新连接上的,不需要人为干预)。
$ codis-admin --dashboard=10.0.60.152:18080 --promote-server --gid=1 --addr=10.0.60.154:6379
11、初始化slots并设置server group服务的slot 范围(在集群中一台服务器上操作即可,也可以在面板图形界面操作)
注意的是,当从库提升为主库后,那么原来的主库就会掉线,如果想把它作为现在主库的从库,还是需要人为干预的,因为这个涉及到数据安全性的问题。
Codis采用Pre-sharding的技术来实现数据的分片, 默认分成1024个slots (0-1023),对于每个key来说,通过以下公式确定所属的Slot Id : SlotId = crc32(key) %1024。每一个slot都会有一个且必须有一个特定的server group id来表示这个slot的数据由哪个server group来提供。
$ codis-admin --dashboard=10.0.60.152:18080 --slot-action --create-range --beg=0 --end=511 --gid=1$ codis-admin --dashboard=10.0.60.152:18080 --slot-action --create-range --beg=512 --end=1023 --gid=2
至此,一个简单的集群就搭建完成了。但是此时redis虽然能够很好地进行切换了。但是是需要人为切换,如果想做到自动切换,那么还需要Codis的另一个组件codis-ha。
12、配置启动Codis各组件—-启动codis-ha(可选组件)
codis-ha --log=/data/codis/log/ha.log --log-level=WARN --interval=3 --dashboard=127.0.0.1:18080 &
注意:Codis HA工具仅仅是Codis集群HA的一部分,单独工作能力有限。工作原理:
默认以5s(–interval是调整时间间隔的)为周期,codis-ha会从codis-dashboard中拉取集群状态,并进行主从切换;
codis-ha在以下状态下会退出:
1、从codis-dashboard获取集群状态失败时;
2、向codis-dashboard发送主从切换指令失败时;
codis-ha在以下状态下不会进行主从切换:
1、存在proxy状态异常:
因为提升主从需要得到所有proxy的确认,因此必须确保操作时所有proxy都能正常响应操作指令;
2、网络原因造成的master异常:
若存在slave满足slave.master_link_status == up,通常可以认为master并没有真的退出,而是由于网络原因或者响应延迟造成的master状态获取失败,此时codis-ha不会对该group进行操作;
3、没有满足条件的slave时:
提升过程会选择满足slave.master_link_status == down,并且slave.master_link_down_since_seconds最小的进行操作。这就要求被选择的slave至少在过去一段时间内与master是成功同步状态,这个时间间隔是2d+5,其中d是codis-ha检查周期默认5秒。
注意:因此,应用codis-ha时还需要结合对codis-proxy和codis-server的可用性监控,否则codis-ha无法保证可靠性。
PS:当codis-ha启动后,你可以测试关掉redis master,看看redis slave是否马上会成为主节点。
最后来看一下配置完成后的web界面是什么样子?
在此界面中也可以进行,组创建、将redis加入到组、删除redis主机、设置主从同步、将从节点提升为主节点、初始化slot等等。并且还可以看见OPS、内存、key等性能情况。另外可以在web界面进行slot迁移的操作,具体可以自行多试验试验。
13、测试Codis
连接codis-proxy代理端口即可,然后操作redis命令。
$ redis-cli -h 10.0.60.152 -p 19000127.0.0.1:19000> set k1 v1OK
Zookeeper相关操作
查看zk中codis产品:
$ zkCli.sh -server 127.0.0.1:2181[zk: 127.0.0.1:2181(CONNECTED) 1] ls /codis3/codis-demo/proxy slots topom group
查看zk中的dashboard信息:
[zk: 127.0.0.1:2181(CONNECTED) 2] get /codis3/codis-demo/topom{ "start_time": "2016-10-13 18:09:21.802793218 +0800 CST", "admin_addr": "10.0.60.152:18080", "product_name": "codis-demo", "pid": 3386, "pwd": "/usr/local/codis/src/github.com/CodisLabs/codis/extern/redis-2.8.21/src", "sys": "Linux"}
查看zk中的slot状态:
[zk: 127.0.0.1:2181(CONNECTED) 3] ls /codis3/codis-demo/slots
前面initslots初始化的所有Slot都保存在slots路径下,每个Slot是一个结点。随便选取一个Slot结点,用get命令能够查看结点上附着的数据:
[zk: 127.0.0.1:2181(CONNECTED) 4] get /codis3/codis-demo/slots/slot-0334{ "id": 334, "group_id": 1, "action": {}}
查询zk中的server状态:
[zk: 127.0.0.1:2181(CONNECTED) 5] get /codis3/codis-demo/group/group-0001{"id": 1,"servers": [{"server": "10.0.60.152:6379","action": {}},{"server": "10.0.60.154:6379","action": {"state": "synced"}}],"promoting": {}}
查询zk中的proxy状态:
[zk: 127.0.0.1:2181(CONNECTED) 6] ls /codis3/codis-demo/proxy/proxy-proxy-919ce168362a7286e4081b600a00ca67 proxy-cdcec3cebe703a67688bb0fc3de21f76proxy-b87c96f0bc6d8e62f196369c66cea7c2
[zk: 127.0.0.1:2181(CONNECTED) 7] get /codis3/codis-demo/proxy/proxy-919ce168362a7286e4081b600a00ca67{"id": 1,"token": "919ce168362a7286e4081b600a00ca67","start_time": "2016-10-13 19:55:09.532570818 +0800 CST","admin_addr": "10.0.60.152:11080","proto_type": "tcp4","proxy_addr": "10.0.60.152:19000","product_name": "codis-demo","pid": 4532,"pwd": "/usr/local/codis/src/github.com/CodisLabs/codis/extern/redis-2.8.21/src","sys": "Linux"}
要是想系统重做,删除此产品即可:rmr /codis3/codis_demo。
Codis常见问题修复
使用codis-admin命令行管理工具进行修复。
1)codis-dashboard异常退出的修复
当codis-dashboard启动时,会在外部存储上存放一条数据,用于存储 dashboard 信息,同时作为LOCK存在。当codis-dashboard安全退出时,会主动删除该数据。
当codis-dashboard异常退出时(大多数情况zookeeper连接异常时会异常退出),由于之前LOCK未安全删除,重启往往会失败。因此codis-admin提供了强制删除工具:
1、确认codis-dashboard进程已经退出(很重要);
2、然后运行codis-admin删除LOCK:
codis-admin --remove-lock --product=codis_demo --zookeeper=127.0.0.1:2181
或者删除topom
[zk: 127.0.0.1:2181(CONNECTED) 13] rmr /codis3/codis-demo/topom
正常关闭codis-dashboard:
codis-admin --dashboard=10.0.60.152:18080 --shutdown
2)codis-proxy异常退出的修复
通常codis-proxy都是通过codis-dashboard进行移除,移除过程中codis-dashboard为了安全会向codis-proxy发送offline指令,成功后才会将proxy 信息从外部存储中移除。如果codis-proxy异常退出,该操作会失败。此时可以使用codis-admin工具进行移除:
1、确认codis-proxy进程已经退出(很重要);
2、运行codis-admin删除proxy,首先查看proxy状态:
codis-admin --dashboard=10.0.60.152:18080 --proxy-status
或用
codis-admin --dashboard=10.0.60.152:18080 --list-proxy
根据查看到的信息,强制删除报错的codis-proxy。
codis-admin --dashboard=10.0.60.152:18080 --remove-proxy --token=6a2db3c9ac07ba8857d4bc79ca6d191c --force
codis-admin --dashboard=10.0.60.152:18080 --remove-proxy --addr=127.0.0.1:11080 --force
选项–force表示,无论offline操作是否成功,都从外部存储中将该节点删除。所以操作前,一定要确认该codis-proxy进程已经退出。
codis-proxy正常关闭
codis-admin --proxy=10.0.60.152:11080 --auth="xxxxx" --shutdown
3)jodis连接proxy显示Proxy list is empty问题处理
参考:
codis数据迁移
安全和透明的数据迁移是Codis提供的一个重要的功能,也是Codis区别于Twemproxy等静态的分布式Redis解决方案的地方。
数据迁移的最小单位是key,我们在codis redis中添加了一些指令,实现基于key的迁移,如SLOTSMGRT等 (命令列表),每次会将特定slot一个随机的key 发送给另外一个codis redis实例,这个命令会确认对方已经接收,同时删除本地的这个k-v 键值,返回这个slot的剩余key的数量,整个操作是原子的。
迁移的过程对于上层业务来说是安全且透明的,数据不会丢失,上层不会中止服务。
注意,迁移的过程中打断是可以的,但是如果中断了一个正在迁移某个slot的任务,下次需要先迁移掉正处于迁移状态的slot,否则无法继续 (即迁移程序会检查同一时刻只能有一个slot处于迁移状态)。
codis-proxy高可用问题?
因为codis-proxy是无状态的,可以比较容易的搭多个实例,达到高可用性和横向扩展。对Java用户来说,可以使用基于Jedis的实现Jodis,来实现proxy层的HA:
- 它会通过监控zookeeper上的注册信息来实时获得当前可用的proxy列表,既可以保证高可用性;
- 也可以通过轮流请求所有的proxy实现负载均衡。
对于其他语言,可以使用haproxy代理到后端的多个codis-proxy,达到负载均衡的作用。而haproxy的单点问题可以使用keepalive做HA,这样就可以实现一个高可用高并发的codis-proxy了。
codis-dashboard高可用问题?
Codis Dashboard:集群管理工具,支持codis-proxy、codis-serve的添加、删除,以及数据迁移等操作。在集群状态发生改变时,codis-dashboard 维护集群下所有codis-proxy的状态的一致性。
但需要注意的是对于同一个业务集群而言,同一个时刻codis-dashboard只能有0个或者1个。另外所有对集群的修改都必须通过codis-dashboard完成。由于本身的限制,codis-dashboard无法做到高可用。也就是说如果你集群中的codis-dashboard挂掉了,那么你将无法对集群做出更改操作,另外你的codis-fe界面也会异常(获取不到数据),但值得庆幸的是此时你的codis-集群对外服务不会出现任何问题。你需要做的就是去集群中的其他节点开启codis-dashboard即可,此时会重新去zookeeper中注册信息,集群操作不会有任何问题,所以也不必太担心codis-dashboard挂掉了,只需要做好监控及时报警即可。
另外,此时的codis-fe需要更改一下配置文件,也就是把codis-dashboard的地址更换为新的codis-dashboard主机即可;然后重新启动codis-fe,此时整个codis集群又恢复了最初的完整性,期间不会对客户端连接造成任何影响。
Redis高可用问题?
对下层的redis实例来说,当一个group的master挂掉的时候,应该让管理员清楚,并手动的操作,因为这涉及到了数据一致性等问题(redis的主从同步是最终一致性的)。因此codis不会自动的将某个slave升级成master。关于外部codis-ha工具(具体可以参考之前的章节),这是一个通过codis-dashboard开放的RESTful API实现自动切换主从的工具。该工具会在检测到master挂掉的时候主动应用主从切换策略,提升单个slave成为新的master。
需要注意,codis将其中一个slave升级为master时,该组内其他slave实例是不会自动改变状态的,这些slave仍将试图从旧的master上同步数据,因而会导致组内新的master和其他slave之间的数据不一致。因此当出现主从切换时,需要管理员手动创建新的sync action来完成新master与slave之间的数据同步(codis-ha不提供自动操作的工具,因为这样太不安全了)。
codis-fe安全问题?
默认情况下,codis-fe图形化界面没有任何安全措施,任何人只要知道地址都可以登录操作codis集群。此时你可以借助nginx/Apache的访问控制来进行codis-fe访问控制。提高codis-fe安全性。
Codis相关脚本
标准多codis实例目录
# proxy_19000;$ mkdir -p /data/codis/proxy_19000/bash$ mkdir -p /data/codis/proxy_19000/conf$ mkdir -p /data/codis/proxy_19000/log$ mkdir -p /data/codis/proxy_19000/run# proxy_19001;$ mkdir -p /data/codis/proxy_19001/bash$ mkdir -p /data/codis/proxy_19001/conf$ mkdir -p /data/codis/proxy_19001/log$ mkdir -p /data/codis/proxy_19001/run
然后在各自的实例的/data/codis/proxy_19001/bash/目录下添加以下脚本即可。
1、start_dashboard.sh#!/bin/bash#nohup codis-dashboard --ncpu=2 --config=../conf/dashboard.toml --log=../log/dashboard.log --log-level=WARN &
2、add_group.sh
#!/bin/bash## create group;codis-admin --dashboard=10.0.60.152:18080 --create-group --gid=1codis-admin --dashboard=10.0.60.152:18080 --create-group --gid=2# add host;codis-admin --dashboard=10.0.60.152:18080 --group-add --gid=1 --addr=10.0.60.152:6379codis-admin --dashboard=10.0.60.152:18080 --group-add --gid=1 --addr=10.0.60.154:6379codis-admin --dashboard=10.0.60.152:18080 --group-add --gid=2 --addr=10.0.60.153:6380codis-admin --dashboard=10.0.60.152:18080 --group-add --gid=2 --addr=10.0.60.154:6380# configuration maser/slave;codis-admin --dashboard=10.0.60.152:18080 --sync-action --create --addr=10.0.60.154:6379codis-admin --dashboard=10.0.60.152:18080 --sync-action --create --addr=10.0.60.154:6380
3、start_proxy.sh
#!/bin/bash#nohup codis-proxy --ncpu=2 --config=../conf/proxy.toml --log=../log/proxy.log --log-level=WARN &
4、start_fe.sh
#!/bin/bash#nohup `which codis-fe` --ncpu=2 --log=../log/fe.log --log-level=WARN --dashboard-list=../conf/codis.json --listen=0.0.0.0:8080 &
5、initslot.sh
codis-admin --dashboard=10.0.60.152:18080 --slot-action --create-range --beg=0 --end=511 --gid=1codis-admin --dashboard=10.0.60.152:18080 --slot-action --create-range --beg=512 --end=1023 --gid=2
注意按照顺序依次启动即可。由于codis一旦跟zookeeper连接出现异常后codis-proxy就会异常退出,所以需要写一个计划任务监控脚本当codis_proxy异常退出时就报警并且自动拉起来。
#!/bin/bashIP=10.0.60.152PORT="19000 190001"TIME=`date +%Y-%m-%d-%H-%M`for port in $PORT;dops aux | grep -v grep | grep $port | grep codis-proxy &> /dev/nullret=$?if [ $ret -eq 0 ]; then echo "$TIME codis ${IP}:${port} is exist !" >> /data/codis/proxy_${port}/log/codis.logelse msg="$TIME codis ${IP}:${port} is down!" /usr/bin/curl http://10.0.8.51:8888/sms/send -d "from=1000&to=15210491149&msg=$msg" echo "$TIME codis ${IP}:${port} is not exist !" >> /data/codis/proxy_${port}/log/codis.log cd /data/codis/proxy_${port}/bash sh start_proxy.sh > /dev/null 2>&1 sleep 2 sh set_proxy_online.sh > /dev/null 2>&1 sleep 2fidone
完结。
为了方便大家交流,本人开通了微信公众号(关注看更多精彩)和QQ群,QQ群1(291519319)和QQ群2(659336691)。喜欢技术的一起来交流吧