消息队列 / 系统课时

创建 RabbitMQ 集群

创建 RabbitMQ 集群

这一课用三台 Linux 主机完成一个 RabbitMQ 4.3 集群:先检查节点名与网络,再统一节点间认证所需的 Erlang Cookie,让两个节点加入种子节点,最后用集群状态验证三台机器已经形成同一集群。

学习目标

  • 完成三节点 RabbitMQ 集群的手工组建
  • 正确统一 Erlang Cookie、主机名解析和节点间通信条件
  • 用 cluster_status 验证成员关系并定位常见加入失败

先完成节点前置检查

示例使用 rabbit1、rabbit2、rabbit3 三台新节点,默认节点名分别为 rabbit@rabbit1、rabbit@rabbit2、rabbit@rabbit3。三台机器必须能互相解析主机名,并允许节点间访问 TCP 4369 与 25672;若使用自定义分布式端口,则以实际配置为准。

先在每台机器重复执行下面的检查。示例输出以 rabbit1 为例,<IP> 会因环境不同而变化。

bash
hostname -s
getent hosts rabbit1 rabbit2 rabbit3
sudo -u rabbitmq rabbitmq-diagnostics -q ping

预期输出

text
rabbit1
<IP> rabbit1
<IP> rabbit2
<IP> rabbit3
Ping succeeded

统一 Erlang Cookie

RabbitMQ 节点通过 Erlang Cookie 互相认证。Linux 服务常用的 Cookie 文件是 /var/lib/rabbitmq/.erlang.cookie,三个节点必须使用完全相同的内容,并保证文件只允许 RabbitMQ 服务账号读取。

下面假设自动化系统已经把同一份 Cookie 安全地放到每台机器的 <PATH>/erlang.cookie。实际路径不同,生产环境应通过 Secret 管理或配置管理系统分发,不要把 Cookie 明文写进命令历史。

bash
sudo systemctl stop rabbitmq-server
sudo install -o rabbitmq -g rabbitmq -m 600 <PATH>/erlang.cookie /var/lib/rabbitmq/.erlang.cookie
sudo systemctl start rabbitmq-server
sudo systemctl is-active rabbitmq-server
sudo sha256sum /var/lib/rabbitmq/.erlang.cookie

预期输出

text
active
<HASH>  /var/lib/rabbitmq/.erlang.cookie

三台节点显示的 <HASH> 必须相同。实际哈希值会随 Cookie 内容变化;如果不同,不要继续执行加入操作。

三节点 RabbitMQ 集群创建流程

让两个节点加入种子节点

RabbitMQ 4.3 手工建群时,不再需要先执行旧教程里的 stop_app、reset、start_app 组合;join_cluster 会完成加入前所需的准备。先在 rabbit2 执行加入,再在 rabbit3 执行相同操作。

bash
# 在 rabbit2 上执行
sudo -u rabbitmq rabbitmqctl join_cluster rabbit@rabbit1

# 在 rabbit3 上执行
sudo -u rabbitmq rabbitmqctl join_cluster rabbit@rabbit1

预期输出

text
Clustering node rabbit@rabbit2 with [rabbit@rabbit1] ...done.
Clustering node rabbit@rabbit3 with [rabbit@rabbit1] ...done.

种子节点只是提供一个已在线的集群成员地址。第二个节点也可以通过任何已经加入且在线的成员找到整个集群,因此 rabbit1 不是永久主节点。

验证三节点已经组成同一集群

在任意一个成员上执行下面的命令。重点检查成员列表和 Running Nodes 都出现三个节点。

bash
sudo -u rabbitmq rabbitmqctl cluster_status

预期输出

text
Disk Nodes
rabbit@rabbit1
rabbit@rabbit2
rabbit@rabbit3

Running Nodes
rabbit@rabbit1
rabbit@rabbit2
rabbit@rabbit3

如果三个节点都同时出现在这两部分,说明集群成员关系已经建立并且当前都在线。实际输出还可能包含 RabbitMQ、Erlang 版本、CPU、维护状态和监听器等信息。

加入失败按顺序排查

遇到 Invalid challenge reply、Erlang distribution failed 或无法联系目标节点时,不要反复重置节点。先检查节点名能否互相解析,再确认 4369 与 25672 没有被防火墙阻断,最后比较三台机器的 Cookie 文件是否一致、属主和权限是否正确。

如果主机使用 FQDN,所有节点与 CLI 都必须一致使用长节点名配置;短名和长名混用会导致看似网络正常但节点身份不匹配。生产环境还应优先采用 DNS、Kubernetes、Consul、etcd 等自动发现方式建群,手工 join_cluster 更适合实验、测试和特定恢复场景。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 RabbitMQ 集群

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通