文档首页/ 分布式缓存服务 DCS/ 用户指南/ 迁移实例数据/ 自建Redis迁移至DCS/ 使用RedisShake工具在线迁移自建Redis Cluster集群
更新时间:2024-12-16 GMT+08:00

使用RedisShake工具在线迁移自建Redis Cluster集群

RedisShake是一款开源的Redis迁移工具,支持Cluster集群的在线迁移与离线迁移(备份文件导入)。DCS Cluster集群与Redis Cluster集群设计一致,数据可平滑迁移。

本文以Linux系统环境为例,介绍如何使用RedisShake工具将自建的Redis Cluster集群在线迁移到DCS Cluster集群。

约束与限制

  • 使用RedisShake工具将自建的Redis Cluster在线迁移到DCS Cluster集群,需要源Redis与目标Redis网络连通,或者通过一台中转云服务器连通两端的Cluster集群实例。
  • 开启了SSL的目标实例不支持数据迁移,需要关闭目标实例SSL后再进行迁移,开启或关闭SSL的操作请参考配置Redis SSL数据加密传输

前提条件

  • 如果您还没有目标Redis,请先创建目标Redis,具体操作请参考购买Redis实例
  • 如果您已有目标Redis,则不需要重复创建,为了对比迁移前后数据及预留足够的内存空间,建议在数据迁移之前清空目标实例数据,清空操作请参考清空Redis实例数据。如果没有清空实例数据,数据迁移后,目标Redis与源Redis实例重复的数据迁移后会被覆盖,源Redis没有、目标Redis有的数据会保留。
  • 已创建弹性云服务器ECS,创建弹性云服务器的方法,请参见创建弹性云服务器

    ECS请选择与DCS Cluster集群实例相同虚拟私有云、子网和安全组,并且需要绑定弹性公网IP。

  • 自建的源Redis Cluster集群如果是在本地或者其他云厂商的服务器上自建,需要允许被公网访问。

获取源Redis和目标Redis节点信息

  1. 分别连接源端和目标端Redis。连接Redis的方法请参考Redis-cli客户端连接Redis
  2. 在线迁移Cluster集群时需要将Cluster集群各个节点数据分别迁移。执行如下命令分别查询源端和目标Cluster集群的所有节点的IP地址与端口:
    redis-cli -h {redis_address} -p {redis_port} -a {redis_password} cluster nodes

    {redis_address}为Redis的连接地址,{redis_port}为Redis的端口,{redis_password}为Redis的连接密码。

    在命令返回的结果中,获取所有master节点的IP端口,如下如所示:

配置RedisShake工具

  1. 登录弹性云服务器ECS。
  2. 在ECS中执行以下命令下载RedisShake。本文以下载2.1.2版本为例,您可以根据实际需要下载其他RedisShake版本
    wget https://github.com/tair-opensource/RedisShake/releases/download/release-v2.1.2-20220329/release-v2.1.2-20220329.tar.gz
  3. 执行命令解压RedisShake文件。
    tar -xvf redis-shake-v2.1.2.tar.gz

  4. 执行命令进入解压后的RedisShake文件目录。
    cd redis-shake-v2.0.3
  5. 编辑RedisShake工具配置文件redis-shake.conf,补充源端与目标端所有master节点信息。
    vim redis-shake.conf
    修改内容如下:
    source.type = cluster
    #如果无密码,本项不填
    source.password_raw = {source_redis_password}
    #源Cluster集群所有master节点的IP地址与端口,以分号分隔
    source.address = {master1_ip}:{master1_port};{master2_ip}:{master2_port}…{masterN_ip}:{masterN_port}
    target.type = cluster
    #如果无密码,本项不填
    target.password_raw = {target_redis_password}
    #目标Cluster集群所有master节点的IP地址与端口,以分号分隔
    target.address = {master1_ip}:{master1_port};{master2_ip}:{master2_port}…{masterN_ip}:{masterN_port}

    修改后按下Esc键退出编辑模式,输入:wq按回车键保存配置并退出编辑界面。

在线迁移数据

使用如下命令同步源Redis集群和目标Redis集群数据:
./redis-shake -type sync -conf redis-shake.conf

执行日志中出现如下信息,代表全量数据同步完成,进入增量同步阶段:

sync rdb done.

执行日志出现如下信息时,代表增量同步无新增内容,可手动停止同步(Ctrl + C):

sync:  +forwardCommands=0  +filterCommands=0  +writeBytes=0
图1 RedisShake在线迁移示意图

迁移后验证

  1. 数据同步结束后,连接DCS Cluster集群,连接Redis的方法请参考Redis-cli客户端连接Redis
  2. 通过info命令查看Keyspace中的Key数量,确认数据是否完整导入。

    如果数据不完整,可使用flushall或者flushdb命令清理目标实例中的缓存数据后重新迁移。

  3. 迁移验证完成后,删除RedisShake配置文件。