telephoneorg/rabbitmq

RabbitMQ (稳定版) 带Kubernetes修复和清单

https://travis-ci.org/telephoneorg/docker-rabbitmq.svg?branch=master](https://travis-ci.org/telephoneorg/docker-rabbitmq) https://img.shields.io/docker/pulls/telephoneorg/rabbitmq.svg](https://hub.docker.com/r/telephoneorg/rabbitmq) https://images.microbadger.com/badges/image/telephoneorg/rabbitmq.svg](https://microbadger.com/images/telephoneorg/rabbitmq) https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat](https://github.com/telephoneorg/docker-rabbitmq)

维护者

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

镜像概述

最小化RabbitMQ镜像，包含rabbitmq-management插件，基于自定义的最小版本Debian Linux系统。该镜像针对Kubernetes环境进行了修复，并提供相应的部署清单，适用于需要可靠消息队列服务的容器化环境。

核心功能与特性

• 最小化设计：基于自定义最小Debian系统，减少镜像体积和***面
• 预装管理插件：包含rabbitmq-management插件，支持Web界面管理
• Kubernetes优化：提供Kubernetes修复和部署清单，便于在K8s集群中部署
• 可配置性：通过环境变量灵活配置RabbitMQ参数，如日志级别、内存水位线等

使用场景

• 容器化环境中的消息队列服务
• Kubernetes集群内的消息中间件部署
• 需要Web管理界面的RabbitMQ应用场景
• 对镜像体积有要求的轻量级部署

构建环境变量

构建环境变量用于在Docker构建阶段设置版本号和其他选项，可通过同名构建参数覆盖其值：

• ERLANG_VERSION：Erlang版本
• RABBITMQ_VERSION：RabbitMQ版本

以下变量为多数Dockerfile通用，用于减少重复并提高脚本复用性：

• APP: rabbitmq（应用名称）
• USER: rabbitmq（运行用户）
• HOME: /var/lib/rabbitmq（用户主目录）

运行环境变量

运行环境变量用于入口脚本中的配置模板渲染和流程控制，可在继承基础Dockerfile时覆盖、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脚本还识别许多其他变量。

参考：https://www.rabbitmq.com/configure.html

使用方法

Docker（预构建镜像）

所有github上的docker-*仓库均通过CI流水线推送到Docker Cloud/Hub。

该镜像可从以下地址获取：

• https://hub.docker.com/r/telephoneorg/rabbitmq
• https://store.docker.com/community/images/telephoneorg/rabbitmq
• 拉取命令：docker pull telephoneorg/rabbitmq

运行示例：

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

注意：请参考“运行环境变量”部分了解可用环境变量列表。

Docker Compose

拉取镜像：

bash
docker-compose pull

启动应用及依赖：

bash
# 前台启动
docker-compose up --abort-on-container-exit

# 后台启动
docker-compose up -d

Kubernetes

编辑kubernetes/<environment>目录下的清单文件，以反映特定环境和配置。

创建erlang cookie密钥：

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

创建rabbitmq凭证密钥：

bash
kubectl create secret generic rabbitmq --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)

部署RabbitMQ：

bash
kubectl create -f kubernetes/<environment>