rbrooker/rabbitmq

RabbitMQ镜像

镜像概述

本镜像旨在解决其他RabbitMQ Docker镜像缺乏细粒度控制和插件扩展能力的问题，允许用户自定义配置并添加所需插件，满足多样化的消息队列需求。镜像基于RabbitMQ 3.7.12和Erlang-NOX 20.3构建。

核心功能

• 基础版本：RabbitMQ 3.7.12、Erlang-NOX 20.3
• 可选功能：SSL安全通信、Shovel消息转发、Federation跨集群同步、Clustering集群部署
• 支持自定义配置调整，脱离默认设置

使用场景

• 分布式系统中的消息队列服务部署
• 需要SSL加密通信的安全消息传递场景
• 跨集群的消息同步与转发需求
• 对消息队列配置有细粒度控制要求的场景

配置说明与部署示例

基本运行

bash
docker run -d -it \
    --hostname=bunny.hop  \
    --name=rabbit  \
    -p 5672:5672 -p 15672:15672 -p 5671:5671 \
    -e SSL="false" \
    docker.xuanyuan.run/rbrooker/rabbitmq:latest

SSL配置与运行

1. 创建证书卷并复制证书：

bash
docker volume create --name my-cert-volume
docker run -v my-cert-volume:/server --name cert-container docker.xuanyuan.run/ubuntu /bin/true
# 将你的证书文件复制到卷中
docker cp certs/* cert-container:/server/

2. 启动带SSL的实例：

bash
docker run -d -it \
   --volumes-from cert-container:ro \
   --hostname=bunny.hop  \
   --name=rabbit  \
   -p 5672:5672 -p 15672:15672 -p 5671:5671 \
   -e SSL="true"\
  docker.xuanyuan.run/rbrooker/rabbitmq:latest

注意：证书需放置在/server/cacert.pem、/server/cert.pem、/server/key.pem路径下。

集群部署

1. 拉取docker-compose.yml文件
2. 运行集群：

bash
docker-compose up

更多集群细节请参考https://github.com/cognition/rbrooker-rabbitmq/wiki/Clustering。

自定义构建

bash
git clone https://github.com/cognition/rbrooker-rabbitmq my-rabbitmq
cd my-rabbitmq
git branch my-secrets-branch
git checkout my-secrets-branch
# 替换证书文件
cp ../my-cacert.pem testca/cacert.pem
cp ../my-server-cert.pem server/cert.pem
cp ../my-server-key.pem server/key.pem
# 构建镜像
docker build -t my-rabbitmq:0 -t my-rabbitmq .

常见注意事项

• SSL配置需使用SSL="false"或SSL="true"，而非SSL=0或SSL=1
• 证书目录结构需严格遵循上述路径要求

维护者

Ramon Brooker ***