Fabric核心模块之Peer解析

主要讲Fabric核心模块中Peer
Peer模块命令

peer模块是Fabric中最重要的模块，也是在Fabric系统使用最多的模块。peer模块在Fabric中被称为主节点模块，主要负责存储区块链数据、运行维护链码、提供对外服务接口等作用。
命令行和常用参数

# 通过docker启动peer节点的镜像文件
$ docker run -it hyperledger/fabric-peer bash
$ peer --help
Usage:
  peer [command]

Available Commands:
  `chaincode`   相关的子命令:
          `install`
          `instantiate`
          `invoke`
          `package`
          `query`
          `signpackage`
          `upgrade`
          `list`
  channel     通道操作: create|fetch|join|list|update|signconfigtx|getinfo.
  help        查看相关命令的帮助信息
  logging     日志级别: getlevel|setlevel|revertlevels.
  node        node节点操作: start|status.
  version     当前peer的版本.

Flags:
  -h, --help                   help for peer
      --logging-level string   Default logging level and overrides, see core.yaml for full syntax

peer channel子命令

    peer channel的子命令可以通过 peer channel --help进行查看. 这里介绍一个这些子命令可以共用的一些参数:

        --cafile: 当前orderer节点pem格式的tls证书文件, 要使用绝对路径.

        crypto-config/ordererOrganizations/itcast.com/orderers/ubuntu.itcast.com/msp/tlscacerts/tlsca.itcast.com-cert.pem

        -o, --orderer: orderer节点的地址

        --tls: 通信时是否使用tls加密

    create - 创建通道

        命令: peer channel create [flags], 可用参数为:
            -c, --channelID: 要创建的通道的ID, 必须小写, 在250个字符以内
            -f, --file: 由configtxgen 生成的通道文件, 用于提交给orderer
            -t, --timeout: 创建通道的超时时长

    $ peer channel create -o ubuntu.itcast.com:7050 -c $CHANNEL_NAME -f ./channel-artifacts/channel.tx --tls $CORE_PEER_TLS_ENABLED --cafile $ORDERER_CA

    join - 将peer加入到通道中

        命令: peer channel join[flags], 可用参数为:
            -b, --blockpath: genesis创始块文件

    $ peer channel join -b mychannel.block

    list - 列出peer加入的通道

    $ peer channel list

    update - 更新

        命令: peer channel update [flags], 可用参数为:
            -c, --channelID: 要创建的通道的ID, 必须小写, 在250个字符以内
            -f, --file: 由configtxgen 生成的组织锚节点文件, 用于提交给orderer

    $ peer channel update -o orderer.example.com:7050 -c mychannel -f ./channel-artifacts/Org1MSPanchors.tx --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

peer chaincode 子命令

    chaincode一共有四个公共参数选项, 这些选项所有的子命令都可以使用, 他们分别是:

        --cafile: PEM格式证书的位置
        -o, --orderer: orderer服务器的访问地址
        --tls: 使用orderer的TLS证书位置
        --transient: JSON参数的编码映射

chaincode命令的运行需要一些参数，这些参数可以是配置文件也可以是环境变量，由于涉及的参数并不是很多，因此大多数时候都会采用环境变量的方式来设置参数。

    install

        install命令负责安装chaincode，在这个过程中如果chaincode的源代码存在语法错误，install命令会报错。install命令的选项如下所示：
            -c, --ctor: JSON格式的构造参数, 默认是"{}"
            -l, --lang: 编写chaincode的编程语言, 默认值是 golang
            -n, --name: chaincode的名字
            -p, --path: chaincode源代码的名字
            -v, --version: 当前操作的chaincode的版本, 适用这些命令install/instantiate/upgrade

    $ peer chaincode install -n mycc -v 1.0 -l golang -p github.com/chaincode/chaincode_example02/go/
    # 安装成功之后, 会在peer模块的数据文件中生成一个由 -n 参数和 -v 参数组成的文件,在本例中为:
    $ docker-compose -f docker-compose-cli.yaml images
          Container                  Repository            Tag      Image Id      Size  
    ------------------------------------------------------------------------------------
    cli                      hyperledger/fabric-tools     1.2.0   379602873003   1.41 GB
    orderer.example.com      hyperledger/fabric-orderer   1.2.0   4baf7789a8ec   145 MB
    peer0.org1.example.com   hyperledger/fabric-peer      1.2.0   82c262e65984   151 MB
    peer0.org2.example.com   hyperledger/fabric-peer      1.2.0   82c262e65984   151 MB
    peer1.org1.example.com   hyperledger/fabric-peer      1.2.0   82c262e65984   151 MB
    peer1.org2.example.com   hyperledger/fabric-peer      1.2.0   82c262e65984   151 MB
    itcast@ubuntu:first-network$ docker exec -it peer0.org1.example.com bash
    root@661a44ad6677:/opt/gopath/src/github.com/hyperledger/fabric/peer# find / -name mycc.1.0
    /var/hyperledger/production/chaincodes/mycc.1.0    # 查询到的结果 - mycc.1.0
    # 通过find命令搜索到的 mycc.1.0 文件就是chaincode打包之后的文件

    instantiate

        instantiate可以对已经执行过instanll命令的Chaincode进行实例化，instantiate命令执行完成之后会启动Chaincode运行的Docker镜像，同时instantiate命令还会对Chaincode进行初始化。instantiate命令的选项如下所示：
            -C，--channelID：当前命令运行的通道，默认值是“testchainid"。
            -c, --ctor：JSON格式的构造参数，默认值是“{}"
            -E ， --escc ： 应用于当前Chaincode的系统背书Chaincode的名字。
            -l，--lang：编写Chaincode的编程语言，默认值是golang
            -n，--name：Chaincode的名字。
            -P，--policy：当前Chaincode的背书策略。
            -v，--version：当前操作的Chaincode的版本，适用于install/instantiate/upgrade等命令
            -V，--vscc：当前Chaincode调用的验证系统Chaincode的名字。

    $ peer chaincode instantiate -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 mychannel -n mycc -l golang -v 1.0 -c '{"Args":["init","a","100","b","200"]}' -P "AND ('Org1MSP.member', 'Org2MSP.member')"
    # instantiate命令成功执行之后，可以通过dockerps命令查看己经启动的运行Chaincode的docker容器。

    invoke

        invoke命令用来调用chaincode。invoke命令的选项如下所示：
            -C，--channelID：当前命令运行的通道，默认值是“testchainid"
            -c, --ctor：JSON格式的构造参数，默认值是“{}"
            -n，--name：Chaincode的名字。

    # 调用示例
    $ peer chaincode invoke -o orderer.example.com:7050  -C mychannel -n mycc -c '{"Args":["invoke","a","b","10"]}'

    list

        list命令用来查询已经安装的Chaincode，list命令的选项如下所示：
            -C，--channelID：当前命令运行的通道，默认值是“testchainid"
            --installed：获取当前Peer节点已经被安装的chaincode
            --instantiated：获取当前channel中已经被实例化的chaincode

    # 调用示例
    $ peer chaincode list --installed

    package

        package用来将Chaincode打包。package命令的选项如下所示：
            -s，--cc-package：对打包后的Chaincode进行签名。
            -c, --ctor：JSON格式的构造参数，默认值是“{}"
            -i，--instantiate-policy：Chaincode的权限
            -l，--lang：编写Chaincode的编程语言，默认值是golang
            -n，--name：Chaincode的名字。
            -p，--path：Chaincode源代码的路径。
            -S，--sign：对打包的文件用本地的MSP进行签名。
            -v，--version：当前操作的Chaincode的版本，适用于install/instantiate/upgrade等命令

    # 调用示例
    $ peer chaincode package —P github.com/hyperledger/fabric/examples/chaincode/go/example  —n mycc —v 1.0 -s —S -i "OR ('Org1MSP.member'，'Org2MSP.member')" mycc.1.0.out

    query

        query命令用来执行chaincode代码中的query方法。query命令的选项如下：
            -C，--channelID：当前命令运行的通道，默认值是“testchainid"
            -c, --ctor：JSON格式的构造参数，默认值是“{}"
            -x，--hex：是否对输出的内容进行编码处理
            -n，--name：Chaincode的名字。
            -r，--raw：是否输出二进制内容
            -t, --tid: 指定当前查询的编号

    # 调用示例
    $ peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}'

    signpackage

    # 对打包好的chaincode进行签名
    # 示例调用
    $ peer chaincode signpackage mycc.1.0.out sign_mycc.1.0.out

    upgrade

        upgrade用来更新已经存在的chaincode。命令选项如下：
            -C，--channelID：当前命令运行的通道，默认值是“testchainid"
            -c, --ctor：JSON格式的构造参数，默认值是“{}"
            -E ， --escc ： 应用于当前Chaincode的系统背书Chaincode的名字。
            -l，--lang：编写Chaincode的编程语言，默认值是golang
            -n，--name：Chaincode的名字。
            -p, --path: chaincode源代码的名字
            -P，--policy：当前Chaincode的背书策略。
            -v，--version：当前操作的Chaincode的版本，适用于install/instantiate/upgrade等命令
            -V，--vscc：当前Chaincode调用的验证系统Chaincode的名字。

    $ peer chaincode upgrade -o orderer.example.com:7050 -n mycc -v 1.1 -C mychannel -c '{"Args":["init","a","100","b","200"]}'

peer 的环境变量

# 配置文件和环境变量是设置peer启动参数的重要手段, 相关环境变量如下:
CORE_VM_ENDPOINT    # docker服务器的Deamon地址, 默认取端口的套接字, 如下:
    - `unix:///var/run/docker.sock
CORE_VM_DOCKER_HOSTCONFIG_NETWORKMODE    # chaincode容器的网络命名模式, 自己取名即可
    - `节点运行在同一个网络中才能相互通信, 不同网络中的节点相互隔离
CORE_PEER_PROFILE_ENABLED    # 使用peer内置的 profile server
    - `fabric的peer内置有profile server，默认时运行在6060端口上的，并且默认关闭。
CORE_LOGGING_LEVEL        # log日志的级别
    - `critical | error | warning | notice | info | debug
CORE_PEER_ID    # peer节点的编号, 自定义一个即可
CORE_PEER_GOSSIP_USELEADERELECTION    # 是否自动选举leader节点, 自动:true
CORE_PEER_GOSSIP_ORGLEADER            # 当前节点是否为leader节点, 是:true
CORE_PEER_ADDRESS                    # 当前peer节点的访问地址
    - `格式: 域名:端口 / IP:端口
CORE_PEER_CHAINCODELISTENADDRESS    # chaincode的监听地址
CORE_PEER_GOSSIP_EXTERNALENDPOINT    # 节点被组织外节点感知时的地址
    - `默认为空, 代表不被其他组织节点所感知
CORE_PEER_GOSSIP_BOOTSTRAP    # 启动节点后向哪些节点发起gossip连接, 以加入网络
    - `这些节点与本地节点需要属于同一个网络
CORE_PEER_LOCALMSPID     # peer节点所属的组织的编号, 在configtxgen.yaml中设置的
CORE_CHAINCODE_MODE        # chaincode的运行模式
    - `net: 网络模式
    - `dev: 开发模式, 该模式下可以在容器外运行chaincode
CORE_PEER_MSPCONFIGPATH    # 当前节点的msp文件路径
    - `启动peer的时候需要使用msp账号文件
    - `crypto-config/peerOrganizations/org1.x.com/peers/peer0.org1.x.com/msp
    - `创建channel的时候需要使用msp账号文件
    - `crypto-config/peerOrganizations/org1.x.com/users/Admin@org1.x.com/msp
CORE_PEER_TLS_ENABLED    # 是否激活tls, 激活:true, 不激活:false
CORE_PEER_TLS_CERT_FILE    # 服务器身份验证证书
    - `crypto-config/peerOrganizations/org1.x.com/peers/peer0.org1.x.com/tls/server.crt
CORE_PEER_TLS_KEY_FILE    # 服务器的私钥文件
    - `crypto-config/peerOrganizations/org1.x.com/peers/peer0.org1.x.com/tls/server.key
CORE_PEER_TLS_ROOTCERT_FILE    # 根服务器证书
    - `crypto-config/peerOrganizations/org1.x.com/peers/peer0.org1.x.com/tls/ca.crt

    每个 org 会选举出一个 leader peer（实际上可以存在多个），负责连接到 orderer。leader peer从orderer 拿到新块的信息后分发给其他 peer。

        静态选择leader peer

        export CORE_PEER_GOSSIP_USELEADERELECTION=false
        export CORE_PEER_GOSSIP_ORGLEADER=true #指定某一个peer为leader peer
        # 1. 如果都配置为 false，那么 peer 不会尝试变成一个 leader
        # 2. 如果都配置为 true，会引发异常
        # 3. 静态配置的方式，需要自行保证 leader 的可用性

        动态选择leader peer

        export CORE_PEER_GOSSIP_USELEADERELECTION=true
        export CORE_PEER_GOSSIP_ORGLEADER=false

peer 默认监听的端口

    下面是Hyperledger中相关监听的服务端口（默认）

        7050: REST 服务端口
        7051：peer gRPC 服务监听端口
        7052：peer CLI 端口
        7053：peer 事件服务端口
        7054：eCAP
        7055：eCAA
        7056：tCAP
        7057：tCAA
        7058：tlsCAP
        7059：tlsCAA