clefos/rabbitmq

ClefoS 7 RabbitMQ Docker镜像文档

镜像概述

本镜像基于ClefoS 7系统构建，用于部署RabbitMQ消息代理服务。RabbitMQ是一个实现高级消息队列协议(AMQP)的开源消息代理软件，广泛应用于分布式系统中的消息传递。镜像默认创建管理员用户并生成随机密码（可通过日志查看），同时支持自定义账号密码配置。

核心功能与特性

• 基于ClefoS 7系统，稳定可靠
• 集成RabbitMQ消息代理，支持AMQP协议
• 自动创建管理员用户，随机生成密码（日志可见）
• 支持通过环境变量自定义管理员账号密码
• 暴露标准端口：5672（消息通信端口）和***（管理界面端口）
• 包含管理插件，提供Web管理界面

使用场景

• 微服务架构中的服务间异步通信
• 分布式系统中的消息队列与任务调度
• 需要可靠消息传递的应用场景
• 开发/测试环境中快速部署RabbitMQ服务

使用方法

构建镜像

1. 下载镜像源码
2. 执行构建命令：

   bash
   docker build -rm -t <username>/rabbitmq:clefos7 .
   

   其中<username>为你的Docker仓库用户名。

运行容器

方式1：使用随机生成的管理员密码

bash
docker run -d -p 5672:5672 -p 15672:15672 <username>/rabbitmq:clefos7

管理员密码会在容器日志中显示，可通过docker logs <container_id>查看。

方式2：自定义管理员账号密码

通过环境变量RABBITMQ_USER和RABBITMQ_PASS指定：

bash
docker run -d -e RABBITMQ_USER=foo -e RABBITMQ_PASS=bar -p 5672:5672 -p 15672:15672 <username>/rabbitmq:clefos7

确认服务启动

查看容器日志确认RabbitMQ启动状态：

bash
docker logs <container_id>

成功启动会显示类似以下内容：

            RabbitMQ 3.1.5. Copyright (C) 2007-2013 GoPivotal, Inc.
##  ##      Licensed under the MPL.  See http://www.rabbitmq.com/
##  ##
##########  Logs: /var/log/rabbitmq/rabbit@<container_id>.log
######  ##        /var/log/rabbitmq/rabbit@<container_id>-sasl.log
##########
              Starting broker... completed with 6 plugins.

查看端口映射

确认容器端口映射情况：

bash
docker ps

输出示例：

CONTAINER ID        IMAGE                      COMMAND                CREATED             STATUS              PORTS                                              NAMES
01ad9b20d68e        admiller/rabbitmq:clefos7   /usr/sbin/rabbitmq-s   9 minutes ago       Up 9 minutes        0.0.0.0:15672->15672/tcp, 0.0.0.0:5672->5672/tcp   grave_albat

测试连接

1. 从管理界面下载rabbitmqadmin工具：

   bash
   wget localhost:15672/cli/rabbitmqadmin
   

2. 赋予执行权限：

   bash
   chmod +x rabbitmqadmin
   

3. 查看帮助：

   bash
   ./rabbitmqadmin help subcommands
   

4. 列出用户（验证管理员账号）：

   bash
   ./rabbitmqadmin list users
   

   输出示例：

   +-------+------------------------------+---------------+
   | name  |        password_hash         |     tags      |
   +-------+------------------------------+---------------+
   | guest | CkDOzIkuFmtJNeg2AL6T1LiUfmQ= | administrator |
   +-------+------------------------------+---------------+
   

OpenShift Origin运行注意事项

容器调试环境配置

若需直接进入容器Pod进行调试，需先执行以下命令配置环境：

bash
export HOME="/var/lib/rabbitmq"
export LD_PRELOAD=libnss_wrapper.so
export NSS_WRAPPER_PASSWD=/tmp/rabbitmq/passwd
export NSS_WRAPPER_GROUP=/etc/group

多容器部署建议

在多容器部署场景中，强烈建议在容器间共享/var/lib/rabbitmq目录，并确保适当的权限设置，以保证数据一致性和服务稳定性。