rocketmq 部署啟動指南-Docker 版

2019 年 10 月 3 日
筆記

最近學習使用 rocketmq，需要搭建 rocketmq 服務端，本文主要記錄 rocketmq 搭建過程以及這個過程踩到的一些坑。

準備工作

在搭建之前，我們需要做一些準備工作，這裡我們需要使用 docker 搭建服務，所以需要提前安裝 docker。此外，由於 rocketmq 需要部署 broker 與 nameserver ，考慮到分開部署比較麻煩，這裡將會使用 docker-compose。

rocketmq 架構圖如下:

另外，還需要搭建一個 web 可視化控制台，可以監控 mq 服務狀態，以及消息消費情況，這裡使用 rocketmq-console，同樣該程式也將使用 docker 安裝。

部署過程

首先我們需要 rocketmq docker 鏡像，這裡我們可以選擇自己製作，直接拉取 [email protected]:apache/rocketmq-docker.git ，然後再製作鏡像。另外還可以直接使用 docker hub 上官方製作的鏡像，鏡像名： rocketmqinc/rocketmq。

接著創建 mq 配置文件 broker.conf，文件放置到 /opt/rocketmq/conf ，配置如下:

brokerClusterName = DefaultCluster  brokerName = broker-a  brokerId = 0  deleteWhen = 04  fileReservedTime = 48  brokerRole = ASYNC_MASTER  flushDiskType = ASYNC_FLUSH  # 如果是本地程式調用雲主機 mq，這個需要設置成 雲主機 IP  brokerIP1=10.10.101.80

在創建如下文件夾：/opt/rocketmq/logs，/opt/rocketmq/store，最後創建 docker-compose.yml 文件，配置如下：

version: '2'  services:    namesrv:      image: rocketmqinc/rocketmq      container_name: rmqnamesrv      ports:        - 9876:9876      volumes:        - /opt/rocketmq/logs:/home/rocketmq/logs        - /opt/rocketmq/store:/home/rocketmq/store      command: sh mqnamesrv    broker:      image: rocketmqinc/rocketmq      container_name: rmqbroker      ports:        - 10909:10909        - 10911:10911        - 10912:10912      volumes:        - /opt/rocketmq/logs:/home/rocketmq/logs        - /opt/rocketmq/store:/home/rocketmq/store        - /opt/rocketmq/conf/broker.conf:/opt/rocketmq-4.4.0/conf/broker.conf      #command: sh mqbroker -n namesrv:9876      command: sh mqbroker -n namesrv:9876 -c ../conf/broker.conf      depends_on:        - namesrv      environment:        - JAVA_HOME=/usr/lib/jvm/jre    console:      image: styletang/rocketmq-console-ng      container_name: rocketmq-console-ng      ports:        - 8087:8080      depends_on:        - namesrv      environment:        - JAVA_OPTS= -Dlogging.level.root=info   -Drocketmq.namesrv.addr=rmqnamesrv:9876        - Dcom.rocketmq.sendMessageWithVIPChannel=false

注意點

這裡需要注意 rocketmq broker 與 rokcetmq-console 都需要與 rokcetmq nameserver 連接，需要知道 nameserver ip。使用 docker-compose 之後，上面三個 docker 容器將會一起編排，可以直接使用容器名代替容器 ip，如這裡 nameserver 容器名 rmqnamesrv。

配置完成之後，運行 docker-compose up 啟動三個容器，啟動成功後，訪問 ip:8087，查看 mq 外部控制台，如果可以看到以下資訊，rocketmq 服務啟動成功。

初體驗 rocketmq

這裡將會使用 springboot 快速上手使用 mq，將會使用 rocketmq-spring-boot-starter 模組，pom 配置如下：

<!--在pom.xml中添加依賴-->  <dependency>      <groupId>org.apache.rocketmq</groupId>      <artifactId>rocketmq-spring-boot-starter</artifactId>      <version>2.0.3</version>  </dependency>

消費服務發送方配置如下：

## application.properties  rocketmq.name-server=ip:9876  rocketmq.producer.group=my-group

消費服務發送方程式如下：

@SpringBootApplication  public class ProducerApplication implements CommandLineRunner {      @Resource      private RocketMQTemplate rocketMQTemplate;        public static void main(String[] args){          SpringApplication.run(ProducerApplication.class, args);      }        public void run(String... args) throws Exception {          rocketMQTemplate.convertAndSend("test-topic-1", "Hello, World!");          rocketMQTemplate.send("test-topic-1", MessageBuilder.withPayload("Hello, World! I'm from spring message").build());      }    }

消息消費方配置如下：

## application.properties  rocketmq.name-server=ip:9876

消息消費方運行程式如下：

@SpringBootApplication  public class ConsumerApplication{        public static void main(String[] args){          SpringApplication.run(ConsumerApplication.class, args);      }        @Slf4j      @Service      @RocketMQMessageListener(topic = "test-topic-1", consumerGroup = "my-consumer_test-topic-1")      public static class MyConsumer1 implements RocketMQListener<String> {          public void onMessage(String message) {              log.info("received message: {}", message);          }      }  }

幫助文檔

rocketmq-docker
RocketMq docker 搭建和基本概念
 RocketMQ-Spring

我的部落格即將同步至騰訊雲+社區，邀請大家一同入駐：https://cloud.tencent.com/developer/support-plan?invite_code=z2e3cwkcr4x9