安装开发环境
本文主要说明如何获取并搭建Hyperledger Composer开发环境(主要用于创建业务网络,参见《Hyperledger Composer 十分钟搭建区块链》)以及创建Hyperledger Fabric(主要用于在本地运行/部署您的业务网络)。请注意,您创建的业务网络也可以部署到其他环境中的Hyperledger Fabric实例上,例如在云平台上。
开始之前
请确保您已按照安装先决条件中的说明安装了必需的先决条件 (参见《快速安装先决条件》)。
这些说明假定您以前没有安装过这些工具并使用它们。如果不是这种情况,那么在开始按照本指南进行操作之前,您可能需要检查以前的设置是否已被破坏。要了解如何执行此操作,请跳至附录。
为了提供灵活性并支持最大数量的开发,测试和部署方案,Composer作为一组组件提供,您可以使用npm和CLI中的控件进行安装。这些说明将告诉你如何预先安装所有东西,然后如何控制你的开发环境。
安装组件
请注意npm install命令中的@next。这对确保您安装适合Hyperledger Fabric v1.1的版本非常重要。
第1步:安装CLI工具
Composer开发人员有几个有用的CLI工具。最重要的是composer-cli,它包含了所有必要的操作,所以我们会先安装它。接下来,我们还将选择generator-hyperledger-composer,composer-rest-server和Yeoman加上generator-hyperledger-composer。最后3个不是开发环境的核心部分,但如果您遵循教程或开发与您的商业网络交互的应用程序,它们将非常有用,因此我们现在会安装它们。
基本的CLI工具:
请执行
npm install -g composer-cli@next
在您的计算机上运行REST服务器以将您的业务网络公开为RESTful API的实用程序:
请执行
npm install -g composer-rest-server@next
生成应用程序资产的有用工具:
请执行
npm install -g generator-hyperledger-composer@next
Yeoman是一个用于生成应用程序的工具,它使用了generator-hyperledger-composer:
请执行
npm install -g yo
第2步:安装试验场
如果您已经在线尝试了Composer,则会看到浏览器应用程序“Playground”。您也可以在您的开发机器上本地运行此功能,为您提供查看和演示业务网络的用户界面。
用于简单编辑和测试的浏览器应用商业网络:
请执行
npm install -g composer-playground@next
第3步:设置您的IDE
虽然浏览器应用程序可用于处理商业网络代码,但大多数用户更喜欢在IDE中工作。我们最喜欢的是VSCode,因为Composer扩展可用。
从此URL安装VSCode:https://code.visualstudio.com/download
打开VSCode,进入扩展,然后从市场中搜索并安装Hyperledger Composer扩展。
步骤4:安装Hyperledger Fabric
此步骤为您提供本地Hyperledger Fabric运行时来部署您的业务网络。
在您选择的目录(我们将假设〜/ fabric-tools)中,获取包含用于安装Hyperledger Fabric的工具的.tar.gz文件:
请执行
mkdir〜/ fabric-tools && cd〜/ fabric-tools
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:只需使用fabric-dev-servers.zip替换.tar.gz文件,并使用上述代码片段中的unzip命令替换tar -xvf命令。
使用刚刚下载并解压缩的脚本下载本地Hyperledger Fabric运行时:
请执行
cd 〜/fabric-tools
export FABRIC_VERSION = hlfv11
./downloadFabric.sh
恭喜,您现在已经安装了典型开发环境所需的一切。请继续阅读以了解您在此环境中开展并测试区块链商业网络时最常见的一些事情。
控制你的开发环境
启动和停止Hyperledger Fabric
您可以使用一组脚本来控制运行时间,如果您遵循了建议的默认值,您可以在〜/ fabric-tools中找到这些脚本。
第一次启动一个新的运行时,您需要运行启动脚本,然后生成一个PeerAdmin卡:
请执行
cd 〜/fabric-tools
export FABRIC_VERSION = hlfv11
./startFabric.sh
./createPeerAdminCard.sh
您可以使用 〜/fabric-tools/stopFabric.sh启动和停止运行时,然后使用〜/fabric-tools/startFabric.sh重新启动它。
在开发阶段结束时,运行〜/fabric-tools/stopFabric.sh,然后运行〜/fabric-tools/teardownFabric.sh。请注意,如果您已经运行了拆卸脚本,那么下次启动运行时,就需要像第一次启动时那样创建一个新的PeerAdmin卡。
本地运行环境旨在频繁启动,停止和拆除,以供开发使用。 如果您正在寻找具有更持久状态的运行环境,则需要在开发环境外部运行一个运行时环境,并将业务网络部署到该环境。 这方面的例子包括通过Kubernetes运行它,或者在诸如IBM Cloud之类的托管平台上运行它。 请参阅更多详情。
启动网络应用程序(“Playground”)
要启动Web应用程序,请运行:
composer-playground
它通常会自动打开您的浏览器,地址如下: http://localhost:8080/login
您应该在Web应用程序的“My Business Networks”屏幕上看到您使用createPeerAdminCard脚本创建的PeerAdmin@hlfv1卡片:如果您没有看到此信息,可能是您没有正确启动您的运行环境!
恭喜你,所有组件都在运行,并且在完成开发会话时,你也知道如何停下来并拆除它们。
接下来做什么?
了解如何使用Playground教程中的Web应用程序UI;
学习如何在开发者教程中使用CLI和VSCode工具.
本文首发于微信公众号:wfx_tech 欢迎关注交流 ^.^
网友评论