ekesken/rabbitmq

docker-rabbitmq 镜像文档

镜像概述

docker-rabbitmq是一个用于在Mesos上通过单个Marathon应用部署RabbitMQ集群的Docker镜像。该镜像支持通过环境变量进行配置，简化了RabbitMQ集群的部署和管理流程，适用于需要在Mesos集群环境中搭建高可用RabbitMQ服务的场景。

核心功能与特性

• 集群部署支持：可通过Marathon应用配置实现RabbitMQ集群部署，支持多实例节点
• 环境变量配置：关键参数（如Erlang Cookie、默认用户密码）可通过环境变量灵活配置
• 持久化存储：支持挂载主机目录作为数据卷，确保RabbitMQ数据持久化
• 网络灵活性：兼容Calico等网络方案，支持自定义网络配置
• 健康检查集成：内置健康检查机制，确保集群节点稳定运行

使用场景

• 在Mesos集群环境中部署高可用RabbitMQ消息队列服务
• 需要通过单个Marathon应用管理RabbitMQ集群的场景
• 需灵活配置RabbitMQ参数（如认证信息、网络设置）的生产环境

使用方法与配置说明

基本部署要求

• Mesos集群环境
• Marathon调度平台
• 适当的主机资源（CPU、内存）和持久化存储

Marathon配置示例

以下是通过Marathon部署RabbitMQ集群的完整配置示例：

json
{
  "cpus": 1,
  "mem": 1000,
  "id": "test-rabbitmq",
  "instances": 2,
  "constraints": [
    ["hostname", "UNIQUE"],
    ["test-rabbitmq-host", "CLUSTER", "true"]
  ],
  "env": {
    "RABBITMQ_ERLANG_COOKIE": "my_secret_erlang_cookie",  // 集群节点间通信的Erlang Cookie，所有节点必须一致
    "RABBITMQ_DEFAULT_USER": "admin",  // RabbitMQ默认管理员用户名
    "RABBITMQ_DEFAULT_PASS": "my_secret_pass"  // RabbitMQ默认管理员密码
  },
  "container": {
    "type": "DOCKER",
    "docker": {
      "image": "ekesken/rabbitmq",
      "forcePullImage": true,  // 强制拉取最新镜像
      "network": "HOST",  // 使用主机网络模式
      "privileged": true  // 授予容器特权模式
    },
    "volumes": [
      {
        "containerPath": "/var/lib/rabbitmq",  // 容器内数据存储路径
        "hostPath": "/var/lib/rabbitmq",  // 主机挂载路径
        "mode": "RW"  // 读写权限
      }
    ]
  },
  "healthChecks": [
    {
      "protocol": "TCP",  // TCP协议健康检查
      "gracePeriodSeconds": 600  // 健康检查宽限期（秒）
    }
  ],
  "upgradeStrategy": {
    "minimumHealthCapacity": 0,  // 升级时的最小健康容量
    "maximumOverCapacity": 0  // 升级时的最大超额容量
  }
}

Calico网络配置示例

若使用Calico网络，可参考以下配置调整网络参数：

json
  ...
  "container": {
    "type": "DOCKER",
    "docker": {
      "image": "ekesken/rabbitmq",
      "forcePullImage": true,
      "parameters": [
        {"key": "net", "value": "calico-net1"}  // 指定Calico网络名称
       ]
    }
  },
  "ipAddress": {"discovery": {"ports": [
    { "number": 5672, "name": "rabbitmq-node-port", "protocol": "tcp"},  // RabbitMQ节点通信端口
    { "number": 15672, "name": "rabbitmq-management-port", "protocol": "tcp"}  // RabbitMQ管理界面端口
  ]}},

关键配置参数说明

健康检查与升级策略

• 健康检查：采用TCP协议检查，宽限期600秒，确保服务启动完成后再进行健康状态评估
• 升级策略：最小健康容量和最大超额容量均设为0，确保升级过程中不会出现容量超额或健康节点不足的情况