phanducthinh/active-mq

ActiveMQ 6.1.4 Docker镜像（适用于OpenShift Container Platform）

镜像概述和主要用途

本镜像是为OpenShift Container Platform（v3.x或v4.x）环境打包的ActiveMQ 6.1.4 Docker镜像，将Apache ActiveMQ消息中间件整洁封装，便于在容器化环境中快速部署和运行，提供可靠的消息传递服务。

核心功能和特性

• 基于ActiveMQ 6.1.4：集成最新稳定版ActiveMQ消息中间件，支持多种消息协议（如AMQP、MQTT、OpenWire等）。
• 适配OpenShift平台：优化容器配置，兼容OpenShift Container Platform v3.x及v4.x版本。
• 可靠的基础镜像：基于Red Hat UBI9（Universal Base Image 9）构建，集成OpenJDK 17运行时环境，确保稳定性和安全性。
• 自动数据初始化：首次启动时，若/var/lib/activemq目录为空，自动初始化该目录，配置ActiveMQ基础环境。
• 权限自动调整：启动过程中自动将/var/lib/activemq目录下所有文件和文件夹的所有者更新为activemq用户，保障运行权限合规。
• 数据持久化支持：声明/var/lib/activemq为数据卷，支持持久化存储ActiveMQ配置、消息数据等。

使用场景和适用范围

• OpenShift环境部署：适用于在OpenShift Container Platform（v3.x或v4.x）上部署ActiveMQ消息中间件的场景。
• 企业级消息传递：支持企业应用间的异步通信、服务解耦、消息队列管理等需求。
• 微服务架构集成：作为微服务架构中的消息中间件，实现服务间可靠的消息传递。
• 开发与测试环境：可快速启动独立的ActiveMQ实例，用于本地开发、测试或CI/CD流程。

标签历史

使用方法和配置说明

启动实例

基本启动命令

通过以下命令启动ActiveMQ实例，映射默认端口（61616为消息端口，8161为管理控制台端口）：

bash
docker run --name activemq-instance -p 61616:61616 -p 8161:8161 -d phanducthinh/active-mq  

带额外参数启动

如需查看支持的启动参数，可添加--help：

bash
docker run --name activemq-instance -p 61616:61616 -p 8161:8161 -d phanducthinh/active-mq --help  

启动行为说明

• 首次启动初始化：容器首次启动时，会检查/var/lib/activemq目录是否为空，若为空则自动初始化该目录（创建基础配置文件、数据结构等）。
• 权限更新：启动过程中，容器会将/var/lib/activemq目录下所有文件和文件夹的所有者更新为activemq用户，确保运行权限正确。

环境变量

可通过环境变量配置ActiveMQ运行参数，详细参数需参考ActiveMQ官方文档。常用环境变量如下：

数据卷

本镜像将ActiveMQ的基础目录（/var/lib/activemq，即ACTIVEMQ_BASE）声明为数据卷，用于持久化存储配置文件、消息数据、日志等。建议通过外部卷挂载该目录，确保数据持久化：

bash
docker run --name activemq-instance -p 61616:61616 -p 8161:8161 -v /host/path/to/activemq-data:/var/lib/activemq -d phanducthinh/active-mq  

Docker Compose配置示例

以下是使用docker-compose.yml部署ActiveMQ的示例，包含数据卷挂载和端口映射：

yaml
version: '3.8'  
services:  
  activemq:  
    image: phanducthinh/active-mq  
    container_name: activemq-instance  
    ports:  
      - "61616:61616"  # 消息端口（OpenWire协议）  
      - "8161:8161"    # 管理控制台端口  
    environment:  
      - ACTIVEMQ_OPTS_MEMORY=-Xms512M -Xmx1G  # JVM内存配置  
    volumes:  
      - activemq-data:/var/lib/activemq  # 数据卷持久化  
    restart: unless-stopped  

volumes:  
  activemq-data:  # 声明命名卷，数据持久化到宿主机  

启动命令：docker-compose up -d

注意事项

• 端口映射：默认需映射61616（消息通信）和8161（Web管理控制台）端口，具体端口可根据ActiveMQ配置调整。
• 权限管理：容器内部使用activemq用户运行，挂载外部目录时需确保宿主机目录权限允许该用户访问。
• 版本兼容性：不同镜像标签对应不同ActiveMQ版本和基础镜像，部署时需根据实际需求选择合适标签（如latest对应ActiveMQ 6.1.4）。