安装开发环境
第1步:安装CLI工具
Composer开发人员有一些有用的CLI工具。最重要的是composer-cli
,它包含所有必要的操作,所以我们先安装它。接下来,我们也会接听generator-hyperledger-composer
,composer-rest-server
并且Yeoman
。最后3个不是开发环境的核心部分,但如果您按照教程或开发与业务网络交互的应用程序,它们将非常有用,因此我们现在就可以安装它们。
请注意,您不应使用su
或sudo
用于以下npm命令。
1. Composer-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是一个生成应用程序的工具
npm install -g yo
第2步:安装Playground
如果您已经在线尝试过Composer,那么您将看到浏览器应用程序“Playground”。您也可以在开发计算机上本地运行它,为您提供用于查看和演示业务网络的UI。
1. 用于简单编辑和测试的浏览器应用商业网络:
npm install -g composer-playground@0.20
第3步:设置IDE(可忽略)
虽然浏览器应用程序可用于处理您的业务网络代码,但大多数用户更愿意在IDE中工作。我们最喜欢的是VSCode
,因为可以使用Composer扩展。
-
从以下URL安装VSCode:https://code.visualstudio.com/download
-
打开VSCode,转到Extensions,然后
Hyperledger Composer
从Marketplace中搜索并安装扩展程序。
第4步:安装Hyperledger Fabric
此步骤为您提供了部署业务网络的本地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 Docker Image:
cd ~/fabric-dev-servers
export FABRIC_VERSION=hlfv12
./downloadFabric.sh
恭喜,您现在已经安装了典型开发人员环境所需的所有内容。继续阅读以了解您将使用此环境开发和测试区块链业务网络的一些最常见的事情。
启动和停止Hyperledger Fabric
您可以使用一组脚本控制运行时,~/fabric-dev-servers
如果您遵循建议的默认值,则可以找到这些脚本。
第一次启动新运行时,您需要运行启动脚本,然后生成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卡,就像您第一次启动时一样。
启动Playground
要启动Web应用程序,请运行:
composer-playground
打开浏览器访问http://your_ip:8080/login
您应该在Web应用程序的“我的业务网络”屏幕上看到
PeerAdmin@hlfv1
您使用createPeerAdminCard
脚本创建的卡:如果您没有看到这一点,则可能无法正确启动!恭喜,您已经运行了所有组件,并且您还知道如何在完成开发会话时停止并拆除它们。