通过Docker搭建4节点的Tendermint集群
Tendermint：0.34.24
Docker：20.10.21
Docker-Compose：2.20.2
OS：Ubuntu 20.04
Go：1.19.2 Linux/amd64
1 修改Tendermint源码
1.1 修改监听IP
为什么要将127.0.1修改成0.0.0.0呢？因为容器内的服务如果是以127.0.0.1暴露的话，外部是无法通过端口映射访问docker容器内对应服务的。
127.0.0.1是一个特殊的IP地址，称为本地回环地址，只能用于在同一台计算机上的进程之间进行通信。当您将服务绑定到127.0.0.1地址时，它将只能在本机进行访问，无法通过外部网络访问该应用程序。
1.2 不产生空区块
1.3 统一ChainID
1.4 修改AddBookStrict为false，用来支持局域网通信
2 编译生成二进制可执行文件
make install
make install_abci
3 编写dockerfile定制镜像
FROM ubuntu
ENV MYPATH /usr/local
WORKDIR $MYPATH
ADD ./tendermint $MYPATH
ADD ./abci-cli $MYPATH
RUN apt update
RUN apt install curl
注意要将abci-cli和tendermint可执行文件与dockerfile文件放在同一目录下：
查看定制的docker镜像：
4 编写docker-compose编排容器
网络采用桥接模式，并对每个节点的RPC服务端口26657进行外部映射。
version: "3"
services:
node0:
image: tm
container_name: node0
ports:
- "26657:26657"
volumes:
- /usr/local/node0:$HOME/.tendermint
networks:
mynet:
ipv4_address: 172.20.20.0
command:
- /bin/bash
- -c
- |
./tendermint init
./tendermint show-node-id > $HOME/.tendermint/nodeid.txt
./abci-cli kvstore
node1:
image: tm
container_name: node1
ports:
- "36657:26657"
volumes:
- /usr/local/node1:$HOME/.tendermint
networks:
mynet:
ipv4_address: 172.20.20.1
command:
- /bin/bash
- -c
- |
./tendermint init
./tendermint show-node-id > $HOME/.tendermint/nodeid.txt
./abci-cli kvstore
node2:
image: tm
container_name: node2
ports:
- "46657:26657"
networks:
mynet:
ipv4_address: 172.20.20.2
volumes:
- /usr/local/node2:$HOME/.tendermint
command:
- /bin/bash
- -c
- |
./tendermint init
./tendermint show-node-id > $HOME/.tendermint/nodeid.txt
./abci-cli kvstore
node3:
image: tm
container_name: node3
ports:
- "56657:26657"
networks:
mynet:
ipv4_address: 172.20.20.3
volumes:
- /usr/local/node3:$HOME/.tendermint
command:
- /bin/bash
- -c
- |
./tendermint init
./tendermint show-node-id > $HOME/.tendermint/nodeid.txt
./abci-cli kvstore
networks:
mynet:
ipam:
driver: default
config:
- subnet: 172.20.0.0/16
启动容器：
docker-compose up -d
5 统一的genesis.json
因为容器卷的缘故，宿主机本地可以直接查看每个节点的config和data目录。
集群要求每个节点的genesis.json文件完全相同，并且包含所有节点的validator信息。
这里通过一个简单的Python脚本快速构建统一的genesis.json文件：
linesArr = []
for i in range(0, 4):
f = open("/usr/local/node%d/config/genesis.json" % i, 'r')
linesArr.append(f.readlines())
f.close()
f = open("./genesis.json", 'w')
for i in range(len(linesArr)):
lines = linesArr[i]
if i == 0:
for j in range(23):
f.write(lines[j])
for j in range(23, 32):
if i == len(linesArr) - 1:
f.write(lines[j])
else:
if j < 31:
f.write(lines[j])
else:
f.write(lines[j][:len(lines[j]) - 1])
f.write(",\n")
for i in range(32, len(linesArr[0])):
f.write(linesArr[0][i])
f.close()
生成的统一的genesis.json创世文件：
{
"genesis_time": "2024-01-06T02:17:15.806171802Z",
"chain_id": "test-chain",
"initial_height": "0",
"consensus_params": {
"block": {
"max_bytes": "22020096",
"max_gas": "50",
"time_iota_ms": "1000"
},
"evidence": {
"max_age_num_blocks": "100000",
"max_age_duration": "172800000000000",
"max_bytes": "1048576"
},
"validator": {
"pub_key_types": [
"ed25519"
]
},
"version": {}
},
"validators": [
{
"address": "6DE6C6F2CD5AD081A1B6C7A87FC915E04B1E2219",
"pub_key": {
"type": "tendermint/PubKeyEd25519",
"value": "iKt2epWBuZHFayrS4qb7AJAwbfSlrJxOsLSbwwsUn9A="
},
"power": "10",
"name": ""
},
{
"address": "5993A76300771C1EF633D6801FF53D5B6527127A",
"pub_key": {
"type": "tendermint/PubKeyEd25519",
"value": "uGc87MkuEtnMTcIQGUD22mNdTAQ7400FDqtIOkctbDg="
},
"power": "10",
"name": ""
},
{
"address": "039D64F5C23FD4CA0E4563B282B0B6F96CE278CB",
"pub_key": {
"type": "tendermint/PubKeyEd25519",
"value": "FWFS6CuHP+iOk8tktKfMm1A8WJIldFP+chjDj9AbD78="
},
"power": "10",
"name": ""
},
{
"address": "73BFE884FB6C97F170FED9A9699EDB1B3E5341C4",
"pub_key": {
"type": "tendermint/PubKeyEd25519",
"value": "xpPW7WNXZYJnUCOLT/Uv1czyfLEhpiDo7jN/DS/Ad2s="
},
"power": "10",
"name": ""
}
],
"app_hash": ""
}
覆盖掉原来的genesis.json文件：
6 启动集群
如果没在docker-compose手动指定各容器的IP，则通过docker inspect查询各容器的IP：
查看每个节点的nodeID，由于容器卷以及容器启动时会将nodeID重定向到nodeid.txt文件，我们在宿主机本地就能够访问。
最后构造出统一的启动命令：
./tendermint node --p2p.persistent_peers=“[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656”
7 验证集群是否启动成功
7.1 第一种验证方式：
可以看到，node2的peer数量为3
7.2 第二种验证方式：
向node0发送一条name=jackie的交易：
分别从node1、node2、node3查询交易，得到的结果是base64格式：
对返回的结果进行base64解码：
不过，通过命令行提交交易太繁琐了，我们干脆写个简单的测试程序，向node0提交500个交易：
func main() {
cli, err := http.New("http://localhost:26657", "/websocket")
if err != nil {
panic(err)
}
for i := 0; i < 500; i++ {
_, err = cli.BroadcastTxAsync(context.TODO(), types.Tx(strconv.Itoa(i)))
if err != nil {
panic(err)
}
}
}
会发现四个节点的区块全部同步到同一个高度：
如果我们让节点node0宕机，会发现其他三个节点会打印出node0宕机的信息:
最后优雅关闭所有容器：
至此。