ivonet/activemq

概述

该Dockerfile用于构建ActiveMQ容器镜像，默认启用基础认证（用户名：admin / 密码：secret）。

版本

当前版本：5.14.4

硬件要求

CPU

暂无关于消息量与核心数对应关系的统计数据。

内存

• 512MB内存过小，仅适用于测试环境；
• 1GB为标准内存大小。

你可以通过以下方式设置所需内存：

bash
docker run --name='activemq' -it --rm \
	-e 'ACTIVEMQ_MIN_MEMORY=512' \
	-e 'ACTIVEMQ_MAX_MEMORY=2048' \
    -P ivonet/activemq

此示例启动的ActiveMQ容器初始内存为512MB，最大可使用2048MB内存。

存储

所需硬盘空间取决于是否使用持久化消息及日志记录方式。通常ActiveMQ无需大量空间，因为大部分数据直接存储在内存中，具体取决于你的使用场景。

贡献

如果你觉得该镜像有用，可通过以下方式贡献：

• 提交Pull Request，包含新功能或bug修复。

安装

从Docker索引拉取镜像（推荐方式，便于更新）：

bash
docker pull ivonet/activemq

快速启动

测试环境

bash
docker run --name='activemq' -it --rm -P ivonet/activemq

默认账户为admin/admin，所有设置均为ActiveMQ默认配置。

生产环境

bash
docker run --name='activemq' -d \
-e 'ACTIVEMQ_NAME=amqp-srv1' \
-e 'ACTIVEMQ_REMOVE_DEFAULT_ACCOUNT=true' \
-e 'ACTIVEMQ_ADMIN_LOGIN=admin' -e 'ACTIVEMQ_ADMIN_PASSWORD=your_password' \
-e 'ACTIVEMQ_WRITE_LOGIN=producer_login' -e 'ACTIVEMQ_WRITE_PASSWORD=producer_password' \
-e 'ACTIVEMQ_READ_LOGIN=consumer_login' -e 'ACTIVEMQ_READ_PASSWORD=consumer_password' \
-e 'ACTIVEMQ_JMX_LOGIN=jmx_login' -e 'ACTIVEMQ_JMX_PASSWORD=jmx_password' \
-e 'ACTIVEMQ_STATIC_TOPICS=topic1;topic2;topic3' \
-e 'ACTIVEMQ_STATIC_QUEUES=queue1;queue2;queue3' \
-e 'ACTIVEMQ_MIN_MEMORY=1024' -e  'ACTIVEMQ_MAX_MEMORY=4096' \
-e 'ACTIVEMQ_ENABLED_SCHEDULER=true' \
-v /data/activemq:/data/activemq \
-v /var/log/activemq:/var/log/activemq \
-p 8161:8161 \
-p 61616:61616 \
-p 61613:61613 \
ivonet/activemq

也可使用fig（现更名为docker-compose）：

bash
wget https://raw.githubusercontent.com/disaster37/activemq/master/fig.yml
fig up

配置

可用配置参数

可通过--env-file指定环境变量文件，避免冗长的docker run命令。以下是所有可用配置项：

• ACTIVEMQ_NAME：ActiveMQ服务器主机名，默认localhost；
• ACTIVEMQ_LOGLEVEL：日志级别，默认INFO；
• ACTIVEMQ_PENDING_MESSAGE_LIMIT：限制主题消费者保留的消息数，防止阻塞生产者，默认1000；
• ACTIVEMQ_STORAGE_USAGE： broker允许的最大存储空间，默认100gb；
• ACTIVEMQ_TEMP_USAGE： broker允许的最大临时空间，默认50gb；
• ACTIVEMQ_MAX_CONNECTION：并发连接数限制（防DOS），默认1000；
• ACTIVEMQ_FRAME_SIZE：帧大小限制（防DOS），默认***（100MB）；
• ACTIVEMQ_ENABLED_SCHEDULER：是否启用调度器，默认true；
• ACTIVEMQ_ENABLED_AUTH：是否启用队列/主题认证（禁止***访问），默认false；
• ACTIVEMQ_MIN_MEMORY：初始内存（类似XMS），默认128MB；
• ACTIVEMQ_MAX_MEMORY：最大内存（类似XMX），默认1024MB；
• ACTIVEMQ_REMOVE_DEFAULT_ACCOUNT：是否移除所有默认账户（Web控制台、broker、JMX），默认false；
• ACTIVEMQ_ADMIN_LOGIN：admin账户登录名（broker和Web控制台），默认admin；
• ACTIVEMQ_ADMIN_PASSWORD：admin账户密码，默认admin；
• ACTIVEMQ_USER_LOGIN：Web控制台普通用户登录名（无broker权限），默认user；
• ACTIVEMQ_USER_PASSWORD：普通用户密码，默认user；
• ACTIVEMQ_READ_LOGIN：所有队列/主题只读权限登录名；
• ACTIVEMQ_READ_PASSWORD：只读账户密码；
• ACTIVEMQ_WRITE_LOGIN：所有队列/主题写入权限登录名；
• ACTIVEMQ_WRITE_PASSWORD：写入账户密码；
• ACTIVEMQ_OWNER_LOGIN：所有队列/主题管理员权限登录名；
• ACTIVEMQ_OWNER_PASSWORD：管理员账户密码；
• ACTIVEMQ_JMX_LOGIN：JMX读写权限登录名，默认admin；
• ACTIVEMQ_JMX_PASSWORD：JMX账户密码，默认activemq；
• ACTIVEMQ_STATIC_TOPICS：启动时创建的主题列表（逗号分隔）；
• ACTIVEMQ_STATIC_QUEUES：启动时创建的队列列表（逗号分隔）。

docker-compose示例

yaml
  activemq:
    image: ivonet/activemq
    ports:
    - "8161:8161"
    - "61616:61616"
    - "61613:61613"
    environment:
    - ACTIVEMQ_MIN_MEMORY=512
    - ACTIVEMQ_MAX_MEMORY=2048
    - ACTIVEMQ_ENABLED_AUTH=true
    - ACTIVEMQ_ADMIN_LOGIN=admin
    - ACTIVEMQ_ADMIN_PASSWORD=secret
#    - ACTIVEMQ_REMOVE_DEFAULT_ACCOUNT=true
#    - ACTIVEMQ_WRITE_LOGIN=producer
#    - ACTIVEMQ_WRITE_PASSWORD=secret
#    - ACTIVEMQ_READ_LOGIN=consumer
#    - ACTIVEMQ_READ_PASSWORD=secret
#    - ACTIVEMQ_JMX_LOGIN=jmx
#    - ACTIVEMQ_JMX_PASSWORD=secret
#    - ACTIVEMQ_USER_LOGIN=user
#    - ACTIVEMQ_USER_PASSWORD=user
    volumes:
    - ./volumes/log/activemq:/var/log/activemq

高级配置

如需高级配置，建议参考ActiveMQ官方文档并创建自定义配置文件（如activemq.xml）。可通过挂载配置目录覆盖默认设置：

bash
-v /your_path/conf:/opt/activemq/conf

或基于此镜像创建包含自定义配置的新镜像。

基于以下项目

镜像源自：https://github.com/disaster37