Hyperledger Fabric是一个区块链框架的实现，是Linux基金会托管的Hyperledger项目之一，最初由Digital Asset和IBM贡献。Hyperledger Fabric允许组件即插即用(例如共识和成员服务)，这作为开发具有模块化架构的应用程序或解决方案的基础。Hyperledger Fabric利用容器技术来托管被称为“链代码”的智能合约，其中包含系统的应用程序逻辑。
由于Hyperledger Fabric环境配置的复杂性以及众所周知的网络原因，初次接触很难在短时间内配置完成。本项目通过docker in docker技术简化的环境配置，只需要一步即可完成环境搭建，只需要一条命令就可以构建第一个fabric网络。本项目提供的组件如下：
-
准备工作
docker pull mulinbc/hyperledger # 下载docker镜像文件 mkdir -p ~/.mulin/hyperledger/var-lib-docker # 创建存放fabric镜像的文件夹
-
运行docker镜像
docker run --privileged -p 22222:22 -p 80:8080 -p 8080:80 --name hyperledger -v ~/.mulin/hyperledger/var-lib-docker:/var/lib/docker -d mulinbc/hyperledger # 参数含义 # --privileged: 以特权模式运行容器 # -p: 端口映射，22222:22，将本机的22222端口映射到容器的22端口 # -v: 添加数据卷，/test:/soft，将本机的/test目录挂载到容器的/soft目录 # -d: 容器在后台运行 # -e: 指定环境变量，-e ROOT_PASSWORD=password，指定root 用户的密码为password # 例如: docker run --privileged -e ROOT_PASSWORD=password -p 22222:22 -p 80:8080 -p 8080:80 --name hyperledger -v ~/.mulin/hyperledger/var-lib-docker:/var/lib/docker -d mulinbc/hyperledger
-
进入容器
- 方法一
docker exec -it hyperledger sh- 方法二
ssh -p 22222 root@127.0.0.1 # 默认密码: root -
初始化hyperledger环境
bootstrap.sh init # 下载必要的fabric镜像 -
测试hyperledger环境
bootstrap.sh upnet # 启动第一个hyperledger网络 bootstrap.sh upexp # 启动hyperledger区块链浏览器
- 区块链浏览器：打开浏览器访问 http://localhost
- Composer：打开浏览器访问 http://localhost:8080
-
关闭hyperledger网络
bootstrap.sh down # 测试完后需要清除hyperledger网络
- 如遇到fabric网络不能启动，可以先运行
bootstrap.sh down后重试 - 如遇到explorer不能访问的情况检查
- 由于导入数据库需要一段时间，检查postgres容器是否启动完成，运行
docker logs postgres查看docker容器的日志，如果输出database system is ready to accept connections则说明容器启动成功，运行bootstrap.sh upexp重试 - 检查
～/hyperledger/blockchain-explorer/app/platform/fabric/config.json配置文件中的路径是否正确，配置方法参考https://github.com/hyperledger/blockchain-explorer#Fabric-Network-Setup - 如果启动的是
fabcar例子的话，需要将～/hyperledger/blockchain-explorer/app/platform/fabric/config.json配置文件中grpcs改为grpc，删除多余信息，检查配置路径
- 由于导入数据库需要一段时间，检查postgres容器是否启动完成，运行
- 如有建议或BUG可以创建issue，创建方法参考https://guides.github.com/features/issues
- 感谢sgerrand提供的alpine glibc库