docker-compose を使用して RocketMQ5.x スタンドアロン展開と詳細な構成パラメータを展開する
ミラープル
後で展開するときにイメージのプルが失敗する問題を回避するために、必要なイメージ ファイルを事前にプルしてください。
RocketMQ サービス ミラーをプルします (Apache/rocketmq ミラーを使用して、NameServer+Broker+Proxy を含めます)。
ミラーアドレス: https://hub.docker.com/r/apache/rocketmq/tags
私がデプロイしていたとき、最新のリリースバージョンは 5.1.0 でした。ニーズとデプロイメントに応じて 5.x バージョンを選択できます。プロセスはそれほど複雑ではなく、大きな変更が加えられます。
docker pull apache/rocketmq:5.1.0
RocketMQ コンソール イメージをプルします (rocketmq-dashboard)
最新バージョンをプルするだけです
docker pull apacherocketmq/rocketmq-dashboard:latest
docker-compose v2 バージョンをインストールし、アクセス許可を付与します (すでにインストールされているこの手順はスキップしてください)
ここでは compose v2 バージョン
1 を使用し、ダウンロードします (ダウンロードするには get.daocloud.io 国内リンクを使用します)。
sudo curl -L "https://get.daocloud.io/docker/compose/releases/download/v2.15.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
2. 実行権限を追加する
chmod +x /usr/local/bin/docker-compose
3. 検証
# docker Compose v2版本命令
docker compose version
Docker Compose version v2.15.1
# docker Compose v1版本命令
docker-compose -version
4. docker-compose を削除する
sudo rm /usr/local/bin/docker-compose
Docker バージョンに対応する Compose ファイル形式を比較する
書く前に、Docker のバージョンに対応する Compose ファイル形式を比較してください。私の Docker バージョンは比較的新しいです。ここでは 3.8 を使用するか、直接 3 と書くことができます。
https://docs.docker.com/compose/compose-file/ compose-versioning /
docker --version
マウントする必要があるフォルダーとファイルを作成する
NameServer がマウントする必要があるフォルダーとファイルを作成する
マウントフォルダーを作成する
# 日志目录
mkdir /usr/local/rocketmq/nameserver/logs -p
# 脚本目录
mkdir /usr/local/rocketmq/nameserver/bin -p
権限の設定: 設定されていない場合、ログ ファイルを NameServer コンテナ内に書き込むことはできません。
# 777 文件所属者、文件所属组和其他人有读取 & 写入 & 执行全部权限。rwxrwxrwx
chmod 777 -R /usr/local/rocketmq/nameserver/*
マウントファイルの作成
NameServer 起動スクリプトには、最大ヒープ メモリと新世代メモリを自動計算する機能があり、異なるハードウェア環境では最大ヒープ メモリと新世代メモリ環境変数の設定が適用されなくなります。事前にコンテナ内部の起動スクリプトのコピーをコピーしてマウントし、メモリをカスタマイズしたい場合は自分で調整できます。
1. コンテナを起動します
docker run -d \
--privileged=true \
--name rmqnamesrv \
apache/rocketmq:5.1.0 sh mqnamesrv
2. コンテナ内の起動スクリプトをマウント ディレクトリ /usr/local/rocketmq/nameserver/bin にコピーします。
docker cp rmqnamesrv:/home/rocketmq/rocketmq-5.1.0/bin/runserver.sh /usr/local/rocketmq/nameserver/bin/runserver.sh
3. runserver.sh を変更します。
# 打开脚本文件
vi /usr/local/rocketmq/nameserver/bin/runserver.sh
Calculate_heap_sizes関数が呼び出される位置を見つけてコメントアウトして保存すると、
スクリプトの下部に表示されます。
docker stop rmqnamesrv
docker rm rmqnamesrv
Broker がマウントする必要があるフォルダーとファイルを作成する
マウントフォルダーを作成しました
コンテナの内部データ、設定ファイル、ログをマウントするためのマウントディレクトリを事前に作成します。
# 创建需要的挂载目录
mkdir /usr/local/rocketmq/broker/logs -p \
mkdir /usr/local/rocketmq/broker/data -p \
mkdir /usr/local/rocketmq/broker/conf -p \
mkdir /usr/local/rocketmq/broker/bin -p
権限の設定
# 777 文件所属者、文件所属组和其他人有读取 & 写入 & 执行全部权限。rwxrwxrwx
chmod 777 -R /usr/local/rocketmq/broker/*
Broker.conf ファイルを作成する
/usr/local/rocketmq/broker/conf フォルダーの下に Broker.conf ファイルを作成します。
vi /usr/local/rocketmq/broker/conf/broker.conf
次の設定情報を Broker.conf に追加します。ここではパラメータについてあまり多くの説明を行わないでください。次のブローカ設定の詳細には、ブローカの共通パラメータについて詳しく説明されています。
# 集群名称
brokerClusterName = DefaultCluster
# 节点名称
brokerName = broker-a
# broker id节点ID, 0 表示 master, 其他的正整数表示 slave,不能小于0
brokerId = 0
# Broker服务地址 String 内部使用填内网ip,如果是需要给外部使用填公网ip
brokerIP1 = 192.168.10.220
# Broker角色
brokerRole = ASYNC_MASTER
# 刷盘方式
flushDiskType = ASYNC_FLUSH
# 在每天的什么时间删除已经超过文件保留时间的 commit log,默认值04
deleteWhen = 04
# 以小时计算的文件保留时间 默认值72小时
fileReservedTime = 72
# 是否允许Broker 自动创建Topic,建议线下开启,线上关闭
autoCreateTopicEnable=true
# 是否允许Broker自动创建订阅组,建议线下开启,线上关闭
autoCreateSubscriptionGroup=true
説明: Broker.conf ファイルを作成し、このファイルを通じて RocketMQ ブローカーを管理します
コンテナ内のブローカー起動スクリプトをホストにコピーします (カスタム ヒープ メモリが必要ない場合はスキップできます)。
Broker 起動スクリプトには、最大ヒープ メモリと新世代メモリを自動的に計算する機能があり、異なるハードウェア環境では最大ヒープ メモリと新世代メモリの環境変数の設定が適用されなくなります。事前にコンテナ内部の起動スクリプトのコピーをコピーしてマウントし、メモリをカスタマイズしたい場合は自分で調整できます。
1. コンテナを起動します
docker run -d \
--name rmqbroker \
--privileged=true \
apache/rocketmq:5.1.0 \
sh mqbroker
2. コンテナ内の起動スクリプトをマウント ディレクトリ /usr/local/rocketmq/nameserver/bin にコピーします。
docker cp rmqbroker:/home/rocketmq/rocketmq-5.1.0/bin/runbroker.sh /usr/local/rocketmq/broker/bin/runbroker.sh
3. runbroker.sh を変更します。
# 打开脚本文件
vi /usr/local/rocketmq/broker/bin/runbroker.sh
Calculate_heap_sizes関数が呼び出される位置を見つけてコメントアウトして保存すると、スクリプトの下部に表示されます。
4.コンテナを停止&削除する
docker stop rmqbroker
docker rm rmqbroker
docker-compose.yml ファイルを書き込む
/usr/local/rocketmq ディレクトリに入り、docker-compose.yml ファイルを作成し、次のオーケストレーション情報を書き込みます。
cd /usr/local/rocketmq
vi docker-compose.yml
version: '3.8'
services:
rmqnamesrv:
image: apache/rocketmq:5.1.0
container_name: rmqnamesrv
ports:
- 9876:9876
restart: always
privileged: true
volumes:
- /usr/local/rocketmq/nameserver/logs:/home/rocketmq/logs
- /usr/local/rocketmq/nameserver/bin/runserver.sh:/home/rocketmq/rocketmq-5.1.0/bin/runserver.sh
environment:
- MAX_HEAP_SIZE=256M
- HEAP_NEWSIZE=128M
command: ["sh","mqnamesrv"]
broker:
image: apache/rocketmq:5.1.0
container_name: rmqbroker
ports:
- 10909:10909
- 10911:10911
restart: always
privileged: true
volumes:
- /usr/local/rocketmq/broker/logs:/home/rocketmq/logs
- /usr/local/rocketmq/broker/store:/home/rocketmq/logs
- /usr/local/rocketmq/broker/conf/broker.conf:/home/rocketmq/broker.conf
- /usr/local/rocketmq/broker/bin/runbroker.sh:/home/rocketmq/rocketmq-5.1.0/bin/runbroker.sh
depends_on:
- 'rmqnamesrv'
environment:
- NAMESRV_ADDR=rmqnamesrv:9876
- MAX_HEAP_SIZE=512M
- HEAP_NEWSIZE=256M
command: ["sh","mqbroker","-c","/home/rocketmq/broker.conf"]
rmqdashboard:
image: apacherocketmq/rocketmq-dashboard:latest
container_name: rocketmq-dashboard
ports:
- 8080:8080
restart: always
privileged: true
depends_on:
- 'rmqnamesrv'
environment:
- JAVA_OPTS= -Xmx256M -Xms256M -Xmn128M -Drocketmq.namesrv.addr=rmqnamesrv:9876 -Dcom.rocketmq.sendMessageWithVIPChannel=false
サービスを開始する
# docker Compose v2版本命令
docker compose up -d # -d 指后台运行
# docker Compose v1版本命令
docker-compose up -d # -d 指后台运行
正常に起動し、コンソール
http://192.168.10.220:8080にアクセスします。
ブローカー構成の詳細
# nameServer 地址多个用;隔开 默认值null
# 例:127.0.0.1:6666;127.0.0.1:8888
namesrvAddr = 127.0.0.1:6666
# 集群名称 单机配置可以随意填写,如果是集群部署在同一个集群中集群名称必须一致类似Nacos的命名空间
brokerClusterName = DefaultCluster
# broker节点名称 单机配置可以随意填写,如果是集群部署在同一个集群中节点名称不要重复
brokerName = broker-a
# broker id节点ID, 0 表示 master, 其他的正整数表示 slave,不能小于0
brokerId = 0
# Broker 对外服务的监听端口 默认值10911
# 端口(注意:broker启动后,会占用3个端口,分别在listenPort基础上-2,+1,供内部程序使用,所以集群一定要规划好端口,避免冲突)
listenPort=10911
# Broker服务地址 String 内部使用填内网ip,如果是需要给外部使用填公网ip
brokerIP1 = 127.0.0.1
# BrokerHAIP地址,供slave同步消息的地址 内部使用填内网ip,如果是需要给外部使用填公网ip
brokerIP2 = 127.0.0.1
# Broker角色 默认值ASYNC_MASTER
# ASYNC_MASTER 异步复制Master,只要主写成功就会响应客户端成功,如果主宕机可能会出现小部分数据丢失
# SYNC_MASTER 同步双写Master,主和从节点都要写成功才会响应客户端成功,主宕机也不会出现数据丢失
# SLAVE
brokerRole = ASYNC_MASTER
# 刷盘方式
# SYNC_FLUSH(同步刷新)相比于ASYNC_FLUSH(异步处理)会损失很多性能,但是也更可靠,所以需要根据实际的业务场景做好权衡,默认值ASYNC_FLUSH
flushDiskType = ASYNC_FLUSH
# 在每天的什么时间删除已经超过文件保留时间的 commit log,默认值04
deleteWhen = 04
# 以小时计算的文件保留时间 默认值72小时
fileReservedTime = 72
# 消息大小 单位字节 默认1024 * 1024 * 4
maxMessageSize=4194304
# 在发送消息时,自动创建服务器不存在的Topic,默认创建的队列数,默认值4
defaultTopicQueueNums=4
# 是否允许Broker 自动创建Topic,建议线下开启,线上关闭
autoCreateTopicEnable=true
# 是否允许Broker自动创建订阅组,建议线下开启,线上关闭
autoCreateSubscriptionGroup=true
# 失败重试时间,默认重试16次进入死信队列,第一次1s第二次5s以此类推。
# 延时队列时间等级默认18个,可以设置多个比如在后面添加一个1d(一天),使用的时候直接用对应时间等级即可,从1开始到18,如果添加了第19个直接使用等级19即可
messageDelayLevel=1s 5s 10s 30s 1m 2m 3m 4m 5m 6m 7m 8m 9m 10m 20m 30m 1h 2h
# 指定TM在20秒内应将最终确认状态发送给TC,否则引发消息回查。默认为60秒
transactionTimeout=20
# 指定最多回查5次,超过后将丢弃消息并记录错误日志。默认15次。
transactionCheckMax=5
# 指定设置的多次消息回查的时间间隔为10秒。默认为60秒。
transactionCheckInterval=10