Hyperledge Fabric 2.2 —— “getting started”
如果可以，尽量直接读原文
https://hyperledger-fabric.readthedocs.io/en/release-2.2/install.html
如果时间仓促，可以看本文。
1.软件预安装
建议直接安装在Linux系统（可以安装虚拟机）中。
(1）安装Git、cURL、Docker
(2) 安装Fabric
详情参考
https://hyperledger-fabric.readthedocs.io/en/release-2.2/prereqs.html
2.了解test-network
（1）确认成功安装预装软件
（2）运行网络
进入测试网络所在文件路径；关闭网络，删除之前运行的container、认证数据及链码。
$ cd fabric/test-network
$ ./network.sh down
以默认配置启动网络，采用默认加密方式，未使用CA认证；
$ ./network up
如果想启动的网络的同时，启动一条默认通道，可以将上述命令替换成：
./network.sh up createChannel
如果需要自定义通道名
$ ./network createChannel -c 自定义通道名称
成功启动通道时效果如下：
========= Channel successfully joined ===========
查看当前Docker中运行的组件：
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
7742350cc363 hyperledger/fabric-peer:2.1.1 "peer node start" About a minute ago Up About a minute 7051/tcp, 0.0.0.0:9051->9051/tcp peer0.org2.example.com
f55947826039 hyperledger/fabric-peer:2.1.1 "peer node start" About a minute ago Up About a minute 0.0.0.0:7051->7051/tcp peer0.org1.example.com
7de556f811ac hyperledger/fabric-orderer:2.1.1 "orderer" About a minute ago Up About a minute 0.0.0.0:7050->7050/tcp orderer.example.com
合约部署命令：
./network.sh deployCC
部署后再次查看docker内容：
扫描二维码关注公众号，回复：
11780368 查看本文章
$ ./network.sh deployCC
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
ffa3c594fdc3 dev-peer0.org1.example.com-basic_1.0-4ec191e793b27e953ff2ede5a8bcc63152cecb1e4c3f301a26e22692c61967ad-42f57faac8360472e47cbbbf3940e81bba83439702d085878d148089a1b213ca "chaincode -peer.add…" 3 minutes ago Up 3 minutes dev-peer0.org1.example.com-basic_1.0-4ec191e793b27e953ff2ede5a8bcc63152cecb1e4c3f301a26e22692c61967ad
72bb69e91f9a dev-peer0.org2.example.com-basic_1.0-4ec191e793b27e953ff2ede5a8bcc63152cecb1e4c3f301a26e22692c61967ad-6c0d5b0755cb92ed5555bd2e8a8765a6f425d1ed5ed9a90e625e01939e2113be "chaincode -peer.add…" 3 minutes ago Up 3 minutes dev-peer0.org2.example.com-basic_1.0-4ec191e793b27e953ff2ede5a8bcc63152cecb1e4c3f301a26e22692c61967ad
7742350cc363 hyperledger/fabric-peer:2.1.1 "peer node start" 10 minutes ago Up 10 minutes 7051/tcp, 0.0.0.0:9051->9051/tcp peer0.org2.example.com
f55947826039 hyperledger/fabric-peer:2.1.1 "peer node start" 10 minutes ago Up 10 minutes 0.0.0.0:7051->7051/tcp peer0.org1.example.com
7de556f811ac hyperledger/fabric-orderer:2.1.1 "orderer" 10 minutes ago Up 10 minutes 0.0.0.0:7050->7050/tcp orderer.example.com
可以发现在两个组织节点上启动了链代码container。
3.体验合约交互
（1）环境参数配置
建议打开系统的环境配置文件，命令如下：
$ sudo gedit /etc/profile
$ source /etc/profile
增加两行代码：
$ export PATH=上级目录/fabric/bin/
#将peer等命令路径预规划，便于直接使用
$ export FABRIC_CFG_PATH=上级目录/fabric/bin/
#指定配置文件路径
上述代码仅在fabric文件夹移动位置时需要变化。
接着，回到test-network文件夹：
在终端运行以下代码，即设定当前用户权限为Org1
# Environment variables for Org1
以org1权限运行peer
export CORE_PEER_TLS_ENABLED=true
export CORE_PEER_LOCALMSPID="Org1MSP"
export CORE_PEER_TLS_ROOTCERT_FILE=${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt
export CORE_PEER_MSPCONFIGPATH=${PWD}/organizations/peerOrganizations/org1.example.com/users/[email protected]/msp
export CORE_PEER_ADDRESS=localhost:7051
此时，已经完成了Org1权限的环境参数的配置。
（2）链码初始化
首先初始化账本信息，并赋予原始资产信息。需要在任意路径下，打开终端输入：
peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile \
${PWD}/organizations/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem\
-C mychannel -n basic --peerAddresses localhost:7051 --tlsRootCertFiles \
${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt\
--peerAddresses localhost:9051 --tlsRootCertFiles \
${PWD}/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt \
-c '{"function":"InitLedger","Args":[]}'
如果成功，会提示：
[chaincodeCmd] chaincodeInvokeOrQuery -> INFO 001 Chaincode invoke successful. result: status:200
现在就可以利用CLI进行链上资产的查询了。
peer chaincode query -C mychannel -n basic -c '{"Args":["GetAllAssets"]}'
如果查询账本数据成功，会输出如下信息：
[{
"ID":"asset1","color":"blue","size":5,"owner":"Tomoko","appraisedValue":300},
{
"ID":"asset2","color":"red","size":5,"owner":"Brad","appraisedValue":400},
{
"ID":"asset3","color":"green","size":10,"owner":"Jin Soo","appraisedValue":500},
{
"ID":"asset4","color":"yellow","size":10,"owner":"Max","appraisedValue":600},
{
"ID":"asset5","color":"black","size":15,"owner":"Adriana","appraisedValue":700},
{
"ID":"asset6","color":"white","size":15,"owner":"Michel","appraisedValue":800}]
接着，我们继续激活链码。
当一个网络成员想要转移或者改变账本中的资产记录时，链码会被调用并激活。
我们先尝试改变账本数据资产，可输入以下命令：
peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile \
${PWD}/organizations/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem -C mychannel -n basic --peerAddresses localhost:7051 --tlsRootCertFiles \
${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses localhost:9051 --tlsRootCertFiles \
${PWD}/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt -c \
'{"function":"TransferAsset","Args":["asset6","Christopher"]}'
这里我们将“asset6”的所有者从Michel改成了Christopher。
如果操作成功，可以看到以下输出：
[chaincodeCmd] chaincodeInvokeOrQuery -> INFO 001 Chaincode invoke successful. result: status:200
此时，我们可以检查一下链上资产是否完成更新：
peer chaincode query -C mychannel -n basic -c '{"Args":["GetAllAssets"]}'
此时输出如下：
[{
"ID":"asset1","color":"blue","size":5,"owner":"Tomoko","appraisedValue":300},
{
"ID":"asset2","color":"red","size":5,"owner":"Brad","appraisedValue":400},
{
"ID":"asset3","color":"green","size":10,"owner":"Jin Soo","appraisedValue":500},
{
"ID":"asset4","color":"yellow","size":10,"owner":"Max","appraisedValue":600},
{
"ID":"asset5","color":"black","size":15,"owner":"Adriana","appraisedValue":700},
{
"ID":"asset6","color":"white","size":15,"owner":"Christopher","appraisedValue":800}]
可以发现当前asset6中Michel已经更新为成了Christopher。
(3)链上信息查询
为了丰富体验，咱们现在更改系统设置，切换成org2权限。
export CORE_PEER_TLS_ENABLED=true
export CORE_PEER_LOCALMSPID="Org2MSP"
export CORE_PEER_TLS_ROOTCERT_FILE=${PWD}/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt
export CORE_PEER_MSPCONFIGPATH=${PWD}/organizations/peerOrganizations/org2.example.com/users/[email protected]/msp
export CORE_PEER_ADDRESS=localhost:9051
接着利用peer命令查询：
peer chaincode query -C mychannel -n basic -c '{"Args":["ReadAsset","asset6"]}'
输出结果：
{
"ID":"asset6","color":"white","size":15,"owner":"Christopher","appraisedValue":800}
此时，数据查询功能验证成功。
（4）关闭网络
./network.sh down
此时会关闭所有节点和服务，并删除所有网络上数据。
（5）CA认证
当使用
./network.sh up
启动网络时，会默认使用加密工具产生证书和密钥。
显示页面如下：
##########################################################
##### Generate certificates using cryptogen tool #########
##########################################################
##########################################################
############ Create Org1 Identities ######################
##########################################################
+ cryptogen generate --config=./organizations/cryptogen/crypto-config-org1.yaml --output=organizations
org1.example.com
+ res=0
+ set +x
##########################################################
############ Create Org2 Identities ######################
##########################################################
+ cryptogen generate --config=./organizations/cryptogen/crypto-config-org2.yaml --output=organizations
org2.example.com
+ res=0
+ set +x
##########################################################
############ Create Orderer Org Identities ###############
##########################################################
+ cryptogen generate --config=./organizations/cryptogen/crypto-config-orderer.yaml --output=organizations
+ res=0
+ set +x
如果想通过CA认证启动网络，可以按照如下操作：
$ ./network.sh down
$ ./network.sh up -ca 指明ca选项并启动网络
所有CA创建的组织内公用的身份认证分享同一个根的认证。
此时可通过
$ docker ps
查看当前运行的container：
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
595627111b48 hyperledger/fabric-peer:2.1.1 "peer node start" 1 second ago Up Less than a second 0.0.0.0:7051->7051/tcp peer0.org1.example.com
6e60ae003206 hyperledger/fabric-orderer:2.1.1 "orderer" 1 second ago Up Less than a second 0.0.0.0:7050->7050/tcp orderer.example.com
013721847d3f hyperledger/fabric-peer:2.1.1 "peer node start" 1 second ago Up Less than a second 7051/tcp, 0.0.0.0:9051->9051/tcp peer0.org2.example.com
5e7aced69e8d hyperledger/fabric-ca:latest "sh -c 'fabric-ca-se…" 15 seconds ago Up 14 seconds 0.0.0.0:7054->7054/tcp ca_org1
1f7ae4e461e4 hyperledger/fabric-ca:latest "sh -c 'fabric-ca-se…" 15 seconds ago Up 14 seconds 7054/tcp, 0.0.0.0:8054->8054/tcp ca_org2
5a0ddf2ba098 hyperledger/fabric-ca:latest "sh -c 'fabric-ca-se…" 15 seconds ago Up 14 seconds 7054/tcp, 0.0.0.0:9054->9054/tcp ca_orderer
可以发现，不论组织内peer还是orderer节点都会产生对应ca-containner，用于标明身份。
如果安装有tree包（没有的话，利用apt-get install tree安装）
└── msp
├── cacerts
│ └── localhost-7054-ca-org1.pem
├── config.yaml
├── IssuerPublicKey
├── IssuerRevocationPublicKey
├── keystore
│ └── 588bd82c95c1f6768d8fbbe9eb93101f6e1838279e7aee43253d2131c29e4c34_sk
├── signcerts
│ └── cert.pem
└── user
4.回顾
（1）./network.sh 为两个peer组织和orderer组织创建密钥和证书；默认的脚本会调用organizations/cryptogen文件夹中的加密工具。如果使用-ca标志去创建CA，脚本将调用Fabric CA服务配置文档和registerEnroll.sh脚本。不管CA组件还是默认的加密工具都为三个组织在organizations文件夹中创建了加密材料和MSP文件夹。
（2）脚本中调用configxgen工具去创建系统通道的genesis区块。配置通道文件位于/fabric/config，创建的genesis块存储在/fabric/test-network/system-genesis-block文件夹。
（3）当加密材料和系统通道genesis区块创建成功之后，脚本会调用fabric/test-network/docker/docker-compose-test-net.yaml文件去创建组织节点和打包节点。
（4）createChannel子命令调用configtx.yaml去创建peer0.org1.example.com和peer0.org2.example.com通道。
（5）调用deployCC命令时，会调用/test-network/script/deployCC.sh脚本在所有节点安装链码并在通道上进行链码定义（声明接口）。一旦链码上传到通道，节点通过cli工具调用Init、触发/激活链码。