Hyperledger Fabric 手動搭建【區塊鏈學習三】

Hyperledger Fabric 手動搭建

前面我們學習了區塊鏈是什么、還有自動搭建學習東西我們就要從簡單到深入（入門到放棄），現在自動部署已經跑通了接下來就是手動搭建Fabric 網絡可以更好的理解為什么要這么做。

使用cryptogen（密碼生成器）和configtxgen（配置交易生成器）手動生成證書/密鑰和各種配置構件（等同於執行./byfn.sh generate）

• 密鑰生成器 cryptogen
  • cryptogen 工具為我們的網絡實體生成各種加密材料（ x509 證書和簽名秘鑰）。這些證書是身份的代表，在實體之間通信和交易的時候，它們允許對身份驗證進行簽名和驗證
  • crypto-config.yaml，為所有組織和屬於這些組織的組件生成一組證書和秘鑰。每一個組織被分配一個唯一的根證書（ca-cert），它綁定該組織的特定組件（Peer 節點和排序節點）。通過為每個組織分配一個唯一的 CA 證書，我們模擬了一個典型的網絡，網絡中的成員可以使用它自己的證書授權中心。Fabric 中的事務和通信由一個實體的私鑰（keystore）簽名，然后通過公鑰（signcerts）驗證。

# crypto-config.yaml 文件結構
OrdererOrgs:    #定義一個Order組織
  - Name: Orderer    #order節點的名稱,當前網絡模式為solo類型，所以只定義了一個Order節點
    Domain: example.com    #order節點的域
    Specs:      #暫時用不到
      - Hostname: orderer
      - Hostname: orderer2
      - Hostname: orderer3
      - Hostname: orderer4
      - Hostname: orderer5

PeerOrgs:      #定義Peer組織
  - Name: Org1      #聲明Peer組織名稱為Org1
    Domain: org1.example.com    #Org1組織的域
    EnableNodeOUs: true    #暫時沒搞清楚該字段的意義
    Template:       #在這里可以定義所生成的Org1組織中的Peer節點證書數量，不包括Admin
      Count: 2      #表明需要生成兩個Peer節點的證書，如果需要其他數量的Peer節點，只需要更改這里的數量。
    Users:        #在這里可以定義所生成的Org1組織中類型為User的證書數量，不包括Admin
      Count: 1    #生成用戶的證書的數量

  - Name: Org2   #聲明第二個Peer組織名稱為Org2，如果需要更多的Peer組織證書，只需要按該模板添加即可。
    Domain: org2.example.com  #與以上相同 
    EnableNodeOUs: true
    Template:
      Count: 2
    Users:
      Count: 1

• 配置交易生成器 configtxgen
  • 使用configtxgen工具生成系統通道的創世區塊，並將系統的配置操作（創建通道，設置某組織的錨節點等）作為系統事務生成提交到系統通道的事務文件（.tx），配置文件為configtx.yaml，生成的配置組件位於channel-artifacts目錄下、分別為：genesis.block，channel.tx，Org1MSPanchors.tx，Org2MSPanchors.tx，genesis.block為系統通道的創世區塊，后三者分別為創建通道，設置組織一、組織二的錨節點的事務，這些配置操作作為系統事務提交到系統通道中。

# 會根據crypto-config.yaml文件配置生成兩個錨節點交易，一個對應一個Peer組織
cryptogen generate --config=./crypto-config.yaml

#生成系統通道創世區塊genesis.block生成的配置組件位於channel-artifacts目錄下
configtxgen -profile SampleMultiNodeEtcdRaft -channelID byfn-sys-channel -outputBlock ./channel-artifacts/genesis.block

#通過環境變量設定通道名稱
export CHANNEL_NAME=mychannel

#創建 通道配置 事務
configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID $CHANNEL_NAME  

#創建 更新組織Org1在該通道上的錨節點（錨節點為某組織對order可見的節點） 的事務
configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org1MSP

#創建 更新組織Org2在該通道上的錨節點 的事務
configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org2MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org2MSP

啟動網絡，創建並加入通道，更新組織錨節點，安裝、定義並調用一個鏈代碼（等同於執行./byfn.sh up）

#啟動fabric網絡 -d用於不顯示網絡的實時日志，若想查看日志流，則后續命令需要打開另一個終端來執行
#首先將first-network目錄下的docker-compose-cli.yaml文件中cli容器配置信息中的FABRIC_LOGGING_SPEC=INFO修改為FABRIC_LOGGING_SPEC=DEBUG以看到更多的執行過程信息
docker-compose -f docker-compose-cli.yaml -f docker-compose-etcdraft2.yaml up -d   

啟動網絡之后我們可以看到docker啟動的容器

進入容器 創建並加入通道，並指定（更新）組織的錨節點

#進入cli容器內部
docker exec -it cli bash

#配置CLI容器作為peer0.org1.example.com節點執行命令的環境變量
CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/[e-mail]/msp
CORE_PEER_ADDRESS=peer0.org1.example.com:7051
CORE_PEER_LOCALMSPID="Org1MSP"
CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt

#以環境變量形式設定通道名稱，必須全部小寫，長度小於250個字符，並與正則表達式[a-z][a-z0-9.-]*匹配
export CHANNEL_NAME=mychannel  

#將通道配置事務發送給order節點以創建通道，指定order節點的證書以進行TLS握手，執行結束后該節點將收到來自order節點的對應於所創建通道的創世區塊$CHANNEL_NAME.block
peer channel create -o orderer.example.com:7050 -c $CHANNEL_NAME -f ./channel-artifacts/channel.tx --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem 

#將peer0.org1.example.com加入通道，注意命令中的$CHANNEL_NAME.block，根據通道名稱而變化
peer channel join -b mychannel.block

#指定peer0.org1.example.com作為組織Org1的錨節點
peer channel update -o orderer.example.com:7050 -c $CHANNEL_NAME -f ./channel-artifacts/Org1MSPanchors.tx --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem 

#配置CLI容器作為peer0.org2.example.com節點執行命令的環境變量
CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/[e-mail]/msp 
CORE_PEER_ADDRESS=peer0.org2.example.com:9051 
CORE_PEER_LOCALMSPID="Org2MSP" 
CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt

#將peer0.org2.example.com加入通道，注意命令中的$CHANNEL_NAME.block，根據通道名稱而變化
peer channel join -b mychannel.block

#指定peer0.org2.example.com作為組織Org2的錨節點
peer channel update -o orderer.example.com:7050 -c $CHANNEL_NAME -f ./channel-artifacts/Org2MSPanchors.tx --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem

#下載安裝並定義一個鏈代碼
peer lifecycle chaincode package mycc.tar.gz --path github.com/hyperledger/fabric-samples/chaincode/abstore/go/ --lang golang --label mycc_1

#安裝鏈碼
CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/users/[e-mail]/msp
CORE_PEER_ADDRESS=peer0.org1.example.com:7051
CORE_PEER_LOCALMSPID="Org1MSP"
CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt

#安裝鏈碼
peer lifecycle chaincode install mycc.tar.gz

#查詢已安裝的鏈碼
peer lifecycle chaincode queryinstalled 

#后續命令將需要鏈碼包的ID，因此我們將它保存為一個環境變量，這個ID是動態的(上面查詢出來的)
CC_PACKAGE_ID=mycc_1:3a8c52d70c36313cfebbaf09d8616e7a6318ababa01c7cbe40603c373bcfe173

#制定鏈碼初始化鏈碼TLS后面的命令是要權限才能初始化
#通道中的組織需要就鏈碼的定義達成一致，以下命令用於批准一個chaincode定義，--init-required用於初始化chaincode時使init函數被調用，--package-id指定鏈碼包的ID，我們還可以提供--signature-policy或--channel-config-policy參數來設置chaincode背書策略，若未提供將使用默認設置-大多數通道成員背書，這種情況下若在該渠道中添加或刪除新組織，背書策略將自動更新，以要求更多或更少的背書。在本例中，默認策略將需要來自屬於Org1和Org2的peer的背書(即兩個背書)
peer lifecycle chaincode approveformyorg --channelID $CHANNEL_NAME --name mycc --version 1.0 --init-required --package-id $CC_PACKAGE_ID --sequence 1 --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem

#更改CLI容器的環境變量后，在其它節點上安裝鏈碼
CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/[e-mail]/msp
CORE_PEER_ADDRESS=peer0.org2.example.com:9051
CORE_PEER_LOCALMSPID="Org2MSP"
CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt

#安裝鏈碼
peer lifecycle chaincode install mycc.tar.gz

#制定鏈碼初始化鏈碼TLS后面的命令是要權限才能初始化
#通道中的組織需要就鏈碼的定義達成一致，以下命令用於批准一個chaincode定義，--init-required用於初始化chaincode時使init函數被調用，--package-id指定鏈碼包的ID，我們還可以提供--signature-policy或--channel-config-policy參數來設置chaincode背書策略，若未提供將使用默認設置-大多數通道成員背書，這種情況下若在該渠道中添加或刪除新組織，背書策略將自動更新，以要求更多或更少的背書。在本例中，默認策略將需要來自屬於Org1和Org2的peer的背書(即兩個背書)
peer lifecycle chaincode approveformyorg --channelID $CHANNEL_NAME --name mycc --version 1.0 --init-required --package-id $CC_PACKAGE_ID --sequence 1 --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem

#一旦足夠多的通道成員組織批准了chaincode定義，一個成員組織就可以將定義提交給通道。可以通過發出以下查詢來檢查chaincode定義是否已准備好提交，並查看當前組織的批准情況
#查看各組織對chaincode定義的批准狀況
peer lifecycle chaincode checkcommitreadiness --channelID $CHANNEL_NAME --name mycc --version 1.0 --init-required --sequence 1 --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem --output json

#一旦就鏈碼定義達成一致，把兩個組織中的鏈碼提交到order組織--通知給其他節點我加入了
peer lifecycle chaincode commit -o orderer.example.com:7050 --channelID $CHANNEL_NAME --name mycc --version 1.0 --sequence 1 --init-required --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt

#調用chaincode 將--isInit標志傳遞給鏈碼的第一次調用，並將參數提供給Init函數。第一個調用將啟動chaincode容器。我們可能需要等待容器啟動。（確保通道名稱和鏈碼名稱正確）
peer chaincode invoke -o orderer.example.com:7050 --isInit --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem -C $CHANNEL_NAME -n mycc --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt -c '{"Args":["Init","a","100","b","100"]}' --waitForEvent

#查詢chaincode
peer chaincode query -C $CHANNEL_NAME -n mycc -c '{"Args":["query","a"]}'

#調用鏈碼的invoke函數，a向b轉賬十元
peer chaincode invoke -o orderer.example.com:7050 --tls true --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem -C $CHANNEL_NAME -n mycc --peerAddresses peer0.org1.example.com:7051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses peer0.org2.example.com:9051 --tlsRootCertFiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt -c '{"Args":["invoke","a","b","10"]}' --waitForEvent

#注：若通道成員組織的其它節點想和區塊鏈網絡進行交互，只需要加入通道並安裝鏈碼包即可，而不需要提交鏈碼定義（每個組織批准一次鏈碼定義即可）。