fabric first-network學習筆記

參考文檔：https://hyperledger-fabric.readthedocs.io/en/release-1.4/build_network.html

網絡拓撲

四個 Peer 節點分屬於同一個管理域（example.com）下的兩個組織Org1 和Org2，這兩個組織都加入同一個應用通道（business-channel）中，每個組織中的第一個節點（peer0節點）作爲錨節點和其他組織進行通信，所有節點通過域名都可以相互訪問。

生成初始區塊

../bin/cryptogen generate --config=./crypto-config.yaml

fabric項目提供了cryptogen工具爲網絡實體生成證書和私鑰，這一過程依賴於crypto-config.yaml配置文件。
crypto-config.yaml文件提供了Orderer的名稱，組織名稱，組織中節點數目，組織用戶數目等。
運行cryptogen工具後，生成的證書和密鑰將保存到first-network/crypto-config文件夾中。

export FABRIC_CFG_PATH=$PWD
../bin/configtxgen -profile TwoOrgsOrdererGenesis -channelID byfn-sys-channel -outputBlock ./channel-artifacts/genesis.block

創世塊及之後的操作生成的文件會保存到first-network/channel-artifacts文件夾中。上面命令中的channelID是系統通道的名稱。

生成通道的配置信息

# mychannel可以是任意值
export CHANNEL_NAME=mychannel  

../bin/configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID $CHANNEL_NAME

configtxgen的配置文件是configtx.yaml，該文件中定義了三個成員OrdererOrg，Org1，Org2。對於創世塊，configtx.yaml設置了排序服務的方式(solo:單節點排序服務，kafka:多節點排序服務)，指定了批處理大小，以及其他內容。

生成錨節點配置更新文件

../bin/configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org1MSP

../bin/configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org2MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org2MSP

這兩行命令爲爲Org1和Org2定義錨點。

啓動網絡

docker-compose -f docker-compose-cli.yaml up -d

docker-compose的配置文件是docker-compose-cli.yaml。docker-compose-cli.yaml文件中涉及到了base/docker-compose-base.yaml文件，base/docker-compose-base.yaml文件涉及到了base/peer-base.yaml文件。
base/docker-compose-base.yaml指定Orderer和peer節點的相關信息。
base/peer-base.yaml設置了所有peer容器的基本的共同信息。

創建和加入通道

進入docker容器。

docker exec -it cli bash

創建通道

export CHANNEL_NAME=mychannel
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

加入通道

 peer channel join -b mychannel.block

更新錨節點

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

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 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

安裝鏈碼

首先，將示例Go，Node.js或Java chaincode安裝到Org1中的peer0節點上。
Golang

peer chaincode install -n mycc -v 1.0 -p github.com/chaincode/chaincode_example02/go/

Node.js

peer chaincode install -n mycc -v 1.0 -l node -p /opt/gopath/src/github.com/chaiJncode/chaincode_example02/node/

Java

peer chaincode install -n mycc -v 1.0 -l java -p /opt/gopath/src/github.com/chaincode/chaincode_example02/java/

修改以下四個環境變量以對Org2中的peer0發出安裝命令：

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

將示例Go，Node.js或Java鏈碼安裝到Org2中的peer0上。
Golang

peer chaincode install -n mycc -v 1.0 -p github.com/chaincode/chaincode_example02/go/

Node.js

peer chaincode install -n mycc -v 1.0 -l node -p /opt/gopath/src/github.com/chaincode/chaincode_example02/node/

Java

peer chaincode install -n mycc -v 1.0 -l java -p /opt/gopath/src/github.com/chaincode/chaincode_example02/java/

實例化鏈碼

我們指定的背書策略是需要來自Org1 和 Org2 的兩次背書。如果需要一次，把-P "AND ('Org1MSP.peer','Org2MSP.peer')"中AND改成OR即可。
Golang

peer chaincode instantiate -o orderer.example.com:7050 --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 -C $CHANNEL_NAME -n mycc -v 1.0 -c '{"Args":["init","a", "100", "b","200"]}' -P "AND ('Org1MSP.peer','Org2MSP.peer')"

Node.js

peer chaincode instantiate -o orderer.example.com:7050 --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 -C $CHANNEL_NAME -n mycc -l node -v 1.0 -c '{"Args":["init","a", "100", "b","200"]}' -P "AND ('Org1MSP.peer','Org2MSP.peer')"

Java

peer chaincode instantiate -o orderer.example.com:7050 --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 -C $CHANNEL_NAME -n mycc -l java -v 1.0 -c '{"Args":["init","a", "100", "b","200"]}' -P "AND ('Org1MSP.peer','Org2MSP.peer')"

接下來便可以調用鏈碼中的函數進行測試。

Query

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

Invoke

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"]}'

如果遇到錯誤

運行以下兩行代碼可以解決大部分錯誤:

docker stop $(docker ps -q)
docker rm $(docker ps -q)

先停掉容器，再刪掉容器。