Hyperledger Fabric v2.1 安装【区块链系列...】

本次教程我们将在Linux机器上安装Hyperledger Fabric v2.1。在开始安装之前，我们要安装好一些条件环境。

• 安装Git：使用下面的命令安装最新版本的Git。

sudo apt-get install git

• 安装cURL：使用以下命令安装最新版本的cURL。

sudo apt-get install curl

• 安装wget：使用以下命令安装最新版本的wget。下载Fabric二进制文件将需要它。

sudo apt-get install wget

• 安装Docker和Docker Compose：使用以下命令安装最新版本的docker。然后将当前用户添加到docker组中。

sudo apt-get -y install docker-compose
sudo usermod -aG docker ${USER}
===> logout and login are needed after adding docker group, 
check everything is ok with the command below
id -nG

• 安装Go：使用下面的命令安装并解压缩1.14.x版本的Go。然后我们将go文件夹放到/usr/local目录下。

wget https://golang.org/dl/go1.14.2.linux-amd64.tar.gz
sudo tar -xvf go1.14.2.linux-amd64.tar.gz
sudo chown -R root:root ./go
sudo mv go /usr/loc

• 我们需要将go path添加到\(path变量中，但是添加的内容在用户登录时总是被擦除。为了避免每次登录时执行该命令，我们打开.profile文件，该文件位于\)HOME/.profile，将导出命令写入.profile文件的末尾。

sudo gedit $HOME/.profile
export PATH=$PATH:/usr/local/go/bin

sudo gedit $HOME/.profile
export PATH=$PATH:/usr/local/go/bin

安装Node.js和NPM：使用以下命令下载并安装Node.js和NPM。我们可以安装版本8（支持8.9.4和更高版本）或版本10（支持10.15.3和更高版本）。

curl -sL https://deb.nodesource.com/setup_8.x | sudo bash -
sudo apt-get install nodejs

• 安装Python：使用以下命令安装2.7版的Python。另外，将使用node.js安装来安装相应的版本。

sudo apt-get install python

就是这样，我们终于安装了所有需要的东西，我们将继续安装Fabric示例，二进制文件和docker镜像。

安装fabric，Binaries和Docker镜像

• 现在我们将使用以下命令安装Fabric示例，Binaries和docker镜像。

curl -sSL http://bit.ly/2ysbOFE | bash -s

• 要安装特定的发行版，我们可以将版本标识符传递给curl命令，例如以下几行。

curl -sSL http://bit.ly/2ysbOFE | bash -s -- <fabric_version> <fabric-ca_version> <thirdparty_version>
curl -sSL http://bit.ly/2ysbOFE | bash -s -- 1.4.1 1.4.1 0.4.15

• fabric-samples/bin文件夹保存了设置网络并将其放入克隆的repo所需的所有特定于平台的二进制文件，在curl命令之后如下图所示。

• 我们可以使用以下命令检查镜像。

docker images

测试Hyperledger Fabric网络

因为我们已经成功地安装了所需的一切，所以我们可以使用脚本部署和测试Hyperledger Fabric网络。

• 启动网络：我们转到fabric-samples / test-network目录，并使用脚本启动网络。

cd fabric-samples/test-network
./network.sh up
=> we need root authorization if $USER is not in Docker group:
sudo ./network.sh up

在这里，我们可能会面临以下警告：“本地结构二进制文件和docker镜像不同步。这可能会引起问题”，并且出现错误“ Fabric Docker映像版本1.4.6与测试网络支持的版本不匹配”。如下图所示。

为了解决这个问题，我们首先通过执行以下命令，删除docker映像并仅提取映像，而无需克隆存储库和下载二进制文件。如果一切正常，我们将必须看到所有如下的hyperledger docker镜像。

docker rmi $(docker images | grep hyperledger)
curl -sSL https://bit.ly/2ysbOFE | bash -s -- -s -b-

• 创建一个通道：我们可以使用createChannel子命令在Org1和Org2之间创建一个通道，将其同级加入该通道。

./network.sh createChannel

• 如果我们不使用-c标志，它将使用默认名称mychannel创建频道，因此我们可以使用-c标志更改频道名称。

./network.sh createChannel -c <channel_name>

• 如果命令成功，我们可以在下面看到消息。

• 部署链码：我们可以使用deployCC子命令来部署链码。

sudo ./network.sh deployCC -l javascript

deployCC子命令将在peer0.org1.example.com和peer0.org2.example.com上安装fabcar链码，然后将链码部署在使用channel标志指定的通道上。由于我们使用默认名称mychannel创建了一个频道，因此无需进行任何修改。

默认情况下，该脚本会安装fabcar链码的Go版本。如上所见，我使用语言标志-l来安装链式代码的javascript版本。可以在fabric-samples目录的chaincode文件夹中找到用不同语言编写的所有Fabcar链码。

使用Hyperledger Fabric 2.0，链代码的生命周期已更改，并且deployCC子命令提供了链代码，可以针对该新生命周期正确安装，部署和调用。

自从调用initLedger函数以来，chaincode将cars的初始列表放在分类帐中。如您在下面的代码中看到的，fabcar链码和cars JSON数组中的initLedger函数已被填充。然后每一个都使用一个putState方法放入分类帐。

async initLedger(ctx) {
        console.info('============= START : Initialize Ledger ===========');
        const cars = [
            {
                color: 'blue',
                make: 'Toyota',
                model: 'Prius',
                owner: 'Tomoko',
            },
            {
                color: 'red',
                make: 'Ford',
                model: 'Mustang',
                owner: 'Brad',
            },
            {
                color: 'green',
                make: 'Hyundai',
                model: 'Tucson',
                owner: 'Jin Soo',
            },
            {
                color: 'yellow',
                make: 'Volkswagen',
                model: 'Passat',
                owner: 'Max',
            },
            {
                color: 'black',
                make: 'Tesla',
                model: 'S',
                owner: 'Adriana',
            },
            {
                color: 'purple',
                make: 'Peugeot',
                model: '205',
                owner: 'Michel',
            },
            {
                color: 'white',
                make: 'Chery',
                model: 'S22L',
                owner: 'Aarav',
            },
            {
                color: 'violet',
                make: 'Fiat',
                model: 'Punto',
                owner: 'Pari',
            },
            {
                color: 'indigo',
                make: 'Tata',
                model: 'Nano',
                owner: 'Valeria',
            },
            {
                color: 'brown',
                make: 'Holden',
                model: 'Barina',
                owner: 'Shotaro',
            },
        ];

        for (let i = 0; i < cars.length; i++) {
            cars[i].docType = 'car';
            await ctx.stub.putState('CAR' + i, Buffer.from(JSON.stringify(cars[i])));
            console.info('Added <--> ', cars[i]);
        }
        console.info('============= END : Initialize Ledger ===========');
    }

• 如果链码已正确安装、部署和调用，则您应在日志中看到与上面相同的以下汽车列表：

与网络交互：现在，我们将使用对等CLI，该CLI使我们可以从CLI调用已部署的智能合约，更新通道或安装和部署新的智能合约。在这里，我们只专注于与我们的网络进行交互。要添加已安装“安装示例”，“二进制文件”和“ Docker镜像”部分的二进制文件，请使用以下命令。

export PATH=${PWD}/../bin:${PWD}:$PATH
export FABRIC_CFG_PATH=$PWD/../config/
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/Admin@org1.example.com/msp
export CORE_PEER_ADDRESS=localhost:7051

• 之后，我们可以从CLI查询分类帐。以下命令用于查询。它接受我们要查询的函数名称作为第一个参数，因此如果要查询的方法需要它，可以添加参数作为参数。通过queryCar函数获得编号为CAR9的汽车信息。

peer chaincode query -C mychannel -n fabcar -c '{"Args":["queryCar", "CAR9"]}'

• 由于我们要更改资产，因此我们调用链码。当网络成员想要转移或更改分类账上的资产时，将调用链码。使用以下命令，我们通过调用changeCarOwner函数来更改编号为CAR9的汽车的所有者。

peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride 
orderer.example.com --tls true --cafile ${PWD}/organizations/
ordererOrganizations/example.com/orderers/orderer.example.com/
msp/tlscacerts/tlsca.example.com-cert.pem -C mychannel -n fabcar 
--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":"changeCarOwner","Args":["CAR9","Dave"]}'

• 如果命令已成功执行，则会看到Chaincode invoke successful. result: status:200message.

• 更改资产后，我们将像对Org1 peer一样添加二进制文件，以在其他peer上对其进行检查，并执行以下命令来定义变量。

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/Admin@org2.example.com/msp
export CORE_PEER_ADDRESS=localhost:9051

• 之后我们可以从CLI中以Org2 peer身份查询分类帐。以下命令用于查询，我们将看到CAR9的所有者已更改。

• 使用以下命令结束使用网络后，我们必须关闭网络。

./network.sh down

详情参考