Hyperledger Fabric v1.0alpha macOS 部署开发者环境

参考

老的文档：

整了半天才发现，上面的都是老版本：目前最新 1.0 alpha 在如下，而且更新贼啦快，下面基本是翻译，不过是macOS上的部署过程。

getting_started

准备和安装

Docker 我装的官方GUI版本docker-ce-desktop-mac 文档,注意官方也提供了zsh completion，只是文档中没写

ln -s /Applications/Docker.app/Contents/Resources/etc/docker.zsh-completion /usr/local/share/zsh-completions/_docker
ln -s /Applications/Docker.app/Contents/Resources/etc/docker-machine.zsh-completion /usr/local/share/zsh-completions/_docker-machine
ln -s /Applications/Docker.app/Contents/Resources/etc/docker-compose.zsh-completion /usr/local/share/zsh-completions/_docker-compose

Golang: brew intall go

检查安装：

docker version
docker-compose version
go version

Curl 二进制文件

安装curl：macOS 已经安装了curl，记得安装brew就是利用curl
创建开发目录

mkdir fabric-sample
cd fabric-sample

执行命令下载

curl -L https://logs.hyperledger.org/sandbox/vex-yul-hyp-jenkins-2/fabric-binaries/release.tar.gz -o release.tar.gz 2> /dev/null;  tar -xvf release.tar.gz

安装docker镜像

安装docker镜像, 写本文时候还是alpha ： hyperledger/fabric-peer:x86_64-1.0.0-alpha

注意：darwin-amd64 是mac的，如果是其他系统，请转到相应目录下。官方文档在下一节讲了这个，对大部分有经验的开发人员应该不用再查一遍自己的系统了： https://hyperledger-fabric.readthedocs.io/en/latest/getting_started.html#using-the-cryptogen-tool

cd release
cd darwin-amd64/install
./get-docker-images.sh

稍等，国内网络等的还蛮久的，我下的时候中间还中断了多次。安装完检查下，一共如下7个image

⇒  docker images
REPOSITORY                     TAG                  IMAGE ID            CREATED             SIZE
hyperledger/fabric-couchdb     x86_64-1.0.0-alpha   f3ce31e25872        7 weeks ago         1.51 GB
hyperledger/fabric-kafka       x86_64-1.0.0-alpha   589dad0b93fc        7 weeks ago         1.3 GB
hyperledger/fabric-zookeeper   x86_64-1.0.0-alpha   9a51f5be29c1        7 weeks ago         1.31 GB
hyperledger/fabric-orderer     x86_64-1.0.0-alpha   5685fd77ab7c        7 weeks ago         182 MB
hyperledger/fabric-peer        x86_64-1.0.0-alpha   784c5d41ac1d        7 weeks ago         184 MB
hyperledger/fabric-javaenv     x86_64-1.0.0-alpha   a08f85d8f0a9        7 weeks ago         1.42 GB
hyperledger/fabric-ccenv       x86_64-1.0.0-alpha   91792014b61f        7 weeks ago         1.29 GB

使用脚本

切换到 release/samples/e2e 目录，脚本在此目录下。

使用脚本非常方便，官方文章中大量步骤其实就是脚本中一步步手动执行；我这里将其顺序换了下。
启动

./network_setup.sh up <channel_name>

停止

./network_setup.sh down

重启

./network_setup.sh restart

后面开始就是手动执行，其实就是对脚本的解释。

使用 cryptogen 工具

切换到 release/samples/e2e 目录, crypto-config.yaml 文件包含了网络的定义和结构、需生成证书的组件列表
执行命令：
../../darwin-amd64/bin/cryptogen generate --config=./crypto-config.yaml

目录下生成 crypto-config 目录，生成的证书就在此目录下。

使用 configtxgen 工具

使用configtxgen 工具生成orderer创世块和通道配置；此工具文档在此

生成orderer创世块

# 配置系统配置
export FABRIC_CFG_PATH=$PWD
../../darwin-amd64/bin/configtxgen -profile TwoOrgs -outputBlock orderer.block

生成 orderer.block

生成 channel 配置

我这里 channel名称设定为 testing

../../darwin-amd64/bin/configtxgen -profile TwoOrgs -outputCreateChannelTx channel.tx -channelID testing

启动网络(No TLS)

将 docker-compose-no-tls.yaml 文件中 cli 配置下的 command 注释掉,不让其自动启动

./scripts/script.sh 就是cli启动网络的脚步，因此将其注释掉

working_dir: /opt/gopath/src/github.com/hyperledger/fabric/peer
#command: /bin/bash -c './scripts/script.sh ${CHANNEL_NAME}; '
volumes:

设置网络需要的系统变量

# this sets our OS; 如果你是其他系统，请另外设置；
# export ARCH_TAG=$(uname -m)
export ARCH_TAG=darwin-amd64
# this starts the network in "detached" mode; enter the appropriate value for the CHANNEL_NAME parm； 
# 移除 -d 可以看组件详细日志
CHANNEL_NAME=<CHANNEL_NAME> docker-compose -f docker-compose-no-tls.yaml up -d

创建和加入 channle

启动 cli docker镜像

docker exec -it cli bash

现在正常应该可以进入cli镜像命令提示行：

root@bb5e894d9668:/opt/gopath/src/github.com/hyperledger/fabric/peer#

创建channle

设置如下环境变量：

CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com
CORE_PEER_LOCALMSPID="OrdererMSP"
CHANNEL_NAME=<YOUR_CHANNEL_NAME>

创建channle的语法如下：

peer channel create -o <ORDERER_NAME>:7050 -c <CHANNEL_NAME> -f channel.tx

因此，完整的命令操作如下：

CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com CORE_PEER_LOCALMSPID="OrdererMSP" peer channel create -o orderer.example.com:7050 -c mychannel -f channel.tx

这个命令返回一个创世块 mychannle.block 用于加入channel使用

环境变量

可以在 scripts/script.sh 脚本中看到所有命令的使用

要使下面cli对PEER0的命令生效，必须先设置如下四个环境变量：

# Environment variables for PEER0
CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com
CORE_PEER_ADDRESS=peer0.org1.example.com:7051
CORE_PEER_LOCALMSPID="Org0MSP"
CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/cacerts/org1.example.com-cert.pem

每个节点的环境变量配置在docker-compose文件中，可以在其中详细看到

加入channle

语法如下：

peer channel join -b <CHANNEL_NAME>.block

因为需要传入4个全局环境变量，因此完整命令如下：

CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com CORE_PEER_ADDRESS=peer0.org1.example.com:7051 CORE_PEER_LOCALMSPID="Org0MSP" CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/cacerts/org1.example.com-cert.pem peer channel join -b mychannel.block

安装 chaincode

安装 chaincode源码到peer的文件系统中，语法如下：

peer chaincode install -n <CHAINCODE_NAME> -v <CHAINCODE_VERSION> -p <CHAINCODE_PATH>

完整命令如下：

CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com CORE_PEER_ADDRESS=peer0.org1.example.com:7051 CORE_PEER_LOCALMSPID="Org0MSP" CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/cacerts/org1.example.com-cert.pem peer chaincode install -n mycc -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02 >&log.txt

实例 instantiate

现在我们开始启动 chaincode 容器，初始化 key-value对。语法如下：

peer chaincode instantiate -o <ORDERER_NAME>:7050 -C <CHANNEL_NAME> -n <CHAINCODE_NAME> -v <VERSION> -c '{"Args":["init","key","value"]}' -P "OR/AND (CHAINCODE_POLICY)"

注意参数 -P, 表明我们的策略需要背书的组织。-P "OR ('Org0MSP.member','Org1MSP.member')" 意思是需要 Org0 OR Org1 的背书。如果改成 AND,表示同时需要两者。

完整命令:

# we instantiate with the following key value pairs: "a","100","b","200"
CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com CORE_PEER_ADDRESS=peer0.org1.example.com:7051 CORE_PEER_LOCALMSPID="Org0MSP" CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/cacerts/org1.example.com-cert.pem peer chaincode instantiate -o orderer.example.com:7050 -C mychannel -n mycc -v 1.0 -c '{"Args":["init","a","100","b","200"]}' -P "OR ('Org0MSP.member','Org1MSP.member')"

检索 query

检索下值："a"，验证下chaincode初始化成功，状态数据库已经传播出去。query语法如下：

peer chaincode query -C <CHANNEL_NAME> -n <CHAINCODE_NAME> -c '{"Args":["query","key"]}'

完整命令：

CORE_PEER_MSPCONFIGPATH=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com CORE_PEER_ADDRESS=peer0.org1.example.com:7051 CORE_PEER_LOCALMSPID="Org0MSP" CORE_PEER_TLS_ROOTCERT_FILE=/opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/cacerts/org1.example.com-cert.pem peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'

Invoke

我们将 10 从 a 移动到 b，该交易将创建新的块，变更状态数据库。语法如下：

peer chaincode invoke -o <ORDERER_NAME>:7050 -C <CHANNEL_NAME> -n <CHAINCODE_NAME> -c '{"Args":["invoke","key","key","value"]}'