Ubuntu如何升级RabbitMQ

Ubuntu 升级 RabbitMQ 实操指南

一 升级前准备

• 核对当前版本与依赖：查看 RabbitMQ 与 Erlang/OTP 版本，并对照官方支持矩阵，确保目标版本受支持且 Erlang/OTP 版本匹配。RabbitMQ 对 Erlang 有严格对应关系，例如：4.0.0+ 需 Erlang 27.x、3.12.0+ 需 Erlang 26.x、3.13.0+ 强制要求 Erlang 26.x。
• 备份关键数据：备份 /etc/rabbitmq/（配置）与 /var/lib/rabbitmq/（数据，含 mnesia 数据库与消息存储），以便回滚。
• 选择升级策略：优先使用 APT 官方仓库进行就地升级；如无法访问外网或需精确版本控制，可准备 DEB 包离线升级。
• 规划维护窗口与流量：选择低峰期，准备应用重连与短暂中断的预案。

二 就地升级步骤（推荐）

• 更新 APT 索引并升级：执行 sudo apt-get update && sudo apt-get install --only-upgrade rabbitmq-server。如希望自动保持最新，可启用无人值守升级（生产环境建议谨慎评估）。
• 重启服务并验证：执行 sudo systemctl restart rabbitmq-server，随后用 rabbitmqctl status 与 rabbitmq-diagnostics ping 检查节点健康。
• 升级后自检：确认管理插件可用（rabbitmq-plugins list），必要时执行 rabbitmq-plugins enable rabbitmq_management 并访问 15672 端口验证。

三 跨版本或离线升级

• 准备兼容的 Erlang/OTP：若跨多个 RabbitMQ 大版本，先按官方矩阵升级 Erlang/OTP 到对应版本，再升级 RabbitMQ。
• 使用官方 APT 仓库安装目标版本：导入签名密钥与仓库后，执行 sudo apt-get update，按需安装指定版本（示例：sudo apt-get install rabbitmq-server=3.12.x-1）。
• 离线场景：下载目标版 DEB 包（如 rabbitmq-server_4.2.1-1_all.deb），执行 sudo dpkg -i rabbitmq-server_4.2.1-1_all.deb 完成安装。
• 版本核对：升级后用 rabbitmqctl version 与 erl -version 确认版本。

四 升级后验证与常见问题

• 版本与健康检查：执行 rabbitmqctl version、rabbitmqctl status、rabbitmq-diagnostics ping，确保节点运行正常。
• 管理界面与端口：启用管理插件 rabbitmq-plugins enable rabbitmq_management，确认 15672 可访问；常用端口包括 5672/5671（AMQP）、4369（epmd）、25672（节点间通信）。
• 用户与权限：默认 guest/guest 仅允许 localhost 登录，远程访问需创建管理员用户并赋权，例如：
  • rabbitmqctl add_user admin StrongPass!
  • rabbitmqctl set_user_tags admin administrator
  • rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"
• 常见问题处理：若升级后插件未启用或端口不通，检查服务状态、插件启用状态与防火墙规则；必要时回滚到备份版本。

五 回滚方案

• 快速回滚：使用 APT 降级到原版本（如 sudo apt-get install rabbitmq-server=<旧版本号>），重启服务并复核数据与权限。
• 配置与数据回滚：将备份的 /etc/rabbitmq/ 与 /var/lib/rabbitmq/ 覆盖回原路径，再启动服务。
• 回滚后验证：执行 rabbitmqctl status 与业务连通性测试，确保队列、交换机、用户权限与策略恢复。