如果是初次接触 Hyperledger Fabric 项目,推荐采用如下的步骤,基于 Docker-Compose 的一键部署。
官方文档现在也完善了安装部署的步骤,具体可以参考代码 doc
目录下内容。
动手前,建议适当了解一些 Docker 相关知识。
Docker 支持 Linux 常见的发行版,如 Redhat/Centos/Ubuntu 等。
$ curl -fsSL https://get.docker.com/ | sh
以 Ubuntu 14.04 为例,安装成功后,修改 Docker 服务配置(/etc/default/docker
文件)。
DOCKER_OPTS="$DOCKER_OPTS -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock --api-cors-header='*'"
重启 Docker 服务。
$ sudo service docker restart
Ubuntu 16.04 中默认采用了 systemd 管理启动服务,Docker 配置文件在 /etc/systemd/system/docker.service.d/override.conf
。
修改后,需要通过如下命令重启 Docker 服务。
$ sudo systemctl daemon-reload
$ sudo systemctl restart docker.service
首先,安装 python-pip 软件包。
$ sudo aptitude install python-pip
安装 docker-compose(推荐为 1.7.0 及以上版本)。
$ sudo pip install docker-compose>=1.7.0
目前 1.0 代码还没有正式发布,推荐使用 v0.6 分支代码进行测试。
下载相关镜像,并进行配置。
$ docker pull yeasy/hyperledger-fabric:0.6-dp \
&& docker pull yeasy/hyperledger-fabric-peer:0.6-dp \
&& docker pull yeasy/hyperledger-fabric-base:0.6-dp \
&& docker pull yeasy/blockchain-explorer:latest \
&& docker tag yeasy/hyperledger-fabric-peer:0.6-dp hyperledger/fabric-peer \
&& docker tag yeasy/hyperledger-fabric-base:0.6-dp hyperledger/fabric-baseimage \
&& docker tag yeasy/hyperledger-fabric:0.6-dp hyperledger/fabric-membersrvc
也可以使用 官方仓库 中的镜像。
$ docker pull hyperledger/fabric-peer:x86_64-0.6.1-preview \
&& docker pull hyperledger/fabric-membersrvc:x86_64-0.6.1-preview \
&& docker pull yeasy/blockchain-explorer:latest \
&& docker tag hyperledger/fabric-peer:x86_64-0.6.1-preview hyperledger/fabric-peer \
&& docker tag hyperledger/fabric-peer:x86_64-0.6.1-preview hyperledger/fabric-baseimage \
&& docker tag hyperledger/fabric-membersrvc:x86_64-0.6.1-preview hyperledger/fabric-membersrvc
之后,用户可以选择采用不同的一致性机制,包括 noops、pbft 两类。
noops 默认没有采用 consensus 机制,1 个节点即可,可以用来进行快速测试。
$ docker run --name=vp0 \
--restart=unless-stopped \
-it \
-p 7050:7050 \
-p 7051:7051 \
-v /var/run/docker.sock:/var/run/docker.sock \
-e CORE_PEER_ID=vp0 \
-e CORE_PEER_ADDRESSAUTODETECT=true \
-e CORE_NOOPS_BLOCK_WAIT=10 \
hyperledger/fabric-peer:latest peer node start
PBFT 是经典的分布式一致性算法,也是 hyperledger 目前最推荐的算法,该算法至少需要 4 个节点。
首先,下载 Compose 模板文件。
$ git clone https://github.com/yeasy/docker-compose-files
进入 hyperledger/0.6/pbft
目录,查看包括若干模板文件,功能如下。
4-peers.yml
: 启动 4 个 PBFT peer 节点。4-peers-with-membersrvc.yml
: 启动 4 个 PBFT peer 节点 + 1 个 CA 节点,并启用 CA 功能。4-peers-with-explorer.yml
: 启动 4 个 PBFT peer 节点 + 1 个 Blockchain-explorer,可以通过 Web 界面监控集群状态。4-peers-with-membersrvc-explorer.yml
: 启动 4 个 PBFT peer 节点 + 1 个 CA 节点 + 1 个 Blockchain-explorer,并启用 CA 功能。例如,快速启动一个 4 个 PBFT 节点的集群。
$ docker-compose -f 4-peers.yml up
上述方案的典型场景是单物理节点上部署多个 Peer 节点。如果要扩展到多物理节点,需要容器云平台的支持,如 Swarm 等。
当然,用户也可以分别在各个物理节点上通过手动启动容器的方案来实现跨主机组网,每个物理节点作为一个 peer 节点。
首先,以 4 节点下的 PBFT 模式为例,配置 4 台互相连通的物理机,分别按照上述步骤配置 Docker,下载镜像。
4 台物理机分别命名为 vp0 ~ vp3。
vp0 作为初始的探测节点。
$ docker run --name=vp0 \
--net="host" \
--restart=unless-stopped \
-it --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
-e CORE_PEER_ID=vp0 \
-e CORE_PBFT_GENERAL_N=4 \
-e CORE_LOGGING_LEVEL=debug \
-e CORE_PEER_ADDRESSAUTODETECT=true \
-e CORE_PEER_NETWORKID=dev \
-e CORE_PEER_VALIDATOR_CONSENSUS_PLUGIN=pbft \
-e CORE_PBFT_GENERAL_MODE=batch \
-e CORE_PBFT_GENERAL_TIMEOUT_REQUEST=10s \
hyperledger/fabric-peer:latest peer node start
以 vp1 为例,假如 vp0 的地址为 10.0.0.1。
$ NAME=vp1
$ ROOT_NODE=10.0.0.1
$ docker run --name=${NAME} \
--net="host" \
--restart=unless-stopped \
-it --rm \
-v /var/run/docker.sock:/var/run/docker.sock \
-e CORE_PEER_ID=${NAME} \
-e CORE_PBFT_GENERAL_N=4 \
-e CORE_LOGGING_LEVEL=debug \
-e CORE_PEER_ADDRESSAUTODETECT=true \
-e CORE_PEER_NETWORKID=dev \
-e CORE_PEER_VALIDATOR_CONSENSUS_PLUGIN=pbft \
-e CORE_PBFT_GENERAL_MODE=batch \
-e CORE_PBFT_GENERAL_TIMEOUT_REQUEST=10s \
-e CORE_PEER_DISCOVERY_ROOTNODE=${ROOT_NODE}:7051 \
hyperledger/fabric-peer:latest peer node start
Hyperledger 默认监听的服务端口包括: