efrecon/disque

Disque Docker镜像

镜像概述

本镜像为运行https://github.com/antirez/disque（一款由https://github.com/antirez/redis作者https://github.com/antirez/开发的内存分布式任务队列）提供最小化Docker环境。基于https://hub.docker.com/_/alpine/构建，支持通过以DISQUE_为前缀的环境变量进行配置，特殊环境变量DISQUE_MEET可用于构建集群。

核心功能与特性

• 轻量级基础：基于Alpine镜像，体积小，资源占用低
• 灵活配置：支持通过命令行参数或环境变量两种方式配置Disque
• 集群支持：通过DISQUE_MEET环境变量轻松构建分布式集群，支持主机名解析
• 持久化：可通过卷挂载实现队列状态持久化，便于冷启动
• 源码编译：基于官方发布源码直接编译，确保版本一致性

使用场景

• 异步任务处理系统
• 分布式服务间消息传递
• 高并发任务队列管理
• 需要水平扩展的任务调度场景

使用方法

基本运行

创建Disque服务器的基本命令：

bash
docker run efrecon/disque:1.0-rc1

配置方式

Disque的默认https://github.com/antirez/disque/blob/master/disque.conf中的任何变量都可通过以下两种方式设置：

1. 命令行参数：使用与配置变量同名的双横线前缀参数（符合Disque服务器原生行为）

2. 环境变量：遵循以下规则设置环境变量：

   • 变量名大写
   • 配置变量中的单破折号替换为下划线
   • 以DISQUE_为前缀

示例：设置端口（两种方式效果相同）

bash
# 命令行参数方式
docker run efrecon/disque:1.0-rc1 --port 3456

# 环境变量方式
docker run --env DISQUE_PORT=3456 efrecon/disque:1.0-rc1

集群配置

集群构建

DISQUE_MEET环境变量用于将当前节点加入已有Disque集群，其值为空格分隔的<hostname>:<port>对列表（端口及前置冒号可省略，默认7711）。Disque原生MEET命令要求IP地址，而通过DISQUE_MEET可使用主机名，简化分布式集群创建。

Docker Compose示例

使用项目目录中的compose文件，可快速创建3节点集群（需安装docker-compose）：

bash
docker-compose up --scale slave=2

集群特性

• Disque无主从节点概念，所有节点地位平等
• 示例配置中3个节点确保队列数据持久性
• master服务关联的卷用于持久化队列状态，支持冷重启

实现细节

• 基于https://hub.docker.com/r/richnorth/disque/，并借鉴https://github.com/docker-library/redis/tree/master/4.0/alpine的实现
• 使用Alpine基础镜像，从官方源码编译，为适配Alpine移除了https://github.com/antirez/disque/blob/master/src/config.h中的backtrace支持
• 入口点脚本处理DISQUE_前缀环境变量：复制默认配置文件并根据环境变量修改，然后启动Disque服务
• DISQUE_MEET由meet.sh脚本处理：等待本地Disque启动后，解析主机名并请求本地服务器与远程节点建立连接，自动等待远程节点就绪