Debian RabbitMQ如何升级与迁移

Debian RabbitMQ 升级与迁移指南

一、升级 RabbitMQ

1. 备份数据
   备份配置文件 /etc/rabbitmq/ 和数据目录 /var/lib/rabbitmq/：

   sudo cp -r /etc/rabbitmq /etc/rabbitmq.bak
   sudo cp -r /var/lib/rabbitmq /var/lib/rabbitmq.bak
   

2. 升级步骤（推荐使用 APT）

   • 更新软件包列表：

     sudo apt update
     

   • 升级 RabbitMQ：

     sudo apt install --only-upgrade rabbitmq-server
     

     或指定版本：

     sudo apt install rabbitmq-server=3.9.13-1
     

   • 重启服务：

     sudo systemctl restart rabbitmq-server
     

3. 验证升级
   检查版本：

   rabbitmqctl status | grep "RabbitMQ"
   

   查看 Web 管理界面（默认端口 15672）是否正常。

二、数据迁移

场景 1：元数据迁移（用户、队列、交换机等）
使用 rabbitmqctl 导出/导入配置：

• 导出：

  sudo rabbitmqctl export_definitions /tmp/rabbitmq-config.json
  

• 导入（新服务器）：

  sudo rabbitmqctl import_definitions /tmp/rabbitmq-config.json
  

  注意：若主机名变更，需用 sed 替换配置中的旧主机名。

场景 2：消息数据迁移（持久化消息）

• 方案 1：使用 Shovel 插件（推荐）

  1. 在新旧服务器上启用 Shovel 插件：

     sudo rabbitmq-plugins enable rabbitmq_shovel rabbitmq_shovel_management
     

  2. 在新服务器配置文件（/etc/rabbitmq/rabbitmq.conf）中添加 Shovel 规则：

     shovel my_shovel {
       sources = [ { broker: "amqp://source_user:password@旧服务器IP" } ]
       destinations = [ { broker: "amqp://target_user:password@新服务器IP" } ]
       queue = "队列名"
     }
     

  3. 重启 RabbitMQ，观察 Shovel 状态是否为 running，待消息迁移完成后切换生产/消费端。

• 方案 2：直接复制数据文件（适用于大规模持久化消息）

  1. 停止旧服务器：

     sudo systemctl stop rabbitmq-server
     

  2. 复制 /var/lib/rabbitmq/mnesia/ 目录到新服务器：

     scp -r /var/lib/rabbitmq/mnesia/ 新服务器IP:/var/lib/rabbitmq/
     

  3. 启动新服务器：

     sudo systemctl start rabbitmq-server
     

  注意：此方法需确保新旧服务器的 Erlang 和 RabbitMQ 版本完全一致。

三、注意事项

1. 版本兼容性

   • 确保新版本 RabbitMQ 与当前 Erlang 版本兼容（如 RabbitMQ 3.11+ 需 Erlang 22+）。
   • 升级前查阅官方文档，确认是否有破坏性变更。

2. 业务中断控制

   • 迁移过程中建议先切换生产端，待旧服务器消息消费完成后再切换消费端（方案一），或使用 Shovel 插件在线迁移（方案二）。

3. 测试验证

   • 迁移后在测试环境验证消息完整性和服务可用性，避免直接在生产环境操作。

参考来源：