Skip to content

Commit

Permalink
Merge pull request #1787 from wenlinlee/v3.6.1
Browse files Browse the repository at this point in the history
update pro && max tutorial doc
  • Loading branch information
wenlinlee authored Mar 12, 2024
2 parents d49e1c2 + e46f9df commit 0f62ba0
Show file tree
Hide file tree
Showing 10 changed files with 161 additions and 9 deletions.
2 changes: 1 addition & 1 deletion 3.x/zh_CN/docs/tutorial/max/deploy_max_by_buildchain.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 搭建Max版本区块链网络(build_chain一键搭建方式)
# 一键搭建Max版本区块链网络

标签:``build_chain`` ``搭建版区块链网络``

Expand Down
2 changes: 1 addition & 1 deletion 3.x/zh_CN/docs/tutorial/max/expand_max_withoutTars.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 扩容无tars max链
# 扩容Max版区块链节点(无tars管理台)

## 1. 脚本功能介绍

Expand Down
2 changes: 1 addition & 1 deletion 3.x/zh_CN/docs/tutorial/max/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,8 @@
.. toctree::
:maxdepth: 1
installation.md
deploy_max_by_buildchain.md
installation.md
max_builder.md
expand_max_withoutTars.md
```
2 changes: 1 addition & 1 deletion 3.x/zh_CN/docs/tutorial/max/installation.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 搭建Max版区块链网络
# 手动搭建Max版区块链网络

标签:``Max版区块链网络`` ``部署``

Expand Down
151 changes: 151 additions & 0 deletions 3.x/zh_CN/docs/tutorial/pro/deploy_pro_by_buildchain.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,151 @@
# 一键搭建Pro版区块链网络

标签:``build_chain`` ``搭建版区块链网络``

----

```eval_rst
部署工具build_chain 脚本目标是让用户最快的部署和使用FISCO BCOS 无tars版Pro/max版本区块链
```

## 1. 脚本功能介绍

`build_chain.sh`脚本用于快速生成一条链中节点的配置文件,以下为用于无tars版pro/max 脚本选项功能介绍:

### **`C`选项[**Optional**]**

脚本的命令,支持 `deploy` ,默认为`deploy`:

- `deploy`: 用于部署新节点。

### **`g`选项[**Optional**]**

用于设置群组ID,若不设置,则默认为group0。

### **`I`选项[**Optional**]**

用于设置链ID,若未设置,则默认为chain0。

### **`V`选项[**Optional**]**

指定链版本(air、pro、max),默认为air。

### **`l`选项[**Optional**]**

生成节点的IP与对应IP上部署的区块链节点数目,参数格式为 `ip1:nodeNum1, ip2:nodeNum2`

在IP为`192.168.0.1`的机器上部署2个节点,IP为`127.0.0.1`的机器上部署4个节点的`l`选项示例如下:
`192.168.0.1:2, 127.0.0.1:4`

### **`p`选项[**Optional**]**

指定节点P2P、RPC、tars、tikv、monitor服务的监听的起始端口,默认起始端口分别为30300、20200、40400、2379、3901。

指定30300为P2P服务监听的起始端口;20200为RPC服务监听的起始端口示例如下:

```
# 指定节点P2P、RPC端口,其余端口为默认值
-p 30300,20200
```

### **`e`选项[**Optional**]**

指定本地已存在的Pro/Max版本rpc、gateway、nodef服务的二进制可执行文件路径,若不指定,则默认拉取最新版本的二进制,默认地址为binary文件夹内,例如pro版的二进制默认地址为BcosBuilder/pro/binary。

### **`y`选项[**Optional**]**

指定rpc、gateway、nodef服务的二进制下载方式,git或cdn,默认cdn。

### **`v`选项[**Optional**]**

指定rpc、gateway、nodef服务的二进制下载版本,默认为v3.4.0。

### **`r`选项[**Optional**]**

指定rpc、gateway、nodef服务的二进制下载路径,默认下载到binary文件夹。

### **`c`选项[**Optional**]**

用于指定服务的配置文件路径,此路径须包括config.toml。

### **`t`选项[**Optional**]**

指定操作的服务类型(rpc,gateway,node),默认为All,

### **`o`选项[**Optional**]**

指定生成的节点产物所在的目录,默认目录为 `./generated`

### **`s`选项[**Optional**]**

指定是否搭建全链路的国密区块链,国密区块链有如下特性:

- **区块链账本使用国密算法**: 使用sm2签名验签算法、sm3哈希算法以及sm4对称加解密算法。
- **SDK客户端与节点间采用国密SSL连接**
- **区块链节点之间采用国密SSL连接**

### **`h`选项[**Optional**]**

查看脚本使用用法。

## 2. 搭建Pro版区块链网络

### 2.1 安装依赖

部署工具`BcosBuilder`依赖`python3, curl, docker, docker-compose`,根据您使用的操作系统,使用以下命令安装依赖。

**安装Ubuntu依赖(版本不小于Ubuntu18.04)**

```shell
sudo apt-get update
sudo apt-get install -y curl docker.io docker-compose python3 wget
```

**安装CentOS依赖(版本不小于CentOS 7)**

```shell
sudo yum install -y curl docker docker-compose python3 python3-devel wget
```

**安装macOS依赖**

```
brew install curl docker docker-compose python3 wget
```

### 2.2部署无tars Pro版区块链网络

以下为4种部署链的示例

1、指定服务的ip和端口,自动生成配置文件

执行如下命令,可部署2机构RPC服务、Gateway服务和节点服务,p2p、gateway
和tars起始端口分别为30300、20200、40400,两机构的ip为172.31.184.227、172.30.93.111,每个机构下有两个节点,自动下载最新的二进制;

```
bash build_chain.sh -p 30300,20200,40400 -l 172.31.184.227:2,172.30.93.111:2 -C deploy -V pro -o generate -t all
```

2、部署国密链

执行如下命令,通过-s 指定部署国密链,通过-e 指定已有二进制路径

```
bash build_chain.sh -p 30300,20200,40400 -l 172.31.184.227:2,172.30.93.111:2 -C deploy -V pro -o generate -t all -e ./binary -s
```

3、指定下载二进制版本

执行如下命令,可部署2机构RPC服务、Gateway服务和节点服务,指定下载二进制的方式为cdn、版本v3.4.0和下载路径binaryPath

```
bash build_chain.sh -p 30300,20200 -l 172.31.184.227:2,172.30.93.111:2 -C deploy -V pro -o generate -y cdn -v v3.4.0 -r ./binaryPath
```

4、指定已有的配置文件

执行如下命令,根据已有的配置文件进行部署pro链

```
bash build_chain.sh -c config.toml -C deploy -V pro -o generate -t all
```
2 changes: 1 addition & 1 deletion 3.x/zh_CN/docs/tutorial/pro/expand_node.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 扩容tars新节点
# 手动扩容tars新节点

标签:``Pro版区块链网络`` ``扩容节点``

Expand Down
2 changes: 1 addition & 1 deletion 3.x/zh_CN/docs/tutorial/pro/expand_pro_withoutTars.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 扩容无tars新节点
# 一键扩容新节点(无tars管理台)

## 1. 脚本功能介绍

Expand Down
3 changes: 2 additions & 1 deletion 3.x/zh_CN/docs/tutorial/pro/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,8 @@
```eval_rst
.. toctree::
:maxdepth: 1
deploy_pro_by_buildchain.md
installation.md
installation_without_tars.md
config.md
Expand Down
2 changes: 1 addition & 1 deletion 3.x/zh_CN/docs/tutorial/pro/installation.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 搭建Pro版区块链网络
# 手动搭建Pro版区块链网络

标签:``Pro版区块链网络`` ``部署``

Expand Down
2 changes: 1 addition & 1 deletion 3.x/zh_CN/docs/tutorial/pro/installation_without_tars.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 搭建Pro版区块链网络(无tars管理台)
# 手动搭建Pro版区块链网络(无tars管理台)

标签:``Pro版区块链网络`` ``部署`` ``不依赖tars网页管理台``

Expand Down

0 comments on commit 0f62ba0

Please sign in to comment.