https://hyperledger-fabric.readthedocs.io/en/release-1.4/build_network.html

第一步：生成加密工件（x.509 证书及相关密钥）

通过 cryptogen，基于 crypto-config.yaml 里定义的内容，为每个组织（organization）以及组织里的各个组件生成一组证书和密钥。每个组织都会有一个根证书/CA 证书（ca-cert）。Fabric 中的私钥 private key 叫 keystore，公钥 public key 叫 signcerts。

必须在 fabric-samples/first-network 目录下，使用下边的 command

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

运行完上边的命令后，生成的加密工件会存储在 crypto-config 目录下。

名词整理
cryptogen：加密工件生成器工具 crypto generator，在 bin 目录下，用来生成 x.509 证书及相关的公钥私钥
crypto-config.yaml：生成加密工件基于的配置文件，里边包含了这个网络中的所有参与者及组件信息
ca-cert：CA 证书，每个组织都会有自己唯一的 CA （根）证书
keystore：私钥，用来为所有的交易及通信进行数字签名
signcerts：公钥，用来验证签名

第二步：生成初始化配置工件

通过 configtxgen ，基于 configtx.yaml 里定义的内容，生成 order 的创世块 genesis block、channel 信息以及为每个组织在当前 channel 中指定锚节点 anchor peer。

先使用下边的命令定义一个 FABRIC_CFG_PATH 系统变量

export FABRIC_CFG_PATH=$PWD

生成 order 的创世块

../bin/configtxgen -profile TwoOrgsOrdererGenesis -channelID byfn-sys-channel -outputBlock ./channel-artifacts/genesis.block

这步执行完成后，会新生成一个 channel-artifacts 的文件夹，里边有个新生成的 order 的创世块 genesis.block。

创建 channel 的初始化交易

export CHANNEL_NAME=mychannel  && ../bin/configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID $CHANNEL_NAME

这步执行完成后，会在 channel-artifacts 文件夹下生成一个新的 channel 交易的 channel.tx。

为组织指定锚节点

组织1

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

这步执行完成后，会在 channel-artifacts 文件夹下生成一个新的组织 1 的锚节点交易 Org1MSPanchors.tx。

组织2

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

这步执行完成后，会在 channel-artifacts 文件夹下生成一个新的组织 2 的锚节点交易 Org2MSPanchors.tx。

启动网络

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

这步执行完成后，会创建六个容器：

• Order
• 组织1 的两个 peers
• 组织2 的两个 peers
• cli 工具
  期间遇到组织1 的两个 peers 无法启动，查看容器 log 发现以下错误

[signal SIGSEGV: segmentation violation code=0x1 addr=0x63 pc=0x7f5aa4117259]

通过在 /base/docker-compose-base.yaml 中，给每个 peer 的 environment 中添加一个 - GODEBUG=netdns=go，问题解决。参考了 https://stackoverflow.com/questions/49648529/hyperledger-fabric-simples-issue-run-byfn-sh-m-up-failed/49649678#49649678

创建和加入 channel

首先需要进入到 cli 的容器中

docker exec -it cli bash

使用下边的命令创建一个名为 mychannel 的 channel

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

上边的步骤执行完成后，会在 cli 的容器中生成一个 mychannel.block 的创世块，之后加入 channel 的时候要用到。

将组织 1 的第一个 peer 节点加入 channel

peer channel join -b mychannel.block

将组织 2 的第一个 peer 节点加入 channel

CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/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 join -b mychannel.block

更新锚节点信息添加到 channel 的定义中

使用下边的命令更新组织 1 的锚节点信息

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

使用下边的命令更新组织 2 的锚节点信息

CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/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

安装和初始化 chain code

chain code 需要在每个要为交易背书的节点上安装，并且需要在 channel 里初始化
用下边的命令为组织 1 的 peer0 节点安装 chain code

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

用下边的命令为组织 2 的 peer0 节点安装 chain code

CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org2.example.com/users/Admin@org2.example.com/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 chaincode install -n mycc -v 1.0 -l node -p /opt/gopath/src/github.com/chaincode/chaincode_example02/node/

在 channel 中初始化 chain code，参数 -P 是这个 channel 中要执行的背书策略

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')"

通过下边的查询语句对 peer 节点进行第一次查询的时候，会为所在的节点生成一个 chain code 的容器。

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