webcenter/activemq

目录

• 简介
  • 版本
  • 变更日志
• 硬件要求
  • CPU
  • 内存
  • 存储
• 贡献
• 问题
• 安装
• 快速开始
• 配置
  • 访问控制
  • 队列
  • 主题
  • 数据存储
  • Broker
  • 磁盘使用
  • JMX
  • 可用配置参数
  • 高级配置
• 参考

简介

本Docker镜像用于构建ActiveMQ容器，提供可靠的消息中间件服务。

版本

当前版本：5.15.2

硬件要求

CPU

暂无针对消息数量的核心数统计数据。

内存

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

您可通过以下命令设置内存：

bash
docker run --name='activemq' -it --rm \
	-e 'ACTIVEMQ_CONFIG_MINMEMORY=512' \
	-e 'ACTIVEMQ_CONFIG_MAXMEMORY=2048'\
        -P
	webcenter/activemq:latest

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

存储

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

贡献

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

• 提交Pull Request以添加新功能或修复Bug；
• 帮助解决其他用户遇到的https://github.com/disaster37/activemq/issues；
• 通过或Gratipay。

问题

Fedora/RHEL/CentOS用户可尝试通过setenforce 0禁用selinux以解决问题。若禁用后问题解决，建议切换至Ubuntu或保持selinux禁用（不推荐）。

若使用最新Docker版本或禁用selinux仍无法解决问题，请在https://github.com/disaster/activemq/issues页面提交请求，并提供以下信息：

• 主机发行版及版本；
• docker version命令输出；
• docker info命令输出；
• 您使用的docker run命令（屏蔽敏感信息）。

安装

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

bash
docker pull docker.xuanyuan.run/webcenter/activemq:5.15.2

也可拉取latest标签（从仓库HEAD构建）：

bash
docker pull docker.xuanyuan.run/webcenter/activemq:latest

或本地构建：

bash
git clone https://github.com/disaster37/activemq.git
cd activemq
docker build --tag="$USER/activemq" .

快速开始

测试环境

bash
docker run --name='activemq' -it --rm -P \
docker.xuanyuan.run/webcenter/activemq:latest

默认管理员账号：admin，密码：admin。

生产环境

bash
docker run --name='activemq' -d \
-e 'ACTIVEMQ_CONFIG_NAME=amqp-srv1' \
-e 'ACTIVEMQ_CONFIG_DEFAULTACCOUNT=false' \
-e 'ACTIVEMQ_ADMIN_LOGIN=admin' -e 'ACTIVEMQ_ADMIN_PASSWORD=your_password' \
-e 'ACTIVEMQ_USERS_myproducer=producerpassword' -e 'ACTIVEMQ_GROUPS_writes=myproducer' \
-e 'ACTIVEMQ_USERS_myconsumer=consumerpassword' -e 'ACTIVEMQ_GROUPS_reads=myconsumer' \
-e 'ACTIVEMQ_JMX_user1_role=readwrite' -e 'ACTIVEMQ_JMX_user1_password=jmx_password' \
-e 'ACTIVEMQ_JMX_user2_role=read' -e 'ACTIVEMQ_JMX_user2_password=jmx2_password' \
-e 'ACTIVEMQ_CONFIG_TOPICS_topic1=mytopic1' -e 'ACTIVEMQ_CONFIG_TOPICS_topic2=mytopic2'  \
-e 'ACTIVEMQ_CONFIG_QUEUES_queue1=myqueue1' -e 'ACTIVEMQ_CONFIG_QUEUES_queue2=myqueue2'  \
-e 'ACTIVEMQ_CONFIG_MINMEMORY=1024' -e 'ACTIVEMQ_CONFIG_MAXMEMORY=4096' \
-e 'ACTIVEMQ_CONFIG_SCHEDULERENABLED=true' \
-v /data/activemq:/data \
-v /var/log/activemq:/var/log/activemq \
-p 8161:8161 \
-p 61616:61616 \
-p 61613:61613 \
docker.xuanyuan.run/webcenter/activemq:5.14.3

Docker Compose

bash
wget https://raw.githubusercontent.com/disaster37/activemq/master/docker-compose.yml
docker-compose up

配置

访问控制

普通用户

• ACTIVEMQ_USERS_X: X为用户名，值为密码；
• ACTIVEMQ_GROUPS_Y: Y为组名，值为用户列表（逗号分隔）。

可用组权限：

• writes: 读写所有队列/主题；
• reads: 只读所有队列/主题；
• owners: 读写及拥有所有队列/主题。

管理员用户

• ACTIVEMQ_ADMIN_LOGIN: 管理员账号；
• ACTIVEMQ_ADMIN_PASSWORD: 管理员密码。

禁用默认账号

• ACTIVEMQ_CONFIG_DEFAULTACCOUNT: 设置为false禁用默认账号。

队列

• ACTIVEMQ_CONFIG_QUEUES_X: X为逻辑名称（无特殊字符），值为实际队列名称。

主题

• ACTIVEMQ_CONFIG_TOPICS_X: X为逻辑名称（无特殊字符），值为实际主题名称。

数据存储

当前仅支持kahadb，数据存储路径为/data。

Broker

待补充。

磁盘使用

• ACTIVEMQ_CONFIG_STOREUSAGE: 存储使用限制，默认100GB；
• ACTIVEMQ_CONFIG_TEMPUSAGE: 临时存储限制，默认50GB。

JMX

• ACTIVEMQ_JMX_X_ROLE: X为用户名，值为角色（read/readwrite）；
• ACTIVEMQ_JMX_X_PASSWORD: X为用户名，值为密码。

可用配置参数

Confd

• CONFD_BACKEND: 配置后端，默认env；
• CONFD_NODES: 后端URL数组；
• CONFD_PREFIX_KEY: 前缀键，默认/activemq。

ActiveMQ参数

• ACTIVEMQ_CONFIG_NAME: 主机名，默认localhost；
• ACTIVEMQ_LOGGER_LOGLEVEL: 日志级别，默认INFO；
• ACTIVEMQ_CONFIG_PENDINGMESSAGELIMIT: 待处理消息限制，默认1000；
• ACTIVEMQ_CONFIG_STORAGEUSAGE: 存储使用限制，默认100GB；
• ACTIVEMQ_CONFIG_TEMPUSAGE: 临时存储限制，默认50GB；
• ACTIVEMQ_CONFIG_MAXCONNECTION: 最大并发连接数，默认1000；
• ACTIVEMQ_CONFIG_FRAMESIZE: 帧大小限制，默认***（100MB）；
• ACTIVEMQ_CONFIG_SCHEDULERENABLED: 启用调度器，默认true；
• ACTIVEMQ_CONFIG_AUTHENABLED: 启用认证，默认false；
• ACTIVEMQ_CONFIG_MINMEMORY: 初始内存（MB），默认128；
• ACTIVEMQ_CONFIG_MAXMEMORY: 最大内存（MB），默认1024；
• ACTIVEMQ_DEFAULTACCOUNT: 启用默认账号，默认true；
• ACTIVEMQ_ADMIN_LOGIN: 管理员账号，默认admin；
• ACTIVEMQ_ADMIN_PASSWORD: 管理员密码，默认admin。

高级配置

如需高级配置，建议参考ActiveMQ官方文档并创建自定义配置文件（如activemq.xml）。可通过挂载配置文件（-v /your_path/conf:/opt/activemq/conf）或基于此镜像构建自定义镜像实现。

参考

• ActiveMQ官方文档
• Docker官方文档
• Confd官方文档