RocketMQ概念详细之NameServer

在Apache RocketMQ,域名服务器 被设计为协调分布式系统的每个组件,协调主要通过管理主题路由信息来实现。

管理由两部分组成:

  • Broker定期更新保存在每一个NameServer中的元数据
  • NameServer为客户端提供服务,包括生产者,消费者和带有最新路由信息的命令行客户端。

因此,在启动broker和客户端之前,我们需要告诉它们如何通过向NameServer提供域名服务地址列表访问name servers。

在Apache RocketMQ,可以通过四种方式完成。

编程方式

对于Broker,你可以在broker配置文件中指定namesrvAddr=name-server-ip1:port;name-server-ip2:port。
对于生产者和消费者,我们可以像下面提供 NameServer地址列表:

//生产者
DefaultMQProducer producer = new DefaultMQProducer("please_rename_unique_group_name");
producer.setNamesrvAddr("name-server1-ip:port;name-server2-ip:port");

//消费者
DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("please_rename_unique_group_name");
consumer.setNamesrvAddr("name-server1-ip:port;name-server2-ip:port");

如果你使用 shell admin命令行,你可以像这样指定:

sh mqadmin command-name -n name-server-ip1:port;name-server-ip2:port -X OTHER-OPTION

简单例子:sh mqadmin -n localhost:9876 clusterList 假设在NameServer节点查询集群信息。

如果你已经将admin tool整合在你自己的仪表盘,你可以:

DefaultMQAdminExt defaultMQAdminExt = new DefaultMQAdminExt("please_rename_unique_group_name");
defaultMQAdminExt.setNamesrvAddr("name-server1-ip:port;name-server2-ip:port");

java选项

NameServer地址列表可以在启动前通过指定java选项 rocketmq.namesrv.addr 提供给你的应用。

环境变量

你可以export NAMESRV_ADDR 环境变量。如果设置,Brokers和clients将会检查和使用它。

HTTP Endpoint

如果你没有使用上面提到的方法指定NameServer地址列表,RocketMQ将访问以下http端点,每两分钟获取和更新NameServer地址列表,初始延迟10秒。

默认,端点:

http://jmenv.tbsite.net:8080/rocketmq/nsaddr

你可以覆盖jmenv.tbsite.net使用java选项:rocketmq.namesrv.domain,你也可以覆盖nsaddr 部分使用java选项:rocketmq.namesrv.domain.subgroup。

如果你在生产中已经运行RocketMQ,推荐使用这种方法,因为它提供了最大的灵活性。你可以根据NameServer系统的负载动态增加或移除NameServer节点,而无需重新启动brokers 和clients。

优先级

Programmatic Way > Java Options > Environment Variable > HTTP Endpoint

你可能感兴趣的:(RocketMQ概念详细之NameServer)