Hyperledger Composer:建立一個簡單的區塊鏈初學者教程
本文介紹如何使用Hyperledger Composer/">Composer 建立簡單的區塊鏈應用程式 。
安裝先決條件 首先,您必須安裝Hyperledger Composer所需的先決條件。您需要安裝以下內容:
摘錄
- Docker Engine
- Docker Compose
- Node
- Npm
- Git
- Python
- 程式碼編輯器
可在此處找到有關先決條件安裝的詳細資訊: ofollow,noindex" target="_blank">安裝先決條件 安裝開發工具 安裝先決條件後,我們需要 安裝 應用程式開發所需的 不同元件(開發工具) 。
以下是上述安裝開發工具連結中定義的步驟:
1. 安裝CLI工具
npm install -g [email protected]
2.用於在計算機上執行REST Server以生成業務網路的RESTful API的實用程式:
npm install -g [email protected]
3.生成應用程式資產的程式
npm install -g [email protected]
4. 生成應用程式的Yeamon工具:
npm install -g yo
5.安裝playground
npm install -g [email protected]
6.安裝Hyperledger Fabric
在計算機主目錄中建立一個fabric-dev-servers的目錄,然後進入新建立的目錄:
mkdir ~/fabric-dev-servers && cd ~/fabric-dev-servers
7.下載.tar.gz解壓放在Hyperledger Fabric下:
curl -O https://raw.githubusercontent.com/hyperledger/composer-tools/master/packages/fabric-dev-servers/fabric-dev-servers.tar.gz
或者,如果要下載.zip檔案而不是.tar.gz,則可以執行以下命令:
curl -O https://raw.githubusercontent.com/hyperledger/composer-tools/master/packages/fabric-dev-servers/fabric-dev-servers.zip
解壓縮下載的.tar.gz檔案:
tar -xvf fabric-dev-servers.tar.gz
或者,如果已下載.zip檔案,則執行以下命令將其解壓縮:
unzip fabric-dev-servers.zip
請記住,您應該在fabric-dev-servers資料夾中:
cd ~/fabric-dev-servers/
pwd /Users/mukeshchapagain/fabric-dev-servers
8. 建立環境變數FABRIC_VERSION
export FABRIC_VERSION=hlfv12
9.下載Hyperledger Fabric v1.2執行包
要下載本地Hyperledger Fabric v1.2 runtime,請執行以下命令:
./downloadFabric.sh
您已成功安裝了開發環境所需的所有內容。
啟動和停止Hyperledger Fabric
只需確保您位於fabric-dev-servers資料夾中:
cd ~/fabric-dev-servers
執行以下命令以啟動Hypeledger Fabric:
./startFabric.sh
執行以下命令以生成PeerAdmin卡:
./createPeerAdminCard.sh
如果要重新啟動結構伺服器,首先需要將其停止然後再次啟動它:
./stopFabric.sh
./startFabric.sh
您也可以拆除Fabric伺服器。為此,首先你必須停止Fabric伺服器然後拆除它。
./stopFabric.sh
./teardownFabric.sh
如果您拆除Fabric伺服器,那麼下次啟動它時,您必須建立對等管理員卡。因此,在拆除伺服器之後,需要執行以下命令才能正確啟動它:
./startFabric.sh
./createPeerAdminCard.sh
使用以下命令啟動composer playground web app:
composer-playground
Hyperledger Composer Playground提供使用者介面,您可以從中建立,部署和測試區塊鏈業務網路。
建立Hypeledger Composer區塊鏈應用程式
在本節中,我們不會使用composer playground。我們將手動建立模型,邏輯和查詢檔案,並使用命令列建立業務網路。
我們將建立一個商業網路。在我們的區塊鏈解決方案中,我們定義:
- 資料模型
- 事務邏輯
- 訪問控制規則
1.生成骨架業務網路
我們將使用Yeoman生成器來建立一個骨架業務網路。以下命令將建立一個包含業務網路所需的所有元件的目錄。
yo hyperledger-composer:businessnetwork
確保您在fabric-dev-servers目錄中。
pwd /Users/mukeshchapagain/fabric-dev-servers
當您輸入Yeoman generator命令時,系統會要求您輸入以下內容:
- 輸入您的網路名稱
- 輸入您的網路描述
- 作者姓名,可以是您自己的名稱
- 作者電子郵件,可以是您自己的電子郵件地址
- 許可證可以是Apache-2.0
- 您的網路的名稱空間可以是類似org.example的.mynetwork
- 要求您建立空網路或填充網路。我們將選擇填充的網路。填充的網路包含為區塊鏈業務網路自動生成的所有必要檔案。
$yo hyperledger-composer:businessnetwork
Welcome to the business network generator
? Business network name: my-business-network
? Description: My Blockchain Business Network
? Author name:Mukesh Chapagain
? Author email: [email protected]
? License: Apache-2.0
? Namespace: org.example.mynetwork
? Do you want to generate an empty template network? No: generate a populated sample network
create package.json
create README.md
create models/org.example.mynetwork.cto
create permissions.acl
create .eslintrc.yml
create features/sample.feature
create features/support/index.js
create test/logic.js
create lib/logic.js
5. 定義業務網路
區塊鏈業務網路由以下組成:
- 資產
- 參與者
- 訪問控制規則
- 事件(可選)
- 查詢(可選)
業務網路中的一些重要檔案是:
Model(
[b]models/org.example.mynetwork.cto[/b]
)
- 包含所有助手,參與者和交易的類定義
更詳細步驟見原文