Codis分布式Redis集群部署与运维完全指南

嵇习柱Annabelle

于 2025-06-03 09:02:43 发布

阅读量381

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00334/article/details/148392181

Codis分布式Redis集群部署与运维完全指南

codis Proxy based Redis cluster solution supporting pipeline and scaling dynamically 项目地址: https://gitcode.com/gh_mirrors/co/codis

什么是Codis

Codis是一个分布式Redis解决方案，对于上层应用来说，连接Codis Proxy和连接原生的Redis Server没有明显区别。Codis底层会处理请求的转发、数据迁移等复杂操作，这些对客户端都是透明的。你可以简单地将Codis看作是一个拥有无限内存的Redis服务。

Codis核心组件架构

Codis 3.x版本由以下几个核心组件构成：

1. Codis Server

基于Redis 3.2.8分支开发，增加了slot相关操作和数据迁移指令的支持。主要特点：

兼容原生Redis协议
支持slot数据分片
提供数据迁移能力

2. Codis Proxy

客户端连接中转服务，实现了Redis协议。特点包括：

支持多实例部署
状态由Dashboard保证同步
部分命令不支持（如事务相关命令）

3. Codis Dashboard

集群管理工具，负责：

管理Proxy和Server的增删
处理slot迁移（支持同步/异步）
维护集群状态一致性
同一时间只能有0或1个Dashboard运行

4. Codis Admin

命令行管理工具，可以：

控制Proxy和Dashboard状态
访问外部存储

5. Codis FE

集群管理Web界面，特点：

支持多集群实例共享同一界面
从外部存储读取集群信息

6. 存储系统

保存集群元数据，提供：

Namespace概念隔离不同集群
支持Zookeeper/Etcd/文件系统等多种实现
提供扩展接口

快速搭建Codis集群

环境准备

方法一：使用预编译二进制包

最简单的方式是直接下载对应平台的预编译二进制包。

方法二：源码编译

需要Go 1.7+环境：

安装Go并配置环境变量
下载Codis源码到GOPATH指定目录
执行make命令编译

编译完成后会在bin目录生成以下可执行文件：

codis-dashboard
codis-proxy
codis-admin
codis-fe
codis-server

集群启动步骤

启动Dashboard

./admin/codis-dashboard-admin.sh start

检查日志确认无异常：

tail -100 ./log/codis-dashboard.log

启动Proxy
```
./admin/codis-proxy-admin.sh start
```
检查日志确认Proxy已注册到Dashboard。
启动Redis实例
```
./admin/codis-server-admin.sh start
```
默认端口6379，检查/tmp/redis_6379.log确认启动成功。
启动FE管理界面
```
./admin/codis-fe-admin.sh start
```
默认监听9090端口。

集群配置

添加Server Group
- 访问FE界面(127.0.0.1:9090)
- 在Group列点击"NEW GROUP"添加组
- 输入组ID（如1）并确认
添加Server到Group
- 在"Add Server"行输入Redis地址
- 选择目标Group
- 点击"Add Server"按钮
初始化Slot分配
- 新集群Slot状态为offline
- 点击"rebalance all slots"按钮自动分配1024个slot

生产环境部署建议

使用Ansible自动化部署

对于多机环境，推荐使用Ansible进行自动化部署：

安装Ansible
修改ansible/groups_var/all中的配置参数
在hosts文件中添加目标机器IP
执行playbook：
```
ansible-playbook -i hosts site.yml
```

高可用方案

Proxy高可用
- Proxy是无状态的，可以部署多个实例
- 客户端可使用Jodis（Java）或Nedis（基于Netty）实现自动发现和负载均衡
Server高可用
- 使用Redis Sentinel监控主从状态
- 自动进行故障转移（failover）
- 从节点自动切换到新主节点