softwaremill/elasticmq

elasticmq 镜像文档

镜像概述

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

核心功能

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

使用场景

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

使用方法

默认运行

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

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

自定义配置文件

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

1. 参考https://github.com/softwaremill/elasticmq%E5%88%9B%E5%BB%BA%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%EF%BC%88%E5%A6%82%60custom.conf%60%EF%BC%89
2. 运行容器时挂载配置文件：

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

传递Java系统属性

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

示例：配置日志文件

创建application.ini文件：

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

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

bash
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构建个性化镜像：

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 https://s3-eu-west-1.amazonaws.com/softwaremill-public/elasticmq-server-${ELASTICMQ_VERSION}.jar

WORKDIR /opt/elasticmq

EXPOSE 9324
EXPOSE 9325

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

其他说明

可参考https://hub.docker.com/r/softwaremill/elasticmq-native/%E9%95%9C%E5%83%8F%EF%BC%8C%E8%BF%99%E6%98%AF%E4%B8%80%E4%B8%AA%E6%9B%B4%E5%B0%8F%E3%80%81%E6%9B%B4%E5%BF%AB%E7%9A%84%E5%AE%9E%E9%AA%8C%E6%80%A7%E7%89%88%E6%9C%AC%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E8%B5%84%E6%BA%90%E5%8F%97%E9%99%90%E7%8E%AF%E5%A2%83%E3%80%82