This is an automated email from the ASF dual-hosted git repository.
linhill pushed a commit to branch new-official-website
in repository https://gitbox.apache.org/repos/asf/rocketmq-site.git
The following commit(s) were added to refs/heads/new-official-website by this
push:
new 6b317168b Optimize broker deployment documentation
6b317168b is described below
commit 6b317168b2311405468a8f5e92de5066d57634f5
Author: Qingshan Lin <hill007...@126.com>
AuthorDate: Fri Aug 25 14:32:45 2023 +0800
Optimize broker deployment documentation
---
.../05-deploymentOperations/01deploy.md | 74 +++++++---------------
1 file changed, 24 insertions(+), 50 deletions(-)
diff --git a/versioned_docs/version-5.0/05-deploymentOperations/01deploy.md
b/versioned_docs/version-5.0/05-deploymentOperations/01deploy.md
index 7d47c0ab7..a55e809e5 100644
--- a/versioned_docs/version-5.0/05-deploymentOperations/01deploy.md
+++ b/versioned_docs/version-5.0/05-deploymentOperations/01deploy.md
@@ -5,19 +5,13 @@ Apache RocketMQ 5.0 版本完成基本消息收发，包括 NameServer、Broker
- 在 Local 模式下，Broker 和 Proxy 是同进程部署，只是在原有 Broker 的配置基础上新增 Proxy 的简易配置就可以运行。
- 在 Cluster 模式下，Broker 和 Proxy 分别部署，即在原有的集群基础上，额外再部署 Proxy 即可。
-## 部署方案和使用约束
+
## Local模式部署
由于 Local 模式下 Proxy 和 Broker 是同进程部署，Proxy本身无状态，因此主要的集群配置仍然以 Broker 为基础进行即可。
-
-### 单组节点单副本模式
-
-:::caution
-这种方式风险较大，因为 Broker 只有一个节点，一旦Broker重启或者宕机时，会导致整个服务不可用。不建议线上环境使用, 可以用于本地测试。
-:::
-
-#### 启动 NameServer
+### 启动 NameServer
+NameServer需要先于Broker启动，且如果在生产环境使用，为了保证高可用，建议一般规模的集群启动3个NameServer，各节点的启动命令相同，如下：
```bash
### 首先启动Name Server
@@ -27,8 +21,17 @@ $ nohup sh mqnamesrv &
$ tail -f ~/logs/rocketmqlogs/namesrv.log
The Name Server boot success...
```
+### 启动Broker+Proxy
+
+#### 单组节点单副本模式
+
+:::caution
+这种方式风险较大，因为 Broker 只有一个节点，一旦Broker重启或者宕机时，会导致整个服务不可用。不建议线上环境使用, 可以用于本地测试。
+:::
+
+
-#### 启动 Broker+Proxy
+启动 Broker+Proxy
```bash
@@ -39,7 +42,7 @@ $ tail -f ~/logs/rocketmqlogs/broker_default.log
The broker[xxx, 192.169.1.2:10911] boot success...
```
-### 多组节点（集群）单副本模式
+#### 多组节点（集群）单副本模式
一个集群内全部部署 Master 角色，不部署Slave 副本，例如2个Master或者3个Master，这种模式的优缺点如下：
@@ -47,20 +50,8 @@ The broker[xxx, 192.169.1.2:10911] boot success...
- 缺点：单台机器宕机期间，这台机器上未被消费的消息在机器恢复之前不可订阅，消息实时性会受到影响。
-### 启动NameServer
-NameServer需要先于Broker启动，且如果在生产环境使用，为了保证高可用，建议一般规模的集群启动3个NameServer，各节点的启动命令相同，如下：
-
-```bash
-### 首先启动NameServer
-$ nohup sh mqnamesrv &
-
-### 验证Name Server 是否启动成功
-$ tail -f ~/logs/rocketmqlogs/namesrv.log
-The Name Server boot success...
-```
-
-#### 启动Broker+Proxy集群
+启动Broker+Proxy集群
```bash
### 在机器A，启动第一个Master，例如NameServer的IP为：192.168.1.1
@@ -78,7 +69,7 @@ $ nohup sh bin/mqbroker -n 192.168.1.1:9876 -c
$ROCKETMQ_HOME/conf/2m-noslave/br
:::
-## 多节点（集群）多副本模式-异步复制
+#### 多节点（集群）多副本模式-异步复制
每个Master配置一个Slave，有多组 Master-Slave，HA采用异步复制方式，主备有短暂消息延迟（毫秒级），这种模式的优缺点如下：
@@ -86,18 +77,8 @@ $ nohup sh bin/mqbroker -n 192.168.1.1:9876 -c
$ROCKETMQ_HOME/conf/2m-noslave/br
- 缺点：Master宕机，磁盘损坏情况下会丢失少量消息。
-#### 启动NameServer
-```bash
-### 首先启动Name Server
-$ nohup sh mqnamesrv &
-
-### 验证Name Server 是否启动成功
-$ tail -f ~/logs/rocketmqlogs/namesrv.log
-The Name Server boot success...
-```
-
-#### 启动Broker+Proxy集群
+启动Broker+Proxy集群
```bash
### 在机器A，启动第一个Master，例如NameServer的IP为：192.168.1.1
@@ -113,7 +94,7 @@ $ nohup sh bin/mqbroker -n 192.168.1.1:9876 -c
$ROCKETMQ_HOME/conf/2m-2s-async/b
$ nohup sh bin/mqbroker -n 192.168.1.1:9876 -c
$ROCKETMQ_HOME/conf/2m-2s-async/broker-b-s.properties --enable-proxy &
```
-### 多节点（集群）多副本模式-同步双写
+#### 多节点（集群）多副本模式-同步双写
每个Master配置一个Slave，有多对 Master-Slave，HA采用同步双写方式，即只有主备都写成功，才向应用返回成功，这种模式的优缺点如下：
@@ -121,18 +102,7 @@ $ nohup sh bin/mqbroker -n 192.168.1.1:9876 -c
$ROCKETMQ_HOME/conf/2m-2s-async/b
- 缺点：性能比异步复制模式略低（大约低10%左右），发送单个消息的RT会略高，且目前版本在主节点宕机后，备机不能自动切换为主机。
-#### 启动NameServer
-
-```bash
-### 首先启动Name Server
-$ nohup sh mqnamesrv &
-
-### 验证Name Server 是否启动成功
-$ tail -f ~/logs/rocketmqlogs/namesrv.log
-The Name Server boot success...
-```
-
-#### 启动 Broker+Proxy 集群
+启动 Broker+Proxy 集群
```bash
### 在机器A，启动第一个Master，例如NameServer的IP为：192.168.1.1
@@ -150,7 +120,8 @@ $ nohup sh bin/mqbroker -n 192.168.1.1:9876 -c
$ROCKETMQ_HOME/conf/2m-2s-sync/br
:::tip
以上 Broker 与 Slave 配对是通过指定相同的 BrokerName 参数来配对，Master 的 BrokerId 必须是 0，Slave 的
BrokerId 必须是大于 0 的数。另外一个 Master 下面可以挂载多个 Slave，同一 Master 下的多个 Slave 通过指定不同的
BrokerId 来区分。$ROCKETMQ_HOME指的RocketMQ安装目录，需要用户自己设置此环境变量。
:::
-
+#### 5.0 HA新模式
+提供更具灵活性的HA机制，让用户更好的平衡成本、服务可用性、数据可靠性，同时支持业务消息和流存储的场景。[详见](https://rocketmq.apache.org/zh/docs/deploymentOperations/03autofailover)
## Cluster模式部署
@@ -253,6 +224,9 @@ $ nohup sh bin/mqbroker -n 192.168.1.1:9876 -c
$ROCKETMQ_HOME/conf/2m-2s-sync/br
以上 Broker 与 Slave 配对是通过指定相同的 BrokerName 参数来配对，Master 的 BrokerId 必须是 0，Slave 的
BrokerId 必须是大于 0 的数。另外一个 Master 下面可以挂载多个 Slave，同一 Master 下的多个 Slave 通过指定不同的
BrokerId 来区分。$ROCKETMQ_HOME指的RocketMQ安装目录，需要用户自己设置此环境变量。
:::
+#### 5.0 HA新模式
+提供更具灵活性的HA机制，让用户更好的平衡成本、服务可用性、数据可靠性，同时支持业务消息和流存储的场景。[详见](https://rocketmq.apache.org/zh/docs/deploymentOperations/03autofailover)
+
### 启动 Proxy
可以在多台机器启动多个Proxy
