学习黑马程序员的RocketMQ视频,视频地址:https://www.bilibili.com/video/BV1L4411y7mn?from=search&seid=2400336878616684276
1. MQ介绍
1.1 为什么要用MQ
MQ(Message Queue)消息队列是一种”先进先出“的数据结构
其应用场景主要包含以下3个方面
-
应用解耦
使用消息队列解耦合,系统的耦合性就提高了。比如物流系统发生了故障,需要几分钟才能修复,在这段时间内,物流系统要处理的数据被缓存到消息队列中,用户的下单操作正常完成。当物流系统恢复后,补充处理存在消息队列中的订单消息即可,终端系统感知不到物流系统发生过几分钟故障。
-
流量消峰
应用系统如果遇到系统请求流量的瞬间猛增,有可能会将系统压垮。有了消息队列可以将大量请求缓存起来,分散到很长一段时间处理,这样可以大大提高系统的稳定性和用户体验。
一般情况,为了保证系统的稳定性,如果系统负载超过阈值,就会阻止用户请求,这会影响用户体验,而如果使用消息队列将请求缓存起来,等待系统处理完毕后通知用户下单完毕,这样总比不能下单体验好。
处于经济考量目的:业务系统正常时段的QPS如果是1000,流量最高峰是10000,为了应对流量高峰配置高新能的服务器显然不划算,这时可以使用消息队列对巅峰流量消峰。
- 数据分发
通过消息队列可以让数据在多个系统之间进行流通,数据的产生不需要关系谁来使用数据,只需要将数据发送到消息队列,数据使用方直接在消息队列中直接获取数据即可。
1.2 MQ的优点和缺点
优点:解耦、消峰、数据分发
缺点包含以下几点:
系统可用性降低:系统引入外部依赖越多,系统稳定性越差,一旦MQ宕机,就会对业务造成影响。
如何保证MQ的高可用?
系统复杂度提高:MQ的加入大大提高了系统的复杂度,以前系统间是同步的远程调用,现在是通过MQ进行异步调用。
如何保证消息没有被重复消费?怎么处理消息丢失情况?怎么保证消息传递的顺序性?
一致性问题:A系统处理完业务,通过MQ给B、C、D三个系统发消息数据,如果B系统、C系统处理成功,D系统处理失败。
如何保证消息数据梳理一致性?
1.3 各种MQ产品的比较
常见产品包括:ActivieMQ、RabbitMQ、RocketMQ、Kafka
特性 | ActiveMQ | RabbitMQ | RocketMQ | Kafka |
开发语言 | java | erlang | java | scala |
单机吞吐量 | 万级 | 万级 | 10万级 | 10万级 |
时效性 |
ms级 |
us级 | ms级 | ms级以内 |
可用性 | 高(主从架构) | 高(主从架构) | 非常高(分布式架构) | 非常高(分布式架构) |
功能特性 |
成熟的产品,在很多公司得到应用; 有较多的文档;各种协议支持较好 |
基于erlang开发,所以并发能力强, 性能极其好,延时极低;管理界面较丰富 |
MQ功能比较完毕,扩展性佳 |
只支持主要的MQ功能,像一些消息查询, 消息回溯等功能没有提供,毕竟是为大数 据准备的,在大数据领域应用广 |
2. RocketMQ快速入门
RocketMQ是阿里巴巴2016年MQ中间件,使用java语言开发,在阿里内部,RocketMQ承接了例如“双11”等高并发场景的消息流转,能够处理亿万级别的消息处理。
2.1 准备工作
2.1.1 下载RocketMQ
RocketMQ当前最新版本是4.8.0,
二进制安装包下载地址:https://www.apache.org/dyn/closer.cgi?path=rocketmq/4.8.0/rocketmq-all-4.8.0-bin-release.zip
源码安装包下载地址:https://www.apache.org/dyn/closer.cgi?path=rocketmq/4.8.0/rocketmq-all-4.8.0-source-release.zip
2.1.2 环境要求
Linux64位系统、JDK1.8(64位),源码安装还需要Maven 3.2.x
2.2 安装RocketMQ
2.2.1 安装步骤
下载二进制安装包:wget https://mirrors.bfsu.edu.cn/apache/rocketmq/4.8.0/rocketmq-all-4.8.0-bin-release.zip
解压安装包:unzip rocketmq-all-4.8.0-bin-release.zip
2.2.2 目录介绍
bin:启动脚本,包括shell脚本和cmd脚本
conf:实例配置文件,包括broker配置文件,logback配置文件等
lib:依赖jar包,包括Netty、commons-lang、FastJSON等
benchmark:例子
2.3 启动RocketMQ
1. 启动NameServer
# 1. 启动NameServer
nohup sh bin/mqnamesrc &
# 2. 查看启动日志,日志的默认路径是在user.home下,可以自己修改日志路径
tail -f ~/log/rocketmqlogs/namesrv.log
2. 启动Broker
# 1. 启动Broker,需要连接NameServer,9876是NameServer的默认端口号
nohup sh bin/mqbroker -n localhost:9876 &
# 2. 查看启动日志,日志的默认路径是在user.home下,可以自己修改日志路径
tail -f ~/logs/rocketmqlogs/broker.log
问题描述:RocketMQ默认的虚拟机内存较大,启动Broker如果因为内存不足失败,需要编辑如下两个配置文件,修改JVM内存大小
# 编辑 runbroker.sh 和 runserver.sh 修改默认JVM大小
vi runbroker.sh
vi runserver.sh
参考设置:JAVA_OPT="${JAVA_OPT} -server -Xms256m -Xmx256m -Xmn128m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"
2.4 测试RocketMQ
2.4.1 发送消息
# 1. 临时设置环境变量
export NAMESRV_ADDR=localhost:9876
# 2. 使用安装包的Demo发送消息
sh bin/tools.sh org.apache.rocketmq.example.quickstart.Producer
2.4.2 接收消息
# 1. 临时设置环境变量
export NAMESRV_ADDR=localhost:9876
# 2. 接收消息
sh bin/tools.sh org.apache.rocketmq.example.quickstart.Consumer
2.5 关闭RocketMQ
# 1. 关闭NameServer
sh bin/mqshutdown namesrv
# 2. 关闭Broker
sh bin/mqshutdown broker
3. RocketMQ集群搭建
3.1 各角色介绍
Producer:消息的发送者
Consumer:消息的接收者
Broker:暂存和传输消息,如:邮局
NameServer:管理Broker
Topic:区分消息的种类;一个发送者可以发送消息给一个或者多个Topic;一个消息的接收者也可以订阅一个或多个Topic消息
Message Queue:相当于是Topic的分区;用于并行发送和接收消息
3.2 集群搭建方式
3.2.1 集群特点
NameServer是一个几乎无状态节点,可集群部署,节点之间无任何信息同步。
Broker部署相对复杂,Broker分为Master与Slave,一个Master可以对应多个Slave,但是一个Slave只能对应一个Master,Master与Slave的对应关系通过制定相同的BrokerName,不同的BrokerId来定义,BrokerId为0表示Master,非0表示Slave。Master也可以部署多个。每个Broker与NameServer集群中的所有节点建立长连接,定时注册Topic信息到所有NameServer。
Producer与NameServer集群中的其中一个节点(随机选择)建立长连接,定期从NameServer取Topic路由信息,并向提供Topic服务的Master建立长连接,且定时向Master发送心跳。Producer完全无状态,可集群部署。
Consumer与NameServer集群中其中一个节点(随机选择)建立长连接,定期从NameServer取Topic路由信息,并向提供Topic服务的Master、Slave建立长连接,且定时向Master、Slave发送心跳。Consumer既可以从Master订阅消息,也可以从Slave订阅消息,订阅规则有Broker配置决定。
3.2.2 集群模式
(1)单Master模式
这种方式风险较大,一旦Broker重启或者宕机时,会导致整个服务不可用。不建议线上环境使用,可用于本地测试。
(2)多Master模式
一个集群无Slave,全是Master,例如2个Master或者3个Master,这种模式的优缺点如下:
优点:配置简单,单个Master宕机或重启维护对应用没有影响,在磁盘配置为RAID10时,即时机器宕机不可恢复情况下,由于RAID10磁盘非常可靠,消息也不会丢(异步刷盘丢失少量消息,同步刷盘一条不丢),性能最高。
缺点:单台机器宕机期间,这台机器上未被消费的消息在机器恢复之前不可订阅,消息实时性会受到影响。
(3)多Master多Slave模式(异步)
每个Master配置一个Slave,有多对Master-Slave,HA采用异步复制模式,主备有短暂消息延迟(毫秒级),这种模式的优缺点如下:
优点:即使磁盘损坏,消息丢失的非常少,切消息实时性不会影响,同时Master宕机后,消费者仍然可以从Slave消费,而且此过程对应用透明,不需要人工干预,性能同多Master模式几乎一样。
缺点:Master宕机,磁盘损坏情况下会丢失少量消息。
(4)多Mater多Slave模式(同步)
每个Master配置一个Slave,有多对Master-Slave,HA采用同步双写方式,即只有主备都写成功,才向应用返回成功,这种模式的优缺点如下:
优点:数据与服务都无单点故障,Master宕机情况下,消息无延迟,服务可用性与数据可用性都非常高。
缺点:性能比异步复制模式略低(大约低10%左右),发送单个消息的RT会略高,且目前版本的主节点宕机后,备机不能自动切换为主机。
3.3 双主从集群搭建
3.3.1 总体架构
消息高可用采用2Master-2Slave(同步双写)方式
3.3.2 集群工作流程
1. 启动NameServer,NameServer起来后监听端口,等待Broker、Producer、Consumer连上来,相当于一个路由控制中心。
2. Broker启动,跟所有NameServer保持长连接,定时发送心跳包。心跳包中包含Broker信息(IP+端口等)以及存储所有Topic信息。注册成功后,NameServer集群中就有Topic跟Broker的映射关系。
3. 收发消息前,先创建Topic,创建Topic时需要指定该Topic要存储在哪些Broker,也可以在发送消息时自动创建Topic。
4. Producer发送消息,启动时先跟NameServer集群中的其中一台建立长连接,并从NameServer中获取当前发送的Topic存在哪些Broker上,轮询从队列列表中选择一个队列,然后与队列所在的Broker建立长连接从而向Broker发消息。
5. Consumer跟Producer类似,跟其中一台NameServer建立长连接,获取当前订阅Topic存在哪些Broker上,然后直接跟Broker建立连接通道,开始消费消息。
3.3.3 服务器环境
序号 | IP | 角色 | 架构模式 |
1 | 192.168.220.13 | NameServer、BrokerServer | Master1、Slave2 |
2 | 192.168.220.15 | NameServer、BrokerServer | Master2、Slave1 |
3.3.4 Host添加配置
vi /etc/hosts
配置如下:
# NameServer 192.168.220.13 rocketmq-nameserver1 192.168.220.15 rocketmq-nameserver2 # Broker 192.168.220.13 rocketmq-master1 192.168.220.13 rocketmq-slave2 192.168.220.15 rocketmq-master2 192.168.220.15 rocketmq-slave1
配置完成后,重启网卡
systemctl restart network
3.3.5 防火墙配置
宿主机需要远程访问虚拟机的rockmq服务和web服务,需要开放相关的端口,简单粗暴的方式是直接关闭防火墙
# 关闭防火墙 systemctl stop firewalld.service # 查看防火墙的状态 firewall-cmd --state # 禁止firewall开机启动 systemctl disable firewalld.service
或者为了安全,只开放特定的端口号,RocketMQ默认使用了3个端口:9876、10911、11011。如果防火墙没有关闭的话,name防火墙就必须开放这些端口:
nameserver 默认使用 9876 端口
master 默认使用 10911 端口
slave 默认使用11011 端口
执行以下命令:
# 开放NameServer默认端口 firewall-cmd --remove-port=9876/tcp --permanent # 开放master默认端口 firewall-cmd --remove-port=10911/tcp --permanent # 开放slave默认端口(当前集群模式可不开启) firewall-cmd --remove-port=11011/tcp --permanent # 重启防火墙 firewall-cmd --reload
3.3.6 环境变量配置
vim /etc/profile
在profile文件的末尾加入如下命令
# set rocketmq export ROCKETMQ_HOME=/usr/local/rocketmq export PATH=$PATH:$ROCKETMQ_HOME/bin
保存并退出,并使配置文件立刻生效:
source /etc/profile
3.3.7 创建消息存储路径
mkdir /usr/local/rocketmq/store
mkdir /usr/local/rocketmq/store/commitlog
mkdir /usr/local/rocketmq/store/consumequeue
mkdir /usr/local/rocketmq/store/index
3.3.8 Broker配置文件
(1)master1
服务器:192.168.220.13
vi /usr/local/rocketmq/conf/2m-2s-sync/broker-a.properties
修改配置如下:
# 所属集群名字 brokerClusterName=rocketmq-cluster # broker名字,注意此处不同的配置文件填写的不一样 brokerName=broker-a # 0表示Master,大于0的数字表示Slave brokerId=1 # nameServer地址,分号分隔 namesrvAddr=rocketmq-nameserver1:9876;rocketmq-nameserver2:9876 # 发送消息时,自动创建服务器不存在的topic,默认创建的队列数 defaultTopicQueueNums=4 # 是否允许Broker自动创建Topic,建议线下开启,线上关闭 # Broker 对外服务的监听端口 listenPort=10911 # 删除文件时间点,默认凌晨4点 deleteWhen=04 # 文件保留时间,单位小时,默认48小时 fileReservedTime=48 # commitLog每个文件的大小默认1G mapedFileSizeCommitLog=1073741824 # ConsumeQueue每个文件默认存30w条,根据业务其概况调整 mapedFileSizeConsumeQueue=300000 #destroyMapedFileIntervalForcibly=120000 #redeleteHangedFileInterval=120000 # 检测物理文件磁盘空间 diskMaxUsedSpaceRatio=88 # 存储路径 storePathRootDir=/usr/local/rocketmq/store # commitLog 存储路径 storePathCommitLog=/usr/local/rocketmq/store/commitlog # 消息队列存储路径 storePathConsumeQueue=/usr/local/rocketmq/store/consumequeue # 消息索引存储路径 storePathIndex=/usr/local/rocketmq/store/index # checkpoint 文件存储路径 storeCheckpoint=/usr/local/rocketmq/store/checkpoint # abort 文件存储路径 abortFile=/usr/local/rocketmq/store/abort # 限制的消息大小 maxMessageSize=65536 #flushCommitLogLeastPages=4 #flushConsumeQueueLeastPages=2 #flushCommitLogThoroughtInterval=10000 #flushConsumeQueueThoroughInterval=60000 # Broker的角色 - ASYNC_MASTER 异步复制Master - SYNC_MASTER 同步双写Master - SLAVE brokerRole=SYNC_MASTER # 刷盘方式 ASYNC_FLUSH 异步刷盘 - SYNC_FLUSH 同步刷盘 flushDiskType=SYNC_FLUSH #checkTransactionMessageEnable=false # 发消息线程池数量 #sendMessageThreadPoolNums=128 # 拉消息线程池数量 #pullMessageThreadPoolNums=128
(2)slave2
服务器:192.168.220.13
vi /usr/local/rocketmq/conf/2m-2s-sync/broker-b-s.properties
修改配置如下:
# 所属集群名字
brokerClusterName=rocketmq-cluster
# broker名字,注意此处不同的配置文件填写的不一样
brokerName=broker-b
# 0表示Master,大于0的数字表示Slave
brokerId=1
# nameServer地址,分号分隔
namesrvAddr=rocketmq-nameserver1:9876;rocketmq-nameserver2:9876
# 发送消息时,自动创建服务器不存在的topic,默认创建的队列数
defaultTopicQueueNums=4
# 是否允许Broker自动创建Topic,建议线下开启,线上关闭
autoCreateTopicEnable=true
# 是否允许Broker自动创建订阅组,建议线下开启,线上关闭
autoCreateSubscriptionGroup=true
# Broker 对外服务的监听端口
listenPort=11011
# 删除文件时间点,默认凌晨4点
deleteWhen=04
# 文件保留时间,单位小时,默认48小时
fileReservedTime=48
# commitLog每个文件的大小默认1G
mapedFileSizeCommitLog=1073741824
# ConsumeQueue每个文件默认存30w条,根据业务其概况调整
mapedFileSizeConsumeQueue=300000
#destroyMapedFileIntervalForcibly=120000
#redeleteHangedFileInterval=120000
# 检测物理文件磁盘空间
diskMaxUsedSpaceRatio=88
# 存储路径
storePathRootDir=/usr/local/rocketmq/store2
# commitLog 存储路径
storePathCommitLog=/usr/local/rocketmq/store2/commitlog
# 消息队列存储路径
storePathConsumeQueue=/usr/local/rocketmq/store2/consumequeue
# 消息索引存储路径
storePathIndex=/usr/local/rocketmq/store2/index
# checkpoint 文件存储路径
storeCheckpoint=/usr/local/rocketmq/store2/checkpoint
# abort 文件存储路径
abortFile=/usr/local/rocketmq/store2/abort
# 限制的消息大小
maxMessageSize=65536
#flushCommitLogLeastPages=4
#flushConsumeQueueLeastPages=2
#flushCommitLogThoroughtInterval=10000
#flushConsumeQueueThoroughInterval=60000
# Broker的角色 - ASYNC_MASTER 异步复制Master - SYNC_MASTER 同步双写Master - SLAVE
brokerRole=SLAVE
# 刷盘方式 ASYNC_FLUSH 异步刷盘 - SYNC_FLUSH 同步刷盘
flushDiskType=ASYNC_FLUSH
#checkTransactionMessageEnable=false
# 发消息线程池数量
#sendMessageThreadPoolNums=128
# 拉消息线程池数量
#pullMessageThreadPoolNums=128
(3)master2
服务器:192.168.220.15
vi /usr/local/rocketmq/conf/2m-2s-sync/broker-b.properties
修改配置如下:
# 所属集群名字 brokerClusterName=rocketmq-cluster # broker名字,注意此处不同的配置文件填写的不一样 brokerName=broker-b # 0表示Master,大于0的数字表示Slave brokerId=0 # nameServer地址,分号分隔 namesrvAddr=rocketmq-nameserver1:9876;rocketmq-nameserver2:9876 # 发送消息时,自动创建服务器不存在的topic,默认创建的队列数 defaultTopicQueueNums=4 # 是否允许Broker自动创建Topic,建议线下开启,线上关闭 # Broker 对外服务的监听端口 listenPort=10911 # 删除文件时间点,默认凌晨4点 deleteWhen=04 # 文件保留时间,单位小时,默认48小时 fileReservedTime=48 # commitLog每个文件的大小默认1G mapedFileSizeCommitLog=1073741824 # ConsumeQueue每个文件默认存30w条,根据业务其概况调整 mapedFileSizeConsumeQueue=300000 #destroyMapedFileIntervalForcibly=120000 #redeleteHangedFileInterval=120000 # 检测物理文件磁盘空间 diskMaxUsedSpaceRatio=88 # 存储路径 storePathRootDir=/usr/local/rocketmq/store # commitLog 存储路径 storePathCommitLog=/usr/local/rocketmq/store/commitlog # 消息队列存储路径 storePathConsumeQueue=/usr/local/rocketmq/store/consumequeue # 消息索引存储路径 storePathIndex=/usr/local/rocketmq/store/index # checkpoint 文件存储路径 storeCheckpoint=/usr/local/rocketmq/store/checkpoint # abort 文件存储路径 abortFile=/usr/local/rocketmq/store/abort # 限制的消息大小 maxMessageSize=65536 #flushCommitLogLeastPages=4 #flushConsumeQueueLeastPages=2 #flushCommitLogThoroughtInterval=10000 #flushConsumeQueueThoroughInterval=60000 # Broker的角色 - ASYNC_MASTER 异步复制Master - SYNC_MASTER 同步双写Master - SLAVE brokerRole=SYNC_MASTER # 刷盘方式 ASYNC_FLUSH 异步刷盘 - SYNC_FLUSH 同步刷盘 flushDiskType=SYNC_FLUSH #checkTransactionMessageEnable=false # 发消息线程池数量 #sendMessageThreadPoolNums=128 # 拉消息线程池数量 #pullMessageThreadPoolNums=128
(4)slave1
服务器:192.168.220.15
vi /usr/local/rocketmq/conf/2m-2s-sync/broker-a-s.properties
修改配置如下:
# 所属集群名字 brokerClusterName=rocketmq-cluster # broker名字,注意此处不同的配置文件填写的不一样 brokerName=broker-a # 0表示Master,大于0的数字表示Slave brokerId=1 # nameServer地址,分号分隔 namesrvAddr=rocketmq-nameserver1:9876;rocketmq-nameserver2:9876 # 发送消息时,自动创建服务器不存在的topic,默认创建的队列数 defaultTopicQueueNums=4 # 是否允许Broker自动创建Topic,建议线下开启,线上关闭 autoCreateTopicEnable=true # 是否允许Broker自动创建订阅组,建议线下开启,线上关闭 autoCreateSubscriptionGroup=true # Broker 对外服务的监听端口 listenPort=11011 # 删除文件时间点,默认凌晨4点 deleteWhen=04 # 文件保留时间,单位小时,默认48小时 fileReservedTime=48 # commitLog每个文件的大小默认1G mapedFileSizeCommitLog=1073741824 # ConsumeQueue每个文件默认存30w条,根据业务其概况调整 mapedFileSizeConsumeQueue=300000 #destroyMapedFileIntervalForcibly=120000 #redeleteHangedFileInterval=120000 # 检测物理文件磁盘空间 diskMaxUsedSpaceRatio=88 # 存储路径 storePathRootDir=/usr/local/rocketmq/store2 # commitLog 存储路径 storePathCommitLog=/usr/local/rocketmq/store2/commitlog # 消息队列存储路径 storePathConsumeQueue=/usr/local/rocketmq/store2/consumequeue # 消息索引存储路径 storePathIndex=/usr/local/rocketmq/store2/index # checkpoint 文件存储路径 storeCheckpoint=/usr/local/rocketmq/store2/checkpoint # abort 文件存储路径 abortFile=/usr/local/rocketmq/store2/abort # 限制的消息大小 maxMessageSize=65536 #flushCommitLogLeastPages=4 #flushConsumeQueueLeastPages=2 #flushCommitLogThoroughtInterval=10000 #flushConsumeQueueThoroughInterval=60000 # Broker的角色 - ASYNC_MASTER 异步复制Master - SYNC_MASTER 同步双写Master - SLAVE brokerRole=SLAVE # 刷盘方式 ASYNC_FLUSH 异步刷盘 - SYNC_FLUSH 同步刷盘 flushDiskType=ASYNC_FLUSH #checkTransactionMessageEnable=false # 发消息线程池数量 #sendMessageThreadPoolNums=128 # 拉消息线程池数量 #pullMessageThreadPoolNums=128
3.3.9 修改启动脚本文件
(1)runbroker.sh
vim /usr/local/rocketmq/bin/runbroker.sh
需要根据内存大小进行适当的对JVM参数进行调整
JAVA_OPT="${JAVA_OPT} -server -Xms256m -Xmx256m -Xmn128m"
(2)runserver.sh
vim /usr/local/rocketmq/bin/runserver.sh
JAVA_OPT="${JAVA_OPT} -server -Xms256m -Xmx256m -Xmn128m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"
3.3.10 启动服务
(1)启动NameServer集群
分别在192.168.220.13和192.168.220.15启动NameServer
cd /usr/local/rocketmq/bin/ nohup sh mqnamesrv &
(2)启动Broker集群
在192.168.220.13服务器上启动master1和slave2
master1:
cd /usr/local/rocketmq/bin/ nohup sh mqbroker -c /usr/local/rocketmq/conf/2m-2s-sync/broker-a.properties &
slave2:
cd /usr/local/rocketmq/bin/ nohup sh mqbroker -c /usr/local/rocketmq/conf/2m-2s-sync/broker-b-s.properties &
在192.168.220.15服务器上启动master2和slave1
master2:
cd /usr/local/rocketmq/bin/ nohup sh mqbroker -c /usr/local/rocketmq/conf/2m-2s-sync/broker-b.properties &
slave1:
cd /usr/local/rocketmq/bin/ nohup sh mqbroker -c /usr/local/rocketmq/conf/2m-2s-sync/broker-a-s.properties &
3.3.11 查看进程状态
查看命令:jps
可以查看到当前服务器上启动的服务。
3.3.12 查看日志
我的日志目录是自己修改的,日志目录是:/usr/local/rocketmq/logs/rocketmqlogs
MQ的默认日志目录是Linux的user.home目录,如果你需要修改日志目录,可以到/usr/local/rocketmq/conf下修改这3个文件:logback_broker.xml、logback_namesrv.xml、logback_tools.xml
3.4 mqadmin管理工具
3.4.1 使用方式
进入RocketMQ安装位置,在bin目录下执行./mqadmin {command} {args}
3.4.2 命令介绍
(1)Topic相关
名称 | 含义 | 命令选项 | 说明 |
updateTopic | 创建更新Topic配置 | -b |
Broker地址,表示topic所在Broker, 只支持单台Broker,地址为ip:port |
-c |
cluster名称,表示topic所在集群 (集群可通过clusterList查询) |
||
-h | 打印帮助 | ||
-n | NameServer服务地址,格式ip:port | ||
-p |
指定新topic的读写权限(W=2|R=4|WR=6) |
||
-r | 可读队列数(默认为8) | ||
-w | 可写队列数(默认为8) | ||
-t | top名称(名称只能使用字符^[a-zA-Z0-9_-]+$) | ||
deleteTopic | 删除Topic | -c |
cluster名称,表示删除某集群下的某个topic (集群可通过clusterList查询) |
-h | 打印帮助 | ||
-n | NameServer服务地址,格式ip:port | ||
-t | top名称(名称只能使用字符^[a-zA-Z0-9_-]+$) | ||
topicList | 查看Topic列表信息 | -h | 打印帮助 |
-c |
不配置-c只返回topic列表,增加-c返回clusterName, topic, consumerGroup信息,即topic的所有集群和 订阅关系,没有参数 |
||
-n | NameServer服务地址,格式ip:port | ||
topicRoute | 查看Topic路由信息 | -t | topic名称 |
-h | 打印帮助 | ||
-n | NameServer服务地址,格式ip:port | ||
topicStatus | 查看Topic消息队列offset | -t | topic名称 |
-h | 打印帮助 | ||
-n | NameServer服务地址,格式ip:port | ||
topicClusterList | 查看Topic所在集群列表 | -t | topic名称 |
-h | 打印帮助 | ||
-n | NameServer服务地址,格式ip:port | ||
updateTopicPerm | 更新Topic读写权限 | -t | topic名称 |
-h | 打印帮助 | ||
-n | NameServer服务地址,格式ip:port | ||
-b |
Broker地址,表示topic所在Broker, 只支持单台Broker,地址为ip:port |
||
-p |
指定新topic的读写权限(W=2|R=4|WR=6) |
||
-c |
cluster名称,表示topic所在集群 (集群可通过clusterList查看),-b优先,如果没有-b, 则对集群中所有Broker执行命令 |
||
updateOrderConf |
从NameServer上创建、删除、 获取特定命名空间的kv配置, 目前还未启用 |
-h | 打印帮助 |
-n | NameServer服务地址,格式ip:port | ||
-t | topic,键 | ||
-v | orderConf,值 | ||
-m | method,可选get、put、delete |
阿斯顿发