lhstack/rocketmq

RocketMQ Alpine镜像文档

镜像概述

本镜像为基于Alpine Linux的RocketMQ轻量级部署方案，集成了RocketMQ核心组件（Namesrv、Broker）及管理控制台（Dashboard），提供了Docker Compose和Kubernetes两种部署方式，适用于开发、测试及轻量级生产环境的消息队列部署与管理。

核心功能与特性

• 组件完整：包含Namesrv（命名服务）、Broker（消息代理）和Dashboard（Web管理界面）
• 轻量级：基于Alpine Linux，镜像体积小，资源占用低
• 灵活配置：支持通过环境变量、配置文件自定义参数
• 安全支持：集成ACL权限控制、TLS加密及登录认证
• 多环境部署：提供Docker Compose单机部署和Kubernetes集群部署配置

使用场景

• 开发环境消息队列快速搭建
• 测试环境消息通信验证
• 轻量级生产环境消息服务部署
• 需要可视化管理界面的RocketMQ应用场景

使用方法

1. Docker Compose部署

1.1 Dashboard部署

yaml
version: '3'
services:
  dashboard:
    container_name: dashboard
    image: lhstack/rocketmq:dashboard-5.1.0
    ports:
    - '8080:8080'  # 管理界面端口
    environment:
      NAMESRV_ADDRS: "192.168.3.188:9876,192.168.3.188:9886"  # 多个Namesrv地址用逗号分隔
      ACCESS_KEY: "RocketMq"  # ACL启用时的访问密钥
      SECRET_KEY: "12345678"  # ACL启用时的密钥
      USE_TLS: true  # 是否启用TLS加密
      LOGIN_REQUIRED: true  # 是否需要登录认证（对应DATA/users.properties）
      DATA: /root/data  # 数据保存路径
      MSG_TRACK_TOPIC_NAME: "test-track-topic"  # 自定义消息轨迹Topic
    deploy:
      resources:
        limits:
          cpus: 50m
          memory: 512M
    logging:
      options:
        max-size: 1k
        max-file: 1

1.2 RocketMQ服务部署（Namesrv+Broker）

yaml
version: '3'
services:
  namesrv:
    container_name: namesrv
    image: lhstack/rocketmq:4.9.3-alpine
    environment:
      JAVA_OPT: "-Xmx64m -Xms64m -XX:MaxMetaspaceSize=32m"  # JVM参数
    logging:
      options:
        max-file: '1'
        max-size: '16k'
    restart: always
    ports:
    - '9886:9886'  # Namesrv服务端口
    deploy:
      resources:
        limits:
          cpus: '0.5'
          memory: '128M'
    networks:
      rocketmq:
        ipv4_address: 168.128.98.76  # 固定IP
    command:
    - sh
    - -c
    - |
      cat >/namesrv.properties<<EOF
      listenPort=9886  # 监听端口
      useEpollNativeSelector=true  # 使用Epoll选择器
      EOF
      mqnamesrv -c /namesrv.properties  # 启动Namesrv

  broker:
    container_name: broker
    image: lhstack/rocketmq:4.9.3-alpine
    environment:
      JAVA_OPT: "-Xmx384m -Xms384m -XX:MaxMetaspaceSize=128m"  # JVM参数
    depends_on:
    - namesrv  # 依赖Namesrv服务
    logging:
      options:
        max-file: '1'
        max-size: '16k'
    restart: always
    deploy:
      resources:
        limits:
          cpus: '0.5'
          memory: '512M'
    network_mode: host  # 使用主机网络
    command:
    - sh
    - -c
    - |
      cat > /broker.conf<<EOF
      brokerClusterName = DefaultCluster  # 集群名称
      brokerName = broker-a  # Broker名称
      brokerId = 0  # Broker ID（0为主节点）
      deleteWhen = 04  # 清理过期文件时间（凌晨4点）
      fileReservedTime = 48  # 文件保留时间（小时）
      brokerRole = ASYNC_MASTER  # Broker角色（异步主节点）
      flushDiskType = ASYNC_FLUSH  # 刷盘方式（异步刷盘）
      aclEnable = false  # 是否启用ACL
      listenPort = 10922  # Broker服务端口
      namesrvAddr = 168.128.98.76:9886  # Namesrv地址
      EOF
      mqbroker -c /broker.conf  # 启动Broker

networks:
  rocketmq:
    driver: bridge
    ipam:
      driver: default
      config:
      - subnet: '168.128.0.0/16'  # 网络子网

2. Kubernetes部署

2.1 服务与配置定义

yaml
# Namesrv服务
apiVersion: v1
kind: Service
metadata:
  name: rocketmq-namesrv
spec:
  type: ClusterIP
  ports:
  - name: tcp
    port: 9876  # 服务端口
  selector:
    app: rocketmq-namesrv  # 匹配Pod标签

---
# 配置集
apiVersion: v1
kind: ConfigMap
metadata:
  name: rocketmq
data:
  # Namesrv配置
  namesrv.properties: |
    listenPort=9876
    useEpollNativeSelector=true
  
  # Broker配置
  broker.conf: |
    brokerClusterName = DefaultCluster
    brokerName = broker-a
    brokerId = 0
    deleteWhen = 04
    fileReservedTime = 48
    brokerRole = ASYNC_MASTER
    flushDiskType = ASYNC_FLUSH
    aclEnable = true  # 启用ACL
    listenPort = 10911
    namesrvAddr = rocketmq-namesrv.default.svc.cluster.local:9876  # Kubernetes内部Namesrv地址
  
  # ACL配置
  plain-acl.yml: |
    globalWhiteRemoteAddresses: 
    accounts:
    - accessKey: RocketMq  # 管理员账号
      secretKey: 12345678
      whiteRemoteAddress:
      admin: true
    - accessKey: TestAccount  # 普通用户账号
      secretKey: TestSecret
      whiteRemoteAddress:
      admin: false
      defaultTopicPerm: DENY
      defaultGroupPerm: SUB
      topicPerms:
      - topicA=DENY
      groupPerms:
      - groupA=DENY

2.2 Namesrv Pod部署

yaml
apiVersion: v1
kind: Pod
metadata:
  name: rocketmq-namesrv
  labels:
    app: rocketmq-namesrv
spec:
  volumes:
  - name: conf
    configMap:
      name: rocketmq
      items:
      - key: namesrv.properties
        path: namesrv.properties  # 挂载配置文件
  containers:
  - name: rocketmq-namesrv
    image: lhstack/rocketmq
    imagePullPolicy: IfNotPresent
    volumeMounts:
    - name: conf
      mountPath: /namesrv.properties
      subPath: namesrv.properties
    resources:
      requests:
        cpu: 10m
        memory: 32Mi
      limits:
        cpu: 20m
        memory: 64Mi
    ports:
    - name: tcp
      containerPort: 9876
    env:
    - name: JAVA_OPT
      value: "-Xmx64m -Xms64m -Xmn1m"  # JVM参数
    command:
    - sh
    - -c
    - |
      mqnamesrv -c /namesrv.properties  # 启动Namesrv

2.3 Broker Deployment部署

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: rocketmq-broker
spec:
  replicas: 1  # 副本数
  selector:
    matchLabels:
      app: rocketmq-broker
  template:
    metadata:
      labels:
        app: rocketmq-broker
    spec:
      volumes:
      - name: conf
        configMap:
          name: rocketmq
          items:
          - key: broker.conf
            path: broker.conf  # Broker配置
      - name: plain
        configMap:
          name: rocketmq
          items:
          - key: plain-acl.yml
            path: plain-acl.yml  # ACL配置
      - name: data
        hostPath:
          path: /home/rocketmq/data  # 数据持久化路径
      containers:
      - name: rocketmq-broker
        image: lhstack/rocketmq
        imagePullPolicy: IfNotPresent
        ports:
        - name: tcp
          containerPort: 10911
        resources:
          requests:
            cpu: 50m
            memory: 128Mi
          limits:
            cpu: 100m
            memory: 1.2Gi
        env:
        - name: JAVA_OPT
          value: "-Xmx1g -Xms1g"  # JVM参数
        volumeMounts:
        - name: data
          mountPath: /root  # 数据挂载点
        - name: conf
          mountPath: /broker.conf
          subPath: broker.conf
        - name: plain
          mountPath: /rocketmq/conf/plain_acl.yml
          subPath: plain-acl.yml
        command:
        - sh
        - -c
        - mqbroker -c /broker.conf  # 启动Broker

配置参数说明

Dashboard环境变量

Namesrv配置文件（namesrv.properties）

Broker配置文件（broker.conf）

ACL配置文件（plain-acl.yml）