跳到主要内容
版本: 5.0

在本地运行 RocketMQ

本节将介绍快速部署单节点 RocketMQ 集群的步骤;其中还包括发送和接收消息的命令,作为工作证明。

系统要求
  1. 64位操作系统,推荐使用 Linux/Unix/macOS
  2. 64位 JDK 1.8+

1. 获取 Apache RocketMQ

下载 RocketMQ

Apache RocketMQ 同时提供二进制包和源代码包。点击 此处下载 Apache RocketMQ 5.3.2 源代码包。您也可以选择预构建的二进制包,该包已编译完成,可直接运行。

以下说明以在 Linux 环境中使用 RocketMQ 5.3.2 源代码包为例,介绍 RocketMQ 的安装过程。

解压 RocketMQ 5.3.2 源代码包,然后编译并构建二进制可执行文件

$ unzip rocketmq-all-5.3.2-source-release.zip
$ cd rocketmq-all-5.3.2-source-release/
$ mvn -Prelease-all -DskipTests -Dspotbugs.skip=true clean install -U
$ cd distribution/target/rocketmq-5.3.2/rocketmq-5.3.2

2. 启动 NameServer

安装 RocketMQ 后,启动 NameServer

### start namesrv
$ nohup sh bin/mqnamesrv &

### verify namesrv
$ tail -f ~/logs/rocketmqlogs/namesrv.log
The Name Server boot success...
信息

当在 namesrv.log 中看到 'The Name Server boot success..' 时,表示 NameServer 已成功启动。

3. 启动 Broker 和 Proxy

NameServer 启动后,我们需要启动 Broker 和 Proxy。我们推荐本地部署模式,其中 Broker 和 Proxy 部署在同一个进程中。我们也支持集群部署模式。了解更多信息,请参阅部署介绍

### start broker
$ nohup sh bin/mqbroker -n localhost:9876 --enable-proxy &

### verify broker
$ tail -f ~/logs/rocketmqlogs/proxy.log
The broker[broker-a,192.169.1.2:10911] boot success...
信息

当看到“The broker[brokerName,ip:port]boot success..” 从 proxy.log 中出现时,表示 Broker 已成功启动。

注意

至此,单主 RocketMQ 集群已部署完成,我们可以通过脚本发送和接收简单的消息。

4. 使用工具发送和接收消息

在使用工具测试之前,我们需要将 nameserver 地址设置到系统中,例如系统环境变量 NAMESRV_ADDR

$ export NAMESRV_ADDR=localhost:9876
$ sh bin/tools.sh org.apache.rocketmq.example.quickstart.Producer
SendResult [sendStatus=SEND_OK, msgId= ...

$ sh bin/tools.sh org.apache.rocketmq.example.quickstart.Consumer
ConsumeMessageThread_%d Receive New Messages: [MessageExt...

5. 使用 SDK 发送和接收消息

我们也可以尝试使用客户端 SDK 发送和接收消息,更多详情请参见 rocketmq-clients

  1. 创建一个 Java 项目。

  2. 将 SDK 依赖添加到 pom.xml 中,请记住将 rocketmq-client-java-version 替换为最新版本

    <dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-client-java</artifactId>
    <version>${rocketmq-client-java-version}</version>
    </dependency>
  3. 使用 mqadmin 命令行工具创建 Topic。

    $ sh bin/mqadmin updatetopic -n localhost:9876 -t TestTopic -c DefaultCluster
  4. 在您创建的 Java 项目中,创建一个发送消息的程序,并使用以下代码运行它

    import java.io.IOException;
    import org.apache.rocketmq.client.apis.ClientConfiguration;
    import org.apache.rocketmq.client.apis.ClientConfigurationBuilder;
    import org.apache.rocketmq.client.apis.ClientException;
    import org.apache.rocketmq.client.apis.ClientServiceProvider;
    import org.apache.rocketmq.client.apis.message.Message;
    import org.apache.rocketmq.client.apis.producer.Producer;
    import org.apache.rocketmq.client.apis.producer.SendReceipt;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;

    public class ProducerExample {
    private static final Logger logger = LoggerFactory.getLogger(ProducerExample.class);

    public static void main(String[] args) throws ClientException, IOException {
    String endpoint = "localhost:8081";
    String topic = "TestTopic";
    ClientServiceProvider provider = ClientServiceProvider.loadService();
    ClientConfigurationBuilder builder = ClientConfiguration.newBuilder().setEndpoints(endpoint);
    ClientConfiguration configuration = builder.build();
    Producer producer = provider.newProducerBuilder()
    .setTopics(topic)
    .setClientConfiguration(configuration)
    .build();
    Message message = provider.newMessageBuilder()
    .setTopic(topic)
    .setKeys("messageKey")
    .setTag("messageTag")
    .setBody("messageBody".getBytes())
    .build();
    try {
    SendReceipt sendReceipt = producer.send(message);
    logger.info("Send message successfully, messageId={}", sendReceipt.getMessageId());
    } catch (ClientException e) {
    logger.error("Failed to send message", e);
    }
    // producer.close();
    }
    }
  5. 在您创建的 Java 项目中,创建一个消费者示例程序并运行它。Apache RocketMQ 支持 SimpleConsumerPushConsumer

    import java.io.IOException;
    import java.util.Collections;
    import org.apache.rocketmq.client.apis.ClientConfiguration;
    import org.apache.rocketmq.client.apis.ClientException;
    import org.apache.rocketmq.client.apis.ClientServiceProvider;
    import org.apache.rocketmq.client.apis.consumer.ConsumeResult;
    import org.apache.rocketmq.client.apis.consumer.FilterExpression;
    import org.apache.rocketmq.client.apis.consumer.FilterExpressionType;
    import org.apache.rocketmq.client.apis.consumer.PushConsumer;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;

    public class PushConsumerExample {
    private static final Logger logger = LoggerFactory.getLogger(PushConsumerExample.class);

    private PushConsumerExample() {
    }

    public static void main(String[] args) throws ClientException, IOException, InterruptedException {
    final ClientServiceProvider provider = ClientServiceProvider.loadService();
    String endpoints = "localhost:8081";
    ClientConfiguration clientConfiguration = ClientConfiguration.newBuilder()
    .setEndpoints(endpoints)
    .build();
    String tag = "*";
    FilterExpression filterExpression = new FilterExpression(tag, FilterExpressionType.TAG);
    String consumerGroup = "YourConsumerGroup";
    String topic = "TestTopic";
    PushConsumer pushConsumer = provider.newPushConsumerBuilder()
    .setClientConfiguration(clientConfiguration)
    .setConsumerGroup(consumerGroup)
    .setSubscriptionExpressions(Collections.singletonMap(topic, filterExpression))
    .setMessageListener(messageView -> {
    logger.info("Consume message successfully, messageId={}", messageView.getMessageId());
    return ConsumeResult.SUCCESS;
    })
    .build();
    Thread.sleep(Long.MAX_VALUE);
    // pushConsumer.close();
    }
    }

6. 关闭服务器

完成实践后,我们可以使用以下命令关闭服务。

$ sh bin/mqshutdown broker
The mqbroker(36695) is running...
Send shutdown request to mqbroker(36695) OK

$ sh bin/mqshutdown namesrv
The mqnamesrv(36664) is running...
Send shutdown request to mqnamesrv(36664) OK