Hyperledger composer 系统要求
- 操作系统:Ubuntu Linux 14.04 / 16.04 LTS(均为64位)或Mac OS 10.12
- Docker Engine:版本17.03或更高版本
- Docker-Compose:版本1.8或更高版本
- 节点:8.9或更高(不支持版本9及更高版本)
- npm:v5.x
- git:2.9.x或更高
- Python:2.7.x
使用脚本下载所需要的基本环境
不要以管理员身份运行
curl -O https://hyperledger.github.io/composer/latest/prereqs-ubuntu.sh
chmod u+x prereqs-ubuntu.sh
执行脚本中间会提示sudo输入密码
./prereqs-ubuntu.sh
此时安装好 输入npm 如果没有提示信息 请进行如下操作:
sudo apt-get update
sudo apt-get install build-essential libssl-dev
curl -sL https://raw.githubusercontent.com/creationix/nvm/v0.33.8/install.sh -o install_nvm.sh
bash install_nvm.sh
source ~/.profile
到此基本环境已经下载
Composer开发人员有一些有用的CLI工具。最重要的是composer-cli,它包含所有必要的操作,所以我们先安装它。接下来,我们也会接听generator-hyperledger-composer,composer-rest-server并且Yeoman。最后3个不是开发环境的核心部分,但如果您遵循教程或开发与业务网络交互的应用程序,它们将非常有用,因此我们现在就可以安装它们
在用npm工具进行下载的时候 不要su和sudo 以下任何报错都说明您之前的npm包环境存在问题,如果有提示使用管理员进行安装提示,说明npm您之前安装过,在以下步骤您可能会出现无穷无尽的bug
- 官方文档提示: 不要su和sudo和root用户进行安装!!!
1.基本的CLI工具:
npm install -g composer-cli@0.20
2.用于在计算机上运行REST Server以将业务网络公开为RESTful API的实用程序:
npm install -g composer-rest-server@0.20
3.生成应用程序资产
npm install -g generator-hyperledger-composer@0.20
4.Yeoman是一个生成应用程序的工具,它利用generator-hyperledger-composer:
npm install -g yo
5.安装Playground
npm install -g composer-playground@0.20
完成以上操作后 我们可以进行下一步的安装
安装Hyperledger Fabric
1.在您选择的目录中(我们将假设~/fabric-dev-servers),获取.tar.gz包含安装Hyperledger Fabric的工具的文件:
mkdir ~/fabric-dev-servers && cd ~/fabric-dev-servers
curl -O https://raw.githubusercontent.com/hyperledger/composer-tools/master/packages/fabric-dev-servers/fabric-dev-servers.tar.gz
tar -xvf fabric-dev-servers.tar.gz
2.使用刚下载和解压缩的脚本下载本地Hyperledger Fabric v1.2运行时:
cd ~/fabric-dev-servers
export FABRIC_VERSION=hlfv12
./downloadFabric.sh
恭喜,您现在已经安装了典型开发人员环境所需的所有内容
此刻还有个坑 如果您的docker没有将用户添加进docker组,在此后也会出现bug
sudo gpasswd -a ${USER} docker
newgrp - docker
sudo service docker restart
在./downloadFabric.sh 执行脚本的过程中 不建议用docker国内镜像源 会有问题 如果您能配置ubuntu科学上网 是最好的
启动和停止Hyperledger Fabric
第一次启动新运行时,您需要运行启动脚本,然后生成PeerAdmin卡:
cd ~/fabric-dev-servers
export FABRIC_VERSION=hlfv12
./startFabric.sh
./createPeerAdminCard.sh
您可以使用启动和停止运行时/fabric-dev-servers/stopFabric.sh,然后再次启动它/fabric-dev-servers/startFabric.sh。
在开发会议结束时,您运行/fabric-dev-servers/stopFabric.sh,然后/fabric-dev-servers/teardownFabric.sh。请注意,如果您运行拆卸脚本,则下次启动运行时时,您需要创建一个新的PeerAdmin卡,就像您第一次启动时一样。
启动网络应用程序(“游乐场”)
要启动Web应用程序,请运行:
composer-playground
它通常会自动打开您的浏览器,地址如下:http:// localhost:8080 / login
销毁先前的docker设置
如果您之前使用过旧版本的Hyperledger Composer并且现在正在设置新安装,那么您可能希望终止并删除以前使用这些命令执行的所有Docker容器:
docker kill $(docker ps -q)
docker rm $(docker ps -aq)
docker rmi $(docker images dev-* -q)