softwaremill/elasticmq-native

ElasticMQ Native Docker镜像文档

镜像概述与主要用途

ElasticMQ Native是一款基于GraalVM native-image构建的Docker镜像，提供Amazon SQS兼容的内存中消息队列服务。相比传统JVM版本，该镜像体积显著减小（约30MB，JVM版本为240MB），启动速度提升至毫秒级（JVM版本需秒级），主要用于开发、测试环境中快速模拟SQS服务，降低对AWS真实SQS的依赖。

核心功能与特性

• SQS兼容性：完全支持SQS REST API，可无缝替换真实SQS服务进行本地开发测试。
• 轻量级设计：镜像体积仅30MB，大幅节省存储空间和网络传输成本。
• 极速启动：毫秒级启动时间，显著提升开发测试流程效率。
• 内存存储：消息存储于内存中，无需持久化配置，简化部署流程。
• 内置Web UI：提供可选的管理界面（默认端口9325），支持可视化查看和管理消息队列。

使用场景与适用范围

适用于需要模拟Amazon SQS服务的以下场景：

• 本地开发环境：开发者无需连接AWS即可调试SQS相关功能。
• 单元测试/集成测试：在CI/CD流程中快速启动队列服务，验证消息处理逻辑。
• 演示环境：轻量部署用于功能演示，避免外部服务依赖。

使用方法与配置说明

基本启动命令

默认启动容器，暴露SQS API端口（9324）和Web UI端口（9325，可选）：

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

• 端口说明：9324为SQS API默认端口（必须暴露以提供服务）；9325为Web UI端口（无需使用UI时可省略该端口映射）。

自定义配置

通过挂载外部配置文件实现自定义配置（如队列规则、端口修改等）：

1. 创建配置文件：按ElasticMQ配置规范编写custom.conf（配置详情可参考https://github.com/softwaremill/elasticmq%EF%BC%89%E3%80%82
2. 挂载配置启动：将本地配置文件挂载至容器内/opt/elasticmq.conf路径：

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

端口说明

自定义配置示例

如需修改默认端口或添加队列，可在custom.conf中配置（示例）：

hocon
include classpath("application.conf")

elasticmq.rest-sqs {
  port = 9326  # 自定义API端口
}

queues {
  my-test-queue {
    defaultVisibilityTimeout = 10 seconds
    delay = 0 seconds
    receiveMessageWait = 20 seconds
  }
}

挂载该配置文件后，容器将使用9326端口提供API服务，并自动创建my-test-queue队列。