You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@shenyu.apache.org by xi...@apache.org on 2022/05/03 14:03:14 UTC
[incubator-shenyu-website] branch main updated: [type: feature] add shenyu cluster deployment document (#559)
This is an automated email from the ASF dual-hosted git repository.
xiaoyu pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/incubator-shenyu-website.git
The following commit(s) were added to refs/heads/main by this push:
new 4bc6a12689 [type: feature] add shenyu cluster deployment document (#559)
4bc6a12689 is described below
commit 4bc6a12689194f5c52ba568306797f981bb9d3db
Author: Codd <he...@hotmail.com>
AuthorDate: Tue May 3 22:03:10 2022 +0800
[type: feature] add shenyu cluster deployment document (#559)
* [type: feature] add shenyu cluster deployment document
* [type: feature] add shenyu cluster deployment document
* [type: feature] add cluster doploy document
Co-authored-by: hefe <he...@dazd.cn>
---
docs/deployment/deployment-cluster.md | 87 ++++++++++++++++++++++
.../current/deployment/deployment-cluster.md | 85 +++++++++++++++++++++
.../version-2.4.0/deployment/deployment-cluster.md | 85 +++++++++++++++++++++
.../version-2.4.1/deployment/deployment-cluster.md | 85 +++++++++++++++++++++
.../version-2.4.2/deployment/deployment-cluster.md | 85 +++++++++++++++++++++
.../version-2.4.3/deployment/deployment-cluster.md | 85 +++++++++++++++++++++
.../version-2.4.0/deployment/deployment-cluster.md | 87 ++++++++++++++++++++++
.../version-2.4.1/deployment/deployment-cluster.md | 87 ++++++++++++++++++++++
.../version-2.4.2/deployment/deployment-cluster.md | 87 ++++++++++++++++++++++
.../version-2.4.3/deployment/deployment-cluster.md | 87 ++++++++++++++++++++++
10 files changed, 860 insertions(+)
diff --git a/docs/deployment/deployment-cluster.md b/docs/deployment/deployment-cluster.md
new file mode 100644
index 0000000000..470a0030a5
--- /dev/null
+++ b/docs/deployment/deployment-cluster.md
@@ -0,0 +1,87 @@
+---
+sidebar_position: 7
+title: Cluster Deployment
+keywords: ["Gateway Cluster Enviroment", "Cluster Enviroment"]
+description: Cluster Delopyment
+---
+
+This aritcle introduces how to delopy the `Shenyu` gateway in cluster enviroment.
+
+> In this part, you can see [ShenYu Binary Packages Deployment](./deployment-package.md) before deploying.
+
+### Enviromental Preparation
+
+* Two or more Gateway Boostrap servers, these servers must install JDK1.8+.
+* A server for Gateway Admin, this server must install mysql/pgsql/h2 and JDK1.8+.
+* A server for nginx.
+
+### Start Apache ShenYu Admin
+
+* download and unzip `apache-shenyu-incubating-${current.version}-admin-bin.tar.gz` in your Gateway Admin server.
+
+* config your database, go to the `/conf` directory, and modify `spring.profiles.active` of the configuration in `application.yaml` to `mysql`, `pg` or `h2`.
+
+* config your way of synchronization, go to the `/conf` directory, and modify `shenyu.sync` of configuration in `application.yaml` to `websocket`, `http`, `zookeeper`, `etcd`, `consul` or `nacos`.
+
+* start Apache ShenYu Admin in `bin` directory.
+
+```
+> windows: start.bat
+
+> linux: ./start.sh
+```
+
+### Start Apache ShenYu Boostrap
+
+* download and unzip `apache-shenyu-incubating-${current.version}-bootstrap-bin.tar.gz` in your Gateway Boostrap server.
+
+* config your synchronization, go to the `/conf` directory, and modify `shenyu.sync` of configuration in `application.yaml` to `websocket`, `http`, `zookeeper`, `etcd`, `consul` or `nacos`, this configuaration must remain the same of `ShenyYu Admin`.
+
+* repeat above-mentioned operations in each `ShenYu Bootstrap` server.
+
+* start Apache ShenYu Bootstrap in `bin` directory.
+
+```
+> windwos : start.bat
+
+> linux : ./start.sh
+```
+
+> After completing these operations, you will deploy `ShenYu Boostrap` Cluster.
+>
+> For example. you will deploy `ShenYu Bootstrap` in `10.1.1.1` and `10.1.1.2` and deploy nginx in `10.1.1.3`.
+
+### Start Nginx
+
+* download and install `nginx`.
+
+* modify `upstream` and `server` of configuration in `nginx.conf`.
+
+```conf
+upstream shenyu_gateway_cluster {
+ ip_hash;
+ server 10.1.1.1:9195 max_fails=3 fail_timeout=10s weight=50;
+ server 10.1.1.2:9195 max_fails=3 fail_timeout=10s weight=50;
+}
+```
+
+```conf
+server {
+ location / {
+ proxy_pass http://shenyu_gateway_cluster;
+ proxy_set_header HOST $host;
+ proxy_read_timeout 10s;
+ proxy_connect_timeout 10s;
+ }
+}
+```
+
+* start nginx.
+
+```
+> windows: ./nginx.exe
+
+> linux: /usr/local/nginx/sbin/nginx
+```
+
+* verify nginx, looking at your `ShenYu Bootstrap` log or `Nginx` log, Where will the verification request go.
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/deployment/deployment-cluster.md b/i18n/zh/docusaurus-plugin-content-docs/current/deployment/deployment-cluster.md
new file mode 100644
index 0000000000..77484fa735
--- /dev/null
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/deployment/deployment-cluster.md
@@ -0,0 +1,85 @@
+---
+sidebar_position: 7
+title: 集群部署
+keywords: ["网关集群", "集群部署"]
+description: 集群部署
+---
+
+文本是介绍在集群环境中快速部署`ShenYu`网关。
+
+> 在阅读本文档时，你可以先阅读[二进制包部署](./deployment-package.md)。
+
+### 环境准备
+
+* 至少准备两台已经安装了JDK1.8+的服务器用于部署网关启动器。
+* 准备一台已经安装了mysql、pgsql、h2和JDK1.8+的服务器用于部署网关管理端。
+* 准备一台服务器用于部署Nginx。
+
+### 启动 Apache ShenYu Admin
+
+* 在你的网关管理端服务器下载并解压`apache-shenyu-incubating-${current.version}-admin-bin.tar.gz`。
+
+* 配置你的数据库，进入`/conf`目录，在`application.yaml`文件中修改`spring.profiles.active`节点为`mysql`, `pg` or `h2`。
+
+* 配置你的数据同步方式，进入`/conf`目录，在`application.yaml`文件中修改`shenyu.sync`节点为`websocket`, `http`, `zookeeper`, `etcd`, `consul` 或者 `nacos`。
+
+* 进入`bin`目录，启动ShenYu Bootstrap。
+
+```
+> windows: start.bat
+
+> linux: ./start.sh
+```
+
+### 启动 Apache ShenYu Boostrap
+
+* 在你的网关启动器服务器下载并解压`apache-shenyu-incubating-${current.version}-bootstrap-bin.tar.gz`。
+
+* 配置你的数据同步方式，进入`/conf`目录，在`application.yaml`文件中修改`shenyu.sync`节点为`websocket`, `http`, `zookeeper`, `etcd`, `consul` 或者 `nacos`，这个配置必须与`ShenyYu Admin`的配置保持相同。
+
+* 进入`bin`目录，启动ShenYu Admin。
+
+```
+> windwos : start.bat
+
+> linux : ./start.sh
+```
+
+> 在完成这些操作后，你将成功部署`ShenYu Boostrap`集群。
+>
+> 假如你`10.1.1.1`和`10.1.1.2`两台服务器在将部署`ShenYu Bootstrap`，并且在`10.1.1.3`部署nginx。
+
+### 启动 Nginx
+
+* 下载并安装nginx。
+
+* 在`nginx.conf`文件中修改`upstream`和`server`节点的配置。
+
+```conf
+upstream shenyu_gateway_cluster {
+ ip_hash;
+ server 10.1.1.1:9195 max_fails=3 fail_timeout=10s weight=50;
+ server 10.1.1.2:9195 max_fails=3 fail_timeout=10s weight=50;
+}
+```
+
+```conf
+server {
+ location / {
+ proxy_pass http://shenyu_gateway_cluster;
+ proxy_set_header HOST $host;
+ proxy_read_timeout 10s;
+ proxy_connect_timeout 10s;
+ }
+}
+```
+
+* 启动 nginx.
+
+```
+> windows: ./nginx.exe
+
+> linux: /usr/local/nginx/sbin/nginx
+```
+
+* 验证nginx配置是否生效，在`ShenYu Bootstrap`或者`Nginx`的日志文件中查看请求被分发到那台服务器上。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.4.0/deployment/deployment-cluster.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.4.0/deployment/deployment-cluster.md
new file mode 100644
index 0000000000..77484fa735
--- /dev/null
+++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.4.0/deployment/deployment-cluster.md
@@ -0,0 +1,85 @@
+---
+sidebar_position: 7
+title: 集群部署
+keywords: ["网关集群", "集群部署"]
+description: 集群部署
+---
+
+文本是介绍在集群环境中快速部署`ShenYu`网关。
+
+> 在阅读本文档时，你可以先阅读[二进制包部署](./deployment-package.md)。
+
+### 环境准备
+
+* 至少准备两台已经安装了JDK1.8+的服务器用于部署网关启动器。
+* 准备一台已经安装了mysql、pgsql、h2和JDK1.8+的服务器用于部署网关管理端。
+* 准备一台服务器用于部署Nginx。
+
+### 启动 Apache ShenYu Admin
+
+* 在你的网关管理端服务器下载并解压`apache-shenyu-incubating-${current.version}-admin-bin.tar.gz`。
+
+* 配置你的数据库，进入`/conf`目录，在`application.yaml`文件中修改`spring.profiles.active`节点为`mysql`, `pg` or `h2`。
+
+* 配置你的数据同步方式，进入`/conf`目录，在`application.yaml`文件中修改`shenyu.sync`节点为`websocket`, `http`, `zookeeper`, `etcd`, `consul` 或者 `nacos`。
+
+* 进入`bin`目录，启动ShenYu Bootstrap。
+
+```
+> windows: start.bat
+
+> linux: ./start.sh
+```
+
+### 启动 Apache ShenYu Boostrap
+
+* 在你的网关启动器服务器下载并解压`apache-shenyu-incubating-${current.version}-bootstrap-bin.tar.gz`。
+
+* 配置你的数据同步方式，进入`/conf`目录，在`application.yaml`文件中修改`shenyu.sync`节点为`websocket`, `http`, `zookeeper`, `etcd`, `consul` 或者 `nacos`，这个配置必须与`ShenyYu Admin`的配置保持相同。
+
+* 进入`bin`目录，启动ShenYu Admin。
+
+```
+> windwos : start.bat
+
+> linux : ./start.sh
+```
+
+> 在完成这些操作后，你将成功部署`ShenYu Boostrap`集群。
+>
+> 假如你`10.1.1.1`和`10.1.1.2`两台服务器在将部署`ShenYu Bootstrap`，并且在`10.1.1.3`部署nginx。
+
+### 启动 Nginx
+
+* 下载并安装nginx。
+
+* 在`nginx.conf`文件中修改`upstream`和`server`节点的配置。
+
+```conf
+upstream shenyu_gateway_cluster {
+ ip_hash;
+ server 10.1.1.1:9195 max_fails=3 fail_timeout=10s weight=50;
+ server 10.1.1.2:9195 max_fails=3 fail_timeout=10s weight=50;
+}
+```
+
+```conf
+server {
+ location / {
+ proxy_pass http://shenyu_gateway_cluster;
+ proxy_set_header HOST $host;
+ proxy_read_timeout 10s;
+ proxy_connect_timeout 10s;
+ }
+}
+```
+
+* 启动 nginx.
+
+```
+> windows: ./nginx.exe
+
+> linux: /usr/local/nginx/sbin/nginx
+```
+
+* 验证nginx配置是否生效，在`ShenYu Bootstrap`或者`Nginx`的日志文件中查看请求被分发到那台服务器上。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.4.1/deployment/deployment-cluster.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.4.1/deployment/deployment-cluster.md
new file mode 100644
index 0000000000..77484fa735
--- /dev/null
+++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.4.1/deployment/deployment-cluster.md
@@ -0,0 +1,85 @@
+---
+sidebar_position: 7
+title: 集群部署
+keywords: ["网关集群", "集群部署"]
+description: 集群部署
+---
+
+文本是介绍在集群环境中快速部署`ShenYu`网关。
+
+> 在阅读本文档时，你可以先阅读[二进制包部署](./deployment-package.md)。
+
+### 环境准备
+
+* 至少准备两台已经安装了JDK1.8+的服务器用于部署网关启动器。
+* 准备一台已经安装了mysql、pgsql、h2和JDK1.8+的服务器用于部署网关管理端。
+* 准备一台服务器用于部署Nginx。
+
+### 启动 Apache ShenYu Admin
+
+* 在你的网关管理端服务器下载并解压`apache-shenyu-incubating-${current.version}-admin-bin.tar.gz`。
+
+* 配置你的数据库，进入`/conf`目录，在`application.yaml`文件中修改`spring.profiles.active`节点为`mysql`, `pg` or `h2`。
+
+* 配置你的数据同步方式，进入`/conf`目录，在`application.yaml`文件中修改`shenyu.sync`节点为`websocket`, `http`, `zookeeper`, `etcd`, `consul` 或者 `nacos`。
+
+* 进入`bin`目录，启动ShenYu Bootstrap。
+
+```
+> windows: start.bat
+
+> linux: ./start.sh
+```
+
+### 启动 Apache ShenYu Boostrap
+
+* 在你的网关启动器服务器下载并解压`apache-shenyu-incubating-${current.version}-bootstrap-bin.tar.gz`。
+
+* 配置你的数据同步方式，进入`/conf`目录，在`application.yaml`文件中修改`shenyu.sync`节点为`websocket`, `http`, `zookeeper`, `etcd`, `consul` 或者 `nacos`，这个配置必须与`ShenyYu Admin`的配置保持相同。
+
+* 进入`bin`目录，启动ShenYu Admin。
+
+```
+> windwos : start.bat
+
+> linux : ./start.sh
+```
+
+> 在完成这些操作后，你将成功部署`ShenYu Boostrap`集群。
+>
+> 假如你`10.1.1.1`和`10.1.1.2`两台服务器在将部署`ShenYu Bootstrap`，并且在`10.1.1.3`部署nginx。
+
+### 启动 Nginx
+
+* 下载并安装nginx。
+
+* 在`nginx.conf`文件中修改`upstream`和`server`节点的配置。
+
+```conf
+upstream shenyu_gateway_cluster {
+ ip_hash;
+ server 10.1.1.1:9195 max_fails=3 fail_timeout=10s weight=50;
+ server 10.1.1.2:9195 max_fails=3 fail_timeout=10s weight=50;
+}
+```
+
+```conf
+server {
+ location / {
+ proxy_pass http://shenyu_gateway_cluster;
+ proxy_set_header HOST $host;
+ proxy_read_timeout 10s;
+ proxy_connect_timeout 10s;
+ }
+}
+```
+
+* 启动 nginx.
+
+```
+> windows: ./nginx.exe
+
+> linux: /usr/local/nginx/sbin/nginx
+```
+
+* 验证nginx配置是否生效，在`ShenYu Bootstrap`或者`Nginx`的日志文件中查看请求被分发到那台服务器上。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.4.2/deployment/deployment-cluster.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.4.2/deployment/deployment-cluster.md
new file mode 100644
index 0000000000..77484fa735
--- /dev/null
+++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.4.2/deployment/deployment-cluster.md
@@ -0,0 +1,85 @@
+---
+sidebar_position: 7
+title: 集群部署
+keywords: ["网关集群", "集群部署"]
+description: 集群部署
+---
+
+文本是介绍在集群环境中快速部署`ShenYu`网关。
+
+> 在阅读本文档时，你可以先阅读[二进制包部署](./deployment-package.md)。
+
+### 环境准备
+
+* 至少准备两台已经安装了JDK1.8+的服务器用于部署网关启动器。
+* 准备一台已经安装了mysql、pgsql、h2和JDK1.8+的服务器用于部署网关管理端。
+* 准备一台服务器用于部署Nginx。
+
+### 启动 Apache ShenYu Admin
+
+* 在你的网关管理端服务器下载并解压`apache-shenyu-incubating-${current.version}-admin-bin.tar.gz`。
+
+* 配置你的数据库，进入`/conf`目录，在`application.yaml`文件中修改`spring.profiles.active`节点为`mysql`, `pg` or `h2`。
+
+* 配置你的数据同步方式，进入`/conf`目录，在`application.yaml`文件中修改`shenyu.sync`节点为`websocket`, `http`, `zookeeper`, `etcd`, `consul` 或者 `nacos`。
+
+* 进入`bin`目录，启动ShenYu Bootstrap。
+
+```
+> windows: start.bat
+
+> linux: ./start.sh
+```
+
+### 启动 Apache ShenYu Boostrap
+
+* 在你的网关启动器服务器下载并解压`apache-shenyu-incubating-${current.version}-bootstrap-bin.tar.gz`。
+
+* 配置你的数据同步方式，进入`/conf`目录，在`application.yaml`文件中修改`shenyu.sync`节点为`websocket`, `http`, `zookeeper`, `etcd`, `consul` 或者 `nacos`，这个配置必须与`ShenyYu Admin`的配置保持相同。
+
+* 进入`bin`目录，启动ShenYu Admin。
+
+```
+> windwos : start.bat
+
+> linux : ./start.sh
+```
+
+> 在完成这些操作后，你将成功部署`ShenYu Boostrap`集群。
+>
+> 假如你`10.1.1.1`和`10.1.1.2`两台服务器在将部署`ShenYu Bootstrap`，并且在`10.1.1.3`部署nginx。
+
+### 启动 Nginx
+
+* 下载并安装nginx。
+
+* 在`nginx.conf`文件中修改`upstream`和`server`节点的配置。
+
+```conf
+upstream shenyu_gateway_cluster {
+ ip_hash;
+ server 10.1.1.1:9195 max_fails=3 fail_timeout=10s weight=50;
+ server 10.1.1.2:9195 max_fails=3 fail_timeout=10s weight=50;
+}
+```
+
+```conf
+server {
+ location / {
+ proxy_pass http://shenyu_gateway_cluster;
+ proxy_set_header HOST $host;
+ proxy_read_timeout 10s;
+ proxy_connect_timeout 10s;
+ }
+}
+```
+
+* 启动 nginx.
+
+```
+> windows: ./nginx.exe
+
+> linux: /usr/local/nginx/sbin/nginx
+```
+
+* 验证nginx配置是否生效，在`ShenYu Bootstrap`或者`Nginx`的日志文件中查看请求被分发到那台服务器上。
diff --git a/i18n/zh/docusaurus-plugin-content-docs/version-2.4.3/deployment/deployment-cluster.md b/i18n/zh/docusaurus-plugin-content-docs/version-2.4.3/deployment/deployment-cluster.md
new file mode 100644
index 0000000000..77484fa735
--- /dev/null
+++ b/i18n/zh/docusaurus-plugin-content-docs/version-2.4.3/deployment/deployment-cluster.md
@@ -0,0 +1,85 @@
+---
+sidebar_position: 7
+title: 集群部署
+keywords: ["网关集群", "集群部署"]
+description: 集群部署
+---
+
+文本是介绍在集群环境中快速部署`ShenYu`网关。
+
+> 在阅读本文档时，你可以先阅读[二进制包部署](./deployment-package.md)。
+
+### 环境准备
+
+* 至少准备两台已经安装了JDK1.8+的服务器用于部署网关启动器。
+* 准备一台已经安装了mysql、pgsql、h2和JDK1.8+的服务器用于部署网关管理端。
+* 准备一台服务器用于部署Nginx。
+
+### 启动 Apache ShenYu Admin
+
+* 在你的网关管理端服务器下载并解压`apache-shenyu-incubating-${current.version}-admin-bin.tar.gz`。
+
+* 配置你的数据库，进入`/conf`目录，在`application.yaml`文件中修改`spring.profiles.active`节点为`mysql`, `pg` or `h2`。
+
+* 配置你的数据同步方式，进入`/conf`目录，在`application.yaml`文件中修改`shenyu.sync`节点为`websocket`, `http`, `zookeeper`, `etcd`, `consul` 或者 `nacos`。
+
+* 进入`bin`目录，启动ShenYu Bootstrap。
+
+```
+> windows: start.bat
+
+> linux: ./start.sh
+```
+
+### 启动 Apache ShenYu Boostrap
+
+* 在你的网关启动器服务器下载并解压`apache-shenyu-incubating-${current.version}-bootstrap-bin.tar.gz`。
+
+* 配置你的数据同步方式，进入`/conf`目录，在`application.yaml`文件中修改`shenyu.sync`节点为`websocket`, `http`, `zookeeper`, `etcd`, `consul` 或者 `nacos`，这个配置必须与`ShenyYu Admin`的配置保持相同。
+
+* 进入`bin`目录，启动ShenYu Admin。
+
+```
+> windwos : start.bat
+
+> linux : ./start.sh
+```
+
+> 在完成这些操作后，你将成功部署`ShenYu Boostrap`集群。
+>
+> 假如你`10.1.1.1`和`10.1.1.2`两台服务器在将部署`ShenYu Bootstrap`，并且在`10.1.1.3`部署nginx。
+
+### 启动 Nginx
+
+* 下载并安装nginx。
+
+* 在`nginx.conf`文件中修改`upstream`和`server`节点的配置。
+
+```conf
+upstream shenyu_gateway_cluster {
+ ip_hash;
+ server 10.1.1.1:9195 max_fails=3 fail_timeout=10s weight=50;
+ server 10.1.1.2:9195 max_fails=3 fail_timeout=10s weight=50;
+}
+```
+
+```conf
+server {
+ location / {
+ proxy_pass http://shenyu_gateway_cluster;
+ proxy_set_header HOST $host;
+ proxy_read_timeout 10s;
+ proxy_connect_timeout 10s;
+ }
+}
+```
+
+* 启动 nginx.
+
+```
+> windows: ./nginx.exe
+
+> linux: /usr/local/nginx/sbin/nginx
+```
+
+* 验证nginx配置是否生效，在`ShenYu Bootstrap`或者`Nginx`的日志文件中查看请求被分发到那台服务器上。
diff --git a/versioned_docs/version-2.4.0/deployment/deployment-cluster.md b/versioned_docs/version-2.4.0/deployment/deployment-cluster.md
new file mode 100644
index 0000000000..470a0030a5
--- /dev/null
+++ b/versioned_docs/version-2.4.0/deployment/deployment-cluster.md
@@ -0,0 +1,87 @@
+---
+sidebar_position: 7
+title: Cluster Deployment
+keywords: ["Gateway Cluster Enviroment", "Cluster Enviroment"]
+description: Cluster Delopyment
+---
+
+This aritcle introduces how to delopy the `Shenyu` gateway in cluster enviroment.
+
+> In this part, you can see [ShenYu Binary Packages Deployment](./deployment-package.md) before deploying.
+
+### Enviromental Preparation
+
+* Two or more Gateway Boostrap servers, these servers must install JDK1.8+.
+* A server for Gateway Admin, this server must install mysql/pgsql/h2 and JDK1.8+.
+* A server for nginx.
+
+### Start Apache ShenYu Admin
+
+* download and unzip `apache-shenyu-incubating-${current.version}-admin-bin.tar.gz` in your Gateway Admin server.
+
+* config your database, go to the `/conf` directory, and modify `spring.profiles.active` of the configuration in `application.yaml` to `mysql`, `pg` or `h2`.
+
+* config your way of synchronization, go to the `/conf` directory, and modify `shenyu.sync` of configuration in `application.yaml` to `websocket`, `http`, `zookeeper`, `etcd`, `consul` or `nacos`.
+
+* start Apache ShenYu Admin in `bin` directory.
+
+```
+> windows: start.bat
+
+> linux: ./start.sh
+```
+
+### Start Apache ShenYu Boostrap
+
+* download and unzip `apache-shenyu-incubating-${current.version}-bootstrap-bin.tar.gz` in your Gateway Boostrap server.
+
+* config your synchronization, go to the `/conf` directory, and modify `shenyu.sync` of configuration in `application.yaml` to `websocket`, `http`, `zookeeper`, `etcd`, `consul` or `nacos`, this configuaration must remain the same of `ShenyYu Admin`.
+
+* repeat above-mentioned operations in each `ShenYu Bootstrap` server.
+
+* start Apache ShenYu Bootstrap in `bin` directory.
+
+```
+> windwos : start.bat
+
+> linux : ./start.sh
+```
+
+> After completing these operations, you will deploy `ShenYu Boostrap` Cluster.
+>
+> For example. you will deploy `ShenYu Bootstrap` in `10.1.1.1` and `10.1.1.2` and deploy nginx in `10.1.1.3`.
+
+### Start Nginx
+
+* download and install `nginx`.
+
+* modify `upstream` and `server` of configuration in `nginx.conf`.
+
+```conf
+upstream shenyu_gateway_cluster {
+ ip_hash;
+ server 10.1.1.1:9195 max_fails=3 fail_timeout=10s weight=50;
+ server 10.1.1.2:9195 max_fails=3 fail_timeout=10s weight=50;
+}
+```
+
+```conf
+server {
+ location / {
+ proxy_pass http://shenyu_gateway_cluster;
+ proxy_set_header HOST $host;
+ proxy_read_timeout 10s;
+ proxy_connect_timeout 10s;
+ }
+}
+```
+
+* start nginx.
+
+```
+> windows: ./nginx.exe
+
+> linux: /usr/local/nginx/sbin/nginx
+```
+
+* verify nginx, looking at your `ShenYu Bootstrap` log or `Nginx` log, Where will the verification request go.
diff --git a/versioned_docs/version-2.4.1/deployment/deployment-cluster.md b/versioned_docs/version-2.4.1/deployment/deployment-cluster.md
new file mode 100644
index 0000000000..470a0030a5
--- /dev/null
+++ b/versioned_docs/version-2.4.1/deployment/deployment-cluster.md
@@ -0,0 +1,87 @@
+---
+sidebar_position: 7
+title: Cluster Deployment
+keywords: ["Gateway Cluster Enviroment", "Cluster Enviroment"]
+description: Cluster Delopyment
+---
+
+This aritcle introduces how to delopy the `Shenyu` gateway in cluster enviroment.
+
+> In this part, you can see [ShenYu Binary Packages Deployment](./deployment-package.md) before deploying.
+
+### Enviromental Preparation
+
+* Two or more Gateway Boostrap servers, these servers must install JDK1.8+.
+* A server for Gateway Admin, this server must install mysql/pgsql/h2 and JDK1.8+.
+* A server for nginx.
+
+### Start Apache ShenYu Admin
+
+* download and unzip `apache-shenyu-incubating-${current.version}-admin-bin.tar.gz` in your Gateway Admin server.
+
+* config your database, go to the `/conf` directory, and modify `spring.profiles.active` of the configuration in `application.yaml` to `mysql`, `pg` or `h2`.
+
+* config your way of synchronization, go to the `/conf` directory, and modify `shenyu.sync` of configuration in `application.yaml` to `websocket`, `http`, `zookeeper`, `etcd`, `consul` or `nacos`.
+
+* start Apache ShenYu Admin in `bin` directory.
+
+```
+> windows: start.bat
+
+> linux: ./start.sh
+```
+
+### Start Apache ShenYu Boostrap
+
+* download and unzip `apache-shenyu-incubating-${current.version}-bootstrap-bin.tar.gz` in your Gateway Boostrap server.
+
+* config your synchronization, go to the `/conf` directory, and modify `shenyu.sync` of configuration in `application.yaml` to `websocket`, `http`, `zookeeper`, `etcd`, `consul` or `nacos`, this configuaration must remain the same of `ShenyYu Admin`.
+
+* repeat above-mentioned operations in each `ShenYu Bootstrap` server.
+
+* start Apache ShenYu Bootstrap in `bin` directory.
+
+```
+> windwos : start.bat
+
+> linux : ./start.sh
+```
+
+> After completing these operations, you will deploy `ShenYu Boostrap` Cluster.
+>
+> For example. you will deploy `ShenYu Bootstrap` in `10.1.1.1` and `10.1.1.2` and deploy nginx in `10.1.1.3`.
+
+### Start Nginx
+
+* download and install `nginx`.
+
+* modify `upstream` and `server` of configuration in `nginx.conf`.
+
+```conf
+upstream shenyu_gateway_cluster {
+ ip_hash;
+ server 10.1.1.1:9195 max_fails=3 fail_timeout=10s weight=50;
+ server 10.1.1.2:9195 max_fails=3 fail_timeout=10s weight=50;
+}
+```
+
+```conf
+server {
+ location / {
+ proxy_pass http://shenyu_gateway_cluster;
+ proxy_set_header HOST $host;
+ proxy_read_timeout 10s;
+ proxy_connect_timeout 10s;
+ }
+}
+```
+
+* start nginx.
+
+```
+> windows: ./nginx.exe
+
+> linux: /usr/local/nginx/sbin/nginx
+```
+
+* verify nginx, looking at your `ShenYu Bootstrap` log or `Nginx` log, Where will the verification request go.
diff --git a/versioned_docs/version-2.4.2/deployment/deployment-cluster.md b/versioned_docs/version-2.4.2/deployment/deployment-cluster.md
new file mode 100644
index 0000000000..470a0030a5
--- /dev/null
+++ b/versioned_docs/version-2.4.2/deployment/deployment-cluster.md
@@ -0,0 +1,87 @@
+---
+sidebar_position: 7
+title: Cluster Deployment
+keywords: ["Gateway Cluster Enviroment", "Cluster Enviroment"]
+description: Cluster Delopyment
+---
+
+This aritcle introduces how to delopy the `Shenyu` gateway in cluster enviroment.
+
+> In this part, you can see [ShenYu Binary Packages Deployment](./deployment-package.md) before deploying.
+
+### Enviromental Preparation
+
+* Two or more Gateway Boostrap servers, these servers must install JDK1.8+.
+* A server for Gateway Admin, this server must install mysql/pgsql/h2 and JDK1.8+.
+* A server for nginx.
+
+### Start Apache ShenYu Admin
+
+* download and unzip `apache-shenyu-incubating-${current.version}-admin-bin.tar.gz` in your Gateway Admin server.
+
+* config your database, go to the `/conf` directory, and modify `spring.profiles.active` of the configuration in `application.yaml` to `mysql`, `pg` or `h2`.
+
+* config your way of synchronization, go to the `/conf` directory, and modify `shenyu.sync` of configuration in `application.yaml` to `websocket`, `http`, `zookeeper`, `etcd`, `consul` or `nacos`.
+
+* start Apache ShenYu Admin in `bin` directory.
+
+```
+> windows: start.bat
+
+> linux: ./start.sh
+```
+
+### Start Apache ShenYu Boostrap
+
+* download and unzip `apache-shenyu-incubating-${current.version}-bootstrap-bin.tar.gz` in your Gateway Boostrap server.
+
+* config your synchronization, go to the `/conf` directory, and modify `shenyu.sync` of configuration in `application.yaml` to `websocket`, `http`, `zookeeper`, `etcd`, `consul` or `nacos`, this configuaration must remain the same of `ShenyYu Admin`.
+
+* repeat above-mentioned operations in each `ShenYu Bootstrap` server.
+
+* start Apache ShenYu Bootstrap in `bin` directory.
+
+```
+> windwos : start.bat
+
+> linux : ./start.sh
+```
+
+> After completing these operations, you will deploy `ShenYu Boostrap` Cluster.
+>
+> For example. you will deploy `ShenYu Bootstrap` in `10.1.1.1` and `10.1.1.2` and deploy nginx in `10.1.1.3`.
+
+### Start Nginx
+
+* download and install `nginx`.
+
+* modify `upstream` and `server` of configuration in `nginx.conf`.
+
+```conf
+upstream shenyu_gateway_cluster {
+ ip_hash;
+ server 10.1.1.1:9195 max_fails=3 fail_timeout=10s weight=50;
+ server 10.1.1.2:9195 max_fails=3 fail_timeout=10s weight=50;
+}
+```
+
+```conf
+server {
+ location / {
+ proxy_pass http://shenyu_gateway_cluster;
+ proxy_set_header HOST $host;
+ proxy_read_timeout 10s;
+ proxy_connect_timeout 10s;
+ }
+}
+```
+
+* start nginx.
+
+```
+> windows: ./nginx.exe
+
+> linux: /usr/local/nginx/sbin/nginx
+```
+
+* verify nginx, looking at your `ShenYu Bootstrap` log or `Nginx` log, Where will the verification request go.
diff --git a/versioned_docs/version-2.4.3/deployment/deployment-cluster.md b/versioned_docs/version-2.4.3/deployment/deployment-cluster.md
new file mode 100644
index 0000000000..470a0030a5
--- /dev/null
+++ b/versioned_docs/version-2.4.3/deployment/deployment-cluster.md
@@ -0,0 +1,87 @@
+---
+sidebar_position: 7
+title: Cluster Deployment
+keywords: ["Gateway Cluster Enviroment", "Cluster Enviroment"]
+description: Cluster Delopyment
+---
+
+This aritcle introduces how to delopy the `Shenyu` gateway in cluster enviroment.
+
+> In this part, you can see [ShenYu Binary Packages Deployment](./deployment-package.md) before deploying.
+
+### Enviromental Preparation
+
+* Two or more Gateway Boostrap servers, these servers must install JDK1.8+.
+* A server for Gateway Admin, this server must install mysql/pgsql/h2 and JDK1.8+.
+* A server for nginx.
+
+### Start Apache ShenYu Admin
+
+* download and unzip `apache-shenyu-incubating-${current.version}-admin-bin.tar.gz` in your Gateway Admin server.
+
+* config your database, go to the `/conf` directory, and modify `spring.profiles.active` of the configuration in `application.yaml` to `mysql`, `pg` or `h2`.
+
+* config your way of synchronization, go to the `/conf` directory, and modify `shenyu.sync` of configuration in `application.yaml` to `websocket`, `http`, `zookeeper`, `etcd`, `consul` or `nacos`.
+
+* start Apache ShenYu Admin in `bin` directory.
+
+```
+> windows: start.bat
+
+> linux: ./start.sh
+```
+
+### Start Apache ShenYu Boostrap
+
+* download and unzip `apache-shenyu-incubating-${current.version}-bootstrap-bin.tar.gz` in your Gateway Boostrap server.
+
+* config your synchronization, go to the `/conf` directory, and modify `shenyu.sync` of configuration in `application.yaml` to `websocket`, `http`, `zookeeper`, `etcd`, `consul` or `nacos`, this configuaration must remain the same of `ShenyYu Admin`.
+
+* repeat above-mentioned operations in each `ShenYu Bootstrap` server.
+
+* start Apache ShenYu Bootstrap in `bin` directory.
+
+```
+> windwos : start.bat
+
+> linux : ./start.sh
+```
+
+> After completing these operations, you will deploy `ShenYu Boostrap` Cluster.
+>
+> For example. you will deploy `ShenYu Bootstrap` in `10.1.1.1` and `10.1.1.2` and deploy nginx in `10.1.1.3`.
+
+### Start Nginx
+
+* download and install `nginx`.
+
+* modify `upstream` and `server` of configuration in `nginx.conf`.
+
+```conf
+upstream shenyu_gateway_cluster {
+ ip_hash;
+ server 10.1.1.1:9195 max_fails=3 fail_timeout=10s weight=50;
+ server 10.1.1.2:9195 max_fails=3 fail_timeout=10s weight=50;
+}
+```
+
+```conf
+server {
+ location / {
+ proxy_pass http://shenyu_gateway_cluster;
+ proxy_set_header HOST $host;
+ proxy_read_timeout 10s;
+ proxy_connect_timeout 10s;
+ }
+}
+```
+
+* start nginx.
+
+```
+> windows: ./nginx.exe
+
+> linux: /usr/local/nginx/sbin/nginx
+```
+
+* verify nginx, looking at your `ShenYu Bootstrap` log or `Nginx` log, Where will the verification request go.