安装开发环境
按照以下说明获取Hyperledger Composer开发工具(主要用于创建业务网络)并建立Hyperledger Fabric(主要用于在本地运行/部署业务网络)。请注意,您创建的业务网络也可以部署到其他环境(例如云平台)上的Hyperledger Fabric运行时。
在你开始之前
确保已按照安装先决条件中的说明安装了必需的先决条件。
这些说明假定您之前没有安装过这些工具并使用它们。如果不是这种情况,您可能需要在开始遵循本指南之前检查先前的设置是否已完全销毁。要了解如何执行此操作,请跳至附录。
为了提供灵活性并支持最大数量的开发,测试和部署方案,Composer作为一组组件提供,您可以
npm
通过CLI 安装和控制这些组件。这些说明将告诉您如何先安装所有内容,然后如何控制开发环境。
安装组件
第1步:安装CLI工具
Composer开发人员有一些有用的CLI工具。最重要的是composer-cli
,它包含所有必要的操作,所以我们先安装它。接下来,我们也会接听generator-hyperledger-composer
,composer-rest-server
并且Yeoman
。最后3个不是开发环境的核心部分,但如果您遵循教程或开发与业务网络交互的应用程序,它们将非常有用,因此我们现在就可以安装它们。
请注意,您不应使用su
或sudo
用于以下npm命令。
-
基本的CLI工具:
复制npm install -g composer-cli@0.20
-
用于在计算机上运行REST Server以将业务网络公开为RESTful API的实用程序:
复制npm install -g composer-rest-server@0.20
-
生成应用程序资产的有用实用程
复制npm install -g generator-hyperledger-composer@0.20
-
Yeoman是一个生成应用程序的工具,它利用
复制generator-hyperledger-composer
:npm install -g yo
第2步:安装Playground
如果您已经在线尝试过Composer,那么您将看到浏览器应用程序“Playground”。您也可以在开发计算机上本地运行它,为您提供用于查看和演示业务网络的UI。
-
用于简单编辑和测试的浏览器应用商业网络:
复制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运行时以部署您的业务网络。
-
在您选择的目录中(我们将假设
复制~/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
zip
如果您愿意,也可以使用A :只需使用前面代码段中的命令替换.tar.gz
文件fabric-dev-servers.zip
和tar -xvf
命令unzip
。 -
使用刚下载和解压缩的脚本下载本地Hyperledger Fabric v1.2运行时:
复制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卡,就像您第一次启动时一样。
本地运行时旨在经常启动,停止和拆除,以供开发使用。如果您正在寻找具有更持久状态的运行时,您将需要在开发环境之外运行一个,并将业务网络部署到它。这方面的示例包括通过Kubernetes运行它,或者在IBM Cloud等托管平台上运行它。
启动网络应用程序(“游乐场”)
要启动Web应用程序,请运行:
复制
composer-playground
它通常会自动打开您的浏览器,地址如下:http:// localhost:8080 / login
您应该在Web应用程序的“我的业务网络”屏幕上看到PeerAdmin@hlfv1
您使用createPeerAdminCard
脚本创建的卡:如果您没有看到这一点,则可能无法正确启动运行时!
恭喜,您已经运行了所有组件,并且您还知道如何在完成开发会话时停止并拆除它们。
接下来是什么?
- 了解如何在Playground Tutorial中使用Web应用程序UI
- 了解如何在Developer Tutorial中使用CLI和VSCode工具
附录:销毁先前的设置
如果您之前使用过旧版本的Hyperledger Composer并且现在正在设置新安装,那么您可能希望终止并删除以前使用这些命令执行的所有Docker容器:
复制
docker kill $(docker ps -q)
docker rm $(docker ps -aq)
docker rmi $(docker images dev-* -q)