RocketMQ的单机部署

最新推荐文章于 2024-11-19 21:59:34 发布

原创

最新推荐文章于 2024-11-19 21:59:34 发布 · 3.1k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#java #RocketMQ

本文详细介绍了如何在Mac上单机部署RocketMQ，包括前置条件、下载源码、启动NameServer和Broker Server，以及生产者和消费者的Example。通过实践，加深了对RocketMQ的理解。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1 前言

承接着我的上一篇文章RocketMQ的概念与特性，相信大家对RocketMQ都有了一定地了解，为了进一步深入学习RocketMQ的设计，我们要把它的源码部署起来并启动运行，接下来就一步步让RocketMQ在我们的Mac上跑起来吧！

2 前置条件

部署前，我们的Mac需要具备如下软件：

JDK 1.8
Maven 3.2.X+
IDEA

因为本次的部署需要直接编译RocketMQ源码，构建出RocketMQ可执行包。

3 下载源码

打开RocketMQ在Github上的主页，获取仓库地址，然后在本地电脑上克隆本仓库。

git clone https://github.com/apache/rocketmq.git

4 启动RocketMQ服务器

4.1 启动NameServer

根据RocketMQ的概念，我们知道，NameServer 名称服务充当路由消息的提供者，生产者或消费者能够通过名字服务查找各主题相应的Broker IP列表。可以把NameServer理解为RocketMQ的路由中心，它提供轻量级服务发现和路由，主要的作用是存储路由信息，管理broker节点，包括路由的查找、注册和删除。因此，我们第一步是需要将Name Server启动。

在RocketMQ工程的namesrv包中找到入口类org.apache.rocketmq.namesrv.NamesrvStartup，运行这个类的main函数，发现报错了。

Please set the ROCKETMQ_HOME variable in your environment to match the location of the RocketMQ installation

这个报错是因为在为nameserver设置相关配置时没有设置成功。报错的代码段如下：

if (null == namesrvConfig.getRocketmqHome()) {
   
   
    System.out.printf("Please set the %s variable in your environment to match the location of the RocketMQ installation%n", MixAll.ROCKETMQ_HOME_ENV);
    System.exit(-2);
}

这是提示我们，需要配置一个ROCKETMQ_HOME 的环境变量

public static final String ROCKETMQ_HOME_ENV = "ROCKETMQ_HOME";

为此，我们需要将distribution所在的目录作为路由中心的路径/Users/bytedance/IdeaProjects/rocketmq-all-4.9.2/distribution，并在IDEA配置它为环境变量：

在这里插入图片描述
再次运行main函数，就会发现启动成功。

4.2 启动Broker Server

根据RocketMQ的概念，我们知道，Broker是消息中转角色，负责存储消息、转发消息。代理服务器在RocketMQ系统中负责接收从生产者发送来的消息并存储、同时为消费者的拉取请求作准备。另外，Broker也存储消息相关的元数据，包括消费者组、消费进度偏移和主题和队列消息等。因此，接下来，我们需要将Broker Server启动。

前面我们在本地启动了Name Server，我们需要知道Name Server的IP地址和端口号，并告诉Broker Server，Broker Server才能够到指定的Name Server去注册它的信息，从而让生产者或者消费者去Name Server找到Broker Server，并进行消息的生成与消费。

通过阅读代码可以知道，Name Server在启动时会启动一个Netty服务器，用于网络传输，Netty监听的端口号为9876，因此Name Server的监听地址就为：127.0.0.1:9876

    public static NamesrvController createNamesrvController(String[] args) throws IOException, JoranException {
   
   
       // ......
        final NamesrvConfig namesrvConfig = new NamesrvConfig();
        final