elasticmq 镜像文档

镜像概述

elasticmq是一个与Amazon SQS兼容的内存消息队列镜像，专为持续集成和测试场景设计。该镜像由SoftwareMill开发赞助，可作为SQS的本地替代品，方便开发和测试环境中进行消息队列相关的验证工作。

核心功能

• SQS兼容性：完全兼容Amazon SQS API，可无缝替换云端SQS服务
• 内存运行：基于内存存储，无需持久化配置，启动速度快
• 多端口支持：默认提供9324（REST-SQS API端口）和9325（UI端口，可选暴露）
• 自定义配置：支持修改外部可见地址、启动时创建队列等高级配置
• 灵活扩展：可通过Java系统属性自定义日志配置及其他运行参数

使用场景

• 开发环境中本地测试消息队列功能
• 持续集成(CI)流程中模拟SQS服务进行自动化测试
• 无需依赖AWS账户即可进行消息队列相关功能验证

使用方法

默认运行

使用默认配置启动容器，暴露API端口和UI端口：

docker run -p 9324:9324 -p 9325:9325 softwaremill/elasticmq

自定义配置文件

通过挂载自定义配置文件实现高级配置（如修改外部地址或预设队列）：

1. 参考***文档创建配置文件（如custom.conf）
2. 运行容器时挂载配置文件：

docker run -p 9324:9324 -p 9325:9325 -v $(pwd)/custom.conf:/opt/elasticmq.conf softwaremill/elasticmq

传递Java系统属性

如需设置Java系统属性（-D参数），需创建application.ini文件：

示例：配置日志文件

创建application.ini文件：

-Dconfig.file=/opt/elasticmq.conf
-Dlogback.configurationFile=/opt/docker/conf/logback.xml

挂载配置文件并运行容器：

docker run -v $(pwd)/application.ini:/opt/docker/conf/application.ini -v $(pwd)/logback.xml:/opt/docker/conf/logback.xml -p 9324:9324 softwaremill/elasticmq

自定义Dockerfile

通过自定义Dockerfile构建个性化镜像：

FROM openjdk:8-jre-alpine

ARG ELASTICMQ_VERSION
ENV ELASTICMQ_VERSION ${ELASTICMQ_VERSION:-0.14.6}

RUN apk add --no-cache curl ca-certificates
RUN mkdir -p /opt/elasticmq/log /opt/elasticmq/lib /opt/elasticmq/config
RUN curl -sfLo /opt/elasticmq/lib/elasticmq.jar [***]{ELASTICMQ_VERSION}.jar

WORKDIR /opt/elasticmq

EXPOSE 9324
EXPOSE 9325

ENTRYPOINT [ "/usr/bin/java", "-jar", "/opt/elasticmq/lib/elasticmq.jar" ]

其他说明

可参考elasticmq-native镜像，这是一个更小、更快的实验性版本，适用于资源受限环境。