fabric Building Your First Network

我不是女神ヾ 2022-05-28 13:05 159阅读 0赞

**Install prerequisites**

1.  docker 版本要大于17.06.2-ce(docker version)
2.  docker-compose大于等于 1.14.0 （docker-compose version）
3.  [Go][] version 1.10.x is required.(go version)

**下载二进制**  
这个要翻墙

git clone  https://github.com/hyperledger/fabric-samples.git
    git checkout v1.1.0
    cd fabric-samples/first-network/
    mkdir bin && cd bin
    curl -sSL https://goo.gl/6wtTN5 | bash -s 1.1.0 //可以指定别的版本

下载完成后 可以看到下载的二进制文件,另外也会下载相关的镜像

[root@build bin]# ls -l bin/
    总用量 148968
    -rwxrwxr-x 1 1001 1001 23653336 3月 16 06:13 configtxgen -rwxrwxr-x 1 1001 1001 25113376 3月 16 06:13 configtxlator -rwxrwxr-x 1 1001 1001 12473976 3月 16 06:13 cryptogen -rwxrwxr-x 1 1001 1001 20731176 3月 16 09:33 fabric-ca-client -rwxrwxr-x 1 1001 1001 757 3月 16 06:14 get-docker-images.sh -rwxrwxr-x 1 1001 1001 31536304 3月 16 06:14 orderer -rwxrwxr-x 1 1001 1001 39016824 3月 16 06:14 peer [root@build bin]# ls -l config/
    总用量 56
    -rw-rw-r-- 1 1001 1001 16018 3月 16 06:14 configtx.yaml -rw-rw-r-- 1 1001 1001 26158 3月 16 06:14 core.yaml -rw-rw-r-- 1 1001 1001 11114 3月 16 06:14 orderer.yaml 
    
    ===> List out hyperledger docker images hyperledger/fabric-ca          latest              72617b4fa9b4        3 weeks ago         299MB
    hyperledger/fabric-ca          x86_64-1.1.0        72617b4fa9b4        3 weeks ago         299MB
    hyperledger/fabric-tools       latest              b7bfddf508bc        3 weeks ago         1.46GB
    hyperledger/fabric-tools       x86_64-1.1.0        b7bfddf508bc        3 weeks ago         1.46GB
    hyperledger/fabric-orderer     latest              ce0c810df36a        3 weeks ago         180MB
    hyperledger/fabric-orderer     x86_64-1.1.0        ce0c810df36a        3 weeks ago         180MB
    hyperledger/fabric-peer        latest              b023f9be0771        3 weeks ago         187MB
    hyperledger/fabric-peer        x86_64-1.1.0        b023f9be0771        3 weeks ago         187MB
    hyperledger/fabric-javaenv     latest              82098abb1a17        3 weeks ago         1.52GB
    hyperledger/fabric-javaenv     x86_64-1.1.0        82098abb1a17        3 weeks ago         1.52GB
    hyperledger/fabric-ccenv       latest              c8b4909d8d46        3 weeks ago         1.39GB
    hyperledger/fabric-ccenv       x86_64-1.1.0        c8b4909d8d46        3 weeks ago         1.39GB
    hyperledger/fabric-zookeeper   latest              92cbb952b6f8        6 weeks ago         1.39GB
    hyperledger/fabric-zookeeper   x86_64-0.4.6        92cbb952b6f8        6 weeks ago         1.39GB
    hyperledger/fabric-kafka       latest              554c591b86a8        6 weeks ago         1.4GB
    hyperledger/fabric-kafka       x86_64-0.4.6        554c591b86a8        6 weeks ago         1.4GB
    hyperledger/fabric-couchdb     latest              7e73c828fc5b        6 weeks ago         1.56GB
    hyperledger/fabric-couchdb     x86_64-0.4.6        7e73c828fc5b        6 weeks ago         1.56GB

添加下载下来的二进制到系统路径

export PATH=/root/gopath/src/github.com/hyperledger/fabric-samples/first-network/bin/bin:$PATH

**生成创世区块以及相关证书**

cd /root/gopath/src/github.com/hyperledger/fabric-samples/first-network
    [root@build first-network]# ./byfn.sh -m generate
    Generating certs and genesis block for with channel 'mychannel' and CLI timeout of '10' seconds and CLI delay of '3' seconds
    Continue? [Y/n] Y
    proceeding ...
    /root/gopath/src/github.com/hyperledger/fabric-samples/first-network/bin/bin/cryptogen
    
    ########################################################## ##### Generate certificates using cryptogen tool #########
    ########################################################## + cryptogen generate --config=./crypto-config.yaml org1.example.com org2.example.com + res=0 + set +x /root/gopath/src/github.com/hyperledger/fabric-samples/first-network/bin/bin/configtxgen ##########################################################
    ######### Generating Orderer Genesis block ############## ##########################################################
    + configtxgen -profile TwoOrgsOrdererGenesis -outputBlock ./channel-artifacts/genesis.block
    2018-04-06 17:20:03.958 CST [common/tools/configtxgen] main -> INFO 001 Loading configuration
    2018-04-06 17:20:03.969 CST [msp] getMspConfig -> INFO 002 Loading NodeOUs
    2018-04-06 17:20:03.969 CST [msp] getMspConfig -> INFO 003 Loading NodeOUs
    2018-04-06 17:20:03.969 CST [common/tools/configtxgen] doOutputBlock -> INFO 004 Generating genesis block
    2018-04-06 17:20:03.970 CST [common/tools/configtxgen] doOutputBlock -> INFO 005 Writing genesis block
    + res=0
    + set +x
    
    ################################################################# ### Generating channel configuration transaction 'channel.tx' ### #################################################################
    + configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID mychannel
    2018-04-06 17:20:03.985 CST [common/tools/configtxgen] main -> INFO 001 Loading configuration
    2018-04-06 17:20:03.993 CST [common/tools/configtxgen] doOutputChannelCreateTx -> INFO 002 Generating new channel configtx
    2018-04-06 17:20:03.994 CST [msp] getMspConfig -> INFO 003 Loading NodeOUs
    2018-04-06 17:20:03.994 CST [msp] getMspConfig -> INFO 004 Loading NodeOUs
    2018-04-06 17:20:04.023 CST [common/tools/configtxgen] doOutputChannelCreateTx -> INFO 005 Writing new channel tx
    + res=0
    + set +x
    
    ################################################################# ####### Generating anchor peer update for Org1MSP ##########
    ################################################################# + configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID mychannel -asOrg Org1MSP 2018-04-06 17:20:04.041 CST [common/tools/configtxgen] main -> INFO 001 Loading configuration 2018-04-06 17:20:04.049 CST [common/tools/configtxgen] doOutputAnchorPeersUpdate -> INFO 002 Generating anchor peer update 2018-04-06 17:20:04.049 CST [common/tools/configtxgen] doOutputAnchorPeersUpdate -> INFO 003 Writing anchor peer update + res=0 + set +x #################################################################
    ####### Generating anchor peer update for Org2MSP ##########
    ################################################################# + configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org2MSPanchors.tx -channelID mychannel -asOrg Org2MSP 2018-04-06 17:20:04.064 CST [common/tools/configtxgen] main -> INFO 001 Loading configuration 2018-04-06 17:20:04.071 CST [common/tools/configtxgen] doOutputAnchorPeersUpdate -> INFO 002 Generating anchor peer update 2018-04-06 17:20:04.072 CST [common/tools/configtxgen] doOutputAnchorPeersUpdate -> INFO 003 Writing anchor peer update + res=0 + set +x

**启动fabric网络环境**  
一切准备就绪了，就差启动fabric网络环境了，是不是很激动:

./byfn.sh -m up

该步骤会执行以下任务

1.  启动以及校验fabric网络集群  
    a.启动容器  
    b.创建channel，不转默认是mychannel  
    c.把peer节点join 到mychannel中  
    d.更新Anchor peer节点  
    e.安装chaincode到各个peer节点  
    f.校验chaincode是否安装成功(Invoke,query)

最后启动成功之后所启动的容器

[root@build first-network]# docker ps
    CONTAINER ID        IMAGE                                                                                                  COMMAND                  CREATED              STATUS              PORTS                                              NAMES
    2f48055a53de        dev-peer1.org2.example.com-mycc-1.0-26c2ef32838554aac4f7ad6f100aca865e87959c9a126e86d764c8d01f8346ab   "chaincode -peer.add…"   13 seconds ago       Up 12 seconds                                                          dev-peer1.org2.example.com-mycc-1.0
    923f26b3e3d6        dev-peer0.org1.example.com-mycc-1.0-384f11f484b9302df90b453200cfb25174305fce8f53f4e94d45ee3b6cab0ce9   "chaincode -peer.add…"   36 seconds ago       Up 35 seconds                                                          dev-peer0.org1.example.com-mycc-1.0
    f870fe00d3e6        dev-peer0.org2.example.com-mycc-1.0-15b571b3ce849066b7ec74497da3b27e54e0df1345daff3951b94245ce09c42b   "chaincode -peer.add…"   About a minute ago   Up 59 seconds                                                          dev-peer0.org2.example.com-mycc-1.0
    49c5a0a52679        hyperledger/fabric-tools:latest                                                                        "/bin/bash"              About a minute ago   Up About a minute                                                      cli
    2f3eeada000c        hyperledger/fabric-peer:latest                                                                         "peer node start"        About a minute ago   Up About a minute   0.0.0.0:7051->7051/tcp, 0.0.0.0:7053->7053/tcp     peer0.org1.example.com
    fda564de3f51        hyperledger/fabric-peer:latest                                                                         "peer node start"        About a minute ago   Up About a minute   0.0.0.0:8051->7051/tcp, 0.0.0.0:8053->7053/tcp     peer1.org1.example.com
    0233a13cb299        hyperledger/fabric-orderer:latest                                                                      "orderer"                About a minute ago   Up About a minute   0.0.0.0:7050->7050/tcp                             orderer.example.com
    167f5ae5fc4b        hyperledger/fabric-peer:latest                                                                         "peer node start"        About a minute ago   Up About a minute   0.0.0.0:9051->7051/tcp, 0.0.0.0:9053->7053/tcp     peer0.org2.example.com
    61e0d9bc7b4e        hyperledger/fabric-peer:latest                                                                         "peer node start"        About a minute ago   Up About a minute   0.0.0.0:10051->7051/tcp, 0.0.0.0:10053->7053/tcp   peer1.org2.example.com

查看chaincode的执行日志

[root@build first-network]# docker logs 2f48055a53de
    ex02 Invoke
    Query Response:{
       "Name":"a","Amount":"90"}
    [root@build first-network]# docker logs 923f26b3e3d6
    ex02 Invoke
    Query Response:{
       "Name":"a","Amount":"100"}
    ex02 Invoke
    Aval = 90, Bval = 210
    [root@build first-network]# docker logs f870fe00d3e6
    ex02 Init
    Aval = 100, Bval = 200

关闭fabric集群

./byfn.sh -m down

自动档完成Done====>>>

--------------------

## 手动档开启 ##

**cryptogen工具的使用**  
该工具主要是用来生成证书

[root@build first-network]# cat crypto-config.yaml 
    # Copyright IBM Corp. All Rights Reserved.
    #
    # SPDX-License-Identifier: Apache-2.0
    #
    
    # ---------------------------------------------------------------------------
    # "OrdererOrgs" - Definition of organizations managing orderer nodes
    # ---------------------------------------------------------------------------
    OrdererOrgs:
      # ---------------------------------------------------------------------------
      # Orderer
      # ---------------------------------------------------------------------------
      - Name: Orderer
        Domain: example.com
        # ---------------------------------------------------------------------------
        # "Specs" - See PeerOrgs below for complete description
        # ---------------------------------------------------------------------------
        Specs:
          - Hostname: orderer
    # ---------------------------------------------------------------------------
    # "PeerOrgs" - Definition of organizations managing peer nodes
    # ---------------------------------------------------------------------------
    PeerOrgs:
      # ---------------------------------------------------------------------------
      # Org1
      # ---------------------------------------------------------------------------
      - Name: Org1
        Domain: org1.example.com
        EnableNodeOUs: true
        # ---------------------------------------------------------------------------
        # "Specs"
        # ---------------------------------------------------------------------------
        # Uncomment this section to enable the explicit definition of hosts in your
        # configuration. Most users will want to use Template, below
        #
        # Specs is an array of Spec entries. Each Spec entry consists of two fields:
        # - Hostname:   (Required) The desired hostname, sans the domain.
        # - CommonName: (Optional) Specifies the template or explicit override for
        # the CN. By default, this is the template:
        #
        # "{ {.Hostname}}.{ {.Domain}}"
        #
        # which obtains its values from the Spec.Hostname and
        # Org.Domain, respectively.
        # ---------------------------------------------------------------------------
        # Specs:
        # - Hostname: foo # implicitly "foo.org1.example.com"
        # CommonName: foo27.org5.example.com # overrides Hostname-based FQDN set above
        # - Hostname: bar
        # - Hostname: baz
        # ---------------------------------------------------------------------------
        # "Template"
        # ---------------------------------------------------------------------------
        # Allows for the definition of 1 or more hosts that are created sequentially
        # from a template. By default, this looks like "peer%d" from 0 to Count-1.
        # You may override the number of nodes (Count), the starting index (Start)
        # or the template used to construct the name (Hostname).
        #
        # Note: Template and Specs are not mutually exclusive.  You may define both
        # sections and the aggregate nodes will be created for you. Take care with
        # name collisions
        # ---------------------------------------------------------------------------
        Template:
          Count: 2
          # Start: 5
          # Hostname: {
       {.Prefix}}{
       {.Index}} # default
        # ---------------------------------------------------------------------------
        # "Users"
        # ---------------------------------------------------------------------------
        # Count: The number of user accounts _in addition_ to Admin
        # ---------------------------------------------------------------------------
        Users:
          Count: 1
      # ---------------------------------------------------------------------------
      # Org2: See "Org1" for full specification
      # ---------------------------------------------------------------------------
      - Name: Org2
        Domain: org2.example.com
        EnableNodeOUs: true
        Template:
          Count: 2
        Users:
          Count: 1

根据这个文件生成相关的证书

运行命令

[root@build first-network]# cryptogen generate --config=./crypto-config.yaml 
    org1.example.com
    org2.example.com

**configtxgen工具的使用**

用途(官方解释)

1.  orderer genesis block,
2.  channel configuration transaction,
3.  and two anchor peer transactions - one for each Peer Org.
    
    它是根据configtx.yaml文件生成相关的 block 等等

export FABRIC_CFG_PATH=$PWD
    [root@build first-network]# configtxgen -profile TwoOrgsOrdererGenesis -outputBlock ./channel-artifacts/genesis.block
    2018-04-06 17:57:03.586 CST [common/tools/configtxgen] main -> INFO 001 Loading configuration
    2018-04-06 17:57:03.595 CST [msp] getMspConfig -> INFO 002 Loading NodeOUs
    2018-04-06 17:57:03.596 CST [msp] getMspConfig -> INFO 003 Loading NodeOUs
    2018-04-06 17:57:03.596 CST [common/tools/configtxgen] doOutputBlock -> INFO 004 Generating genesis block
    2018-04-06 17:57:03.596 CST [common/tools/configtxgen] doOutputBlock -> INFO 005 Writing genesis block
    
    [root@build first-network]# export CHANNEL_NAME=mychannel && configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channel.tx -channelID $CHANNEL_NAME
    
    [root@build first-network]# configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID mychannel -asOrg Org1MSP
    2018-04-06 17:59:15.292 CST [common/tools/configtxgen] main -> INFO 001 Loading configuration
    2018-04-06 17:59:15.300 CST [common/tools/configtxgen] doOutputAnchorPeersUpdate -> INFO 002 Generating anchor peer update
    2018-04-06 17:59:15.300 CST [common/tools/configtxgen] doOutputAnchorPeersUpdate -> INFO 003 Writing anchor peer update
    
    [root@build first-network]# configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org2MSPanchors.tx -channelID mychannel -asOrg Org2MSP
    2018-04-06 18:01:56.941 CST [common/tools/configtxgen] main -> INFO 001 Loading configuration
    2018-04-06 18:01:56.952 CST [common/tools/configtxgen] doOutputAnchorPeersUpdate -> INFO 002 Generating anchor peer update
    2018-04-06 18:01:56.952 CST [common/tools/configtxgen] doOutputAnchorPeersUpdate -> INFO 003 Writing anchor peer update

**启动fabric网络集群**

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

cli这个容器如果退出，就执行命令`docker start cli`启动

这时 已经启动成功了

CONTAINER ID        IMAGE                             COMMAND             CREATED             STATUS              PORTS                                              NAMES
    bf47b170b81c        hyperledger/fabric-tools:latest   "/bin/bash"         2 minutes ago       Up 2 minutes                                                           cli
    5b369ecaf4d8        hyperledger/fabric-peer:latest    "peer node start"   2 minutes ago       Up 2 minutes        0.0.0.0:7051->7051/tcp, 0.0.0.0:7053->7053/tcp     peer0.org1.example.com
    f03d83521b1a        hyperledger/fabric-peer:latest    "peer node start"   2 minutes ago       Up 2 minutes        0.0.0.0:8051->7051/tcp, 0.0.0.0:8053->7053/tcp     peer1.org1.example.com
    46e34a6556da        hyperledger/fabric-peer:latest    "peer node start"   2 minutes ago       Up 2 minutes        0.0.0.0:9051->7051/tcp, 0.0.0.0:9053->7053/tcp     peer0.org2.example.com
    067008be708c        hyperledger/fabric-peer:latest    "peer node start"   2 minutes ago       Up 2 minutes        0.0.0.0:10051->7051/tcp, 0.0.0.0:10053->7053/tcp   peer1.org2.example.com

但是还没有创建channel,部署chaincode以及验证工作  
接下来就是手动创建管道，部署chaincode以及验证工作

**1.手动创建管道**  
顺序执行以下命令

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 //添加peer0.org1.example.com 到mychannel中