callforamerica/rabbitmq

RabbitMQ (稳定版) 含Kubernetes修复及清单

维护者

Joe Black | <***> | https://github.com/joeblackwaslike

镜像概述

本镜像为最小化RabbitMQ部署，仅包含rabbitmq-management插件。基于自定义Debian Linux (Jessie)系统构建，压缩后大小约22MB，专为容器化环境优化，并包含Kubernetes相关修复及部署清单。

核心功能与特性

• 最小化设计：基于轻量Debian系统，压缩后约22MB，资源占用低
• 管理插件集成：默认包含rabbitmq-management插件，支持Web管理界面
• Kubernetes支持：提供Kubernetes部署清单及相关修复，适配容器编排环境
• 环境变量配置：支持通过环境变量灵活配置RabbitMQ参数
• 版本可控：可通过构建参数指定Erlang和RabbitMQ版本

使用场景

• 开发/测试环境中的消息队列服务部署
• 容器化生产环境的RabbitMQ集群搭建
• 需要通过Kubernetes进行编排管理的消息中间件场景

构建环境变量

构建环境变量用于Docker构建阶段，可通过构建参数覆盖，主要用于版本控制和路径配置：

• ERLANG_VERSION：Erlang版本号
• RABBITMQ_VERSION：RabbitMQ版本号
• APP：应用名称，固定为rabbitmq
• USER：运行用户，固定为rabbitmq
• HOME：用户主目录，固定为/var/lib/rabbitmq

运行环境变量

运行环境变量用于容器启动时配置RabbitMQ，可通过docker run或Kubernetes的env数组指定：

• RABBITMQ_LOG_LEVEL：日志级别（小写），用于rabbitmq.config中的连接日志配置，默认值：info
• RABBITMQ_DISK_FREE_LIMIT：磁盘空闲限制，用于rabbitmq.config中的vm_memory_high_watermark配置，默认值：50MB
• RABBITMQ_VM_MEMORY_HIGH_WATERMARK：内存高水位线，用于rabbitmq.config配置，默认值：0.8
• RABBITMQ_ENABLED_PLUGINS：启用的插件列表（逗号分隔，会自动转换为空格分隔），通过rabbitmq-plugins enable --offline命令启用，默认值：rabbitmq_management,rabbitmq_management_agent

注：除上述变量外，RabbitMQ官方bash脚本支持的其他环境变量同样适用
参考：[***]

使用方法

Docker（预构建镜像）

本镜像已发布至Docker Hub，可直接拉取使用：

• Docker Hub地址：https://hub.docker.com/r/callforamerica/
• 社区镜像库：[***]

拉取镜像：

bash
docker pull callforamerica/rabbitmq

运行容器：

bash
docker run -d \
    --name rabbitmq \
    -h rabbitmq \
    -e "ERLANG_COOKIE=test-cookie" \
    -e "RABBITMQ_USE_LONGNAME=true" \
    callforamerica/rabbitmq

提示：具体可配置的环境变量请参考「运行环境变量」部分

Docker Compose

1. 拉取镜像：

bash
docker-compose pull

2. 启动服务：

bash
# 前台运行（退出时终止容器）
docker-compose up --abort-on-container-exit

# 后台运行
docker-compose up -d

Kubernetes

1. 编辑kubernetes/<environment>目录下的清单文件，适配具体环境配置

2. 创建Erlang Cookie密钥：

bash
kubectl create secret generic erlang-cookie --from-literal=erlang.cookie=$(LC_ALL=C tr -cd '[:alnum:]' < /dev/urandom | head -c 64)

3. 创建RabbitMQ凭据密钥：

bash
kubectl create secret generic rabbitmq-creds --from-literal=rabbitmq.user=$(sed $(perl -e "print int rand(99999)")"q;d" /usr/share/dict/words) --from-literal=rabbitmq.pass=$(LC_ALL=C tr -cd '[:alnum:]' < /dev/urandom | head -c 32)

4. 部署RabbitMQ：

bash
kubectl create -f kubernetes/<environment>