hyperledger fabric 实战开发——水产品溯源交易平台(一)

文章目录

  • 前言
  • 环境准备
  • 水产品溯源交易平台设计
  • 实现步骤
    • 1. 模板获取
    • 2. 模板修改
  • 虚拟机优化(根据个人喜好选择)

前言

在万字解析——区块链hyperledger fabric2.2部署实战教程中,我对fabric2.2官方文档的一个示例和两个实战项目进行了操作展示,现在我准备开发一个水产品溯源交易平台,在写下这句话前,我没有开发过任何一个实战的区块链项目,如果写的有不好和不对的地方,欢迎各位大佬指正!

环境准备

我在上一篇文章配环境为ubuntu20.04,这次我用另一台虚拟机ubuntu18.04重头配置一次开发环境,如果你的Ubuntu没有优化过,请查看本篇尾的虚拟机优化章节:
1.安装git

# 安装
sudo apt-get install git
# 若过程中遇到
#E: 无法获得锁 /var/lib/dpkg/lock-frontend - open (11: 资源暂时不可用)
#E: 无法获取 dpkg 前端锁 (/var/lib/dpkg/lock-frontend),是否有其他进程正占用它?
# 请执行以下命令后,再安装
sudo rm /var/lib/dpkg/lock-frontend

2.安装curl

sudo apt-get install curl

3.安装docker

# 安装并检查版本
sudo apt-get -y install docker-compose
docker --version
docker-compose --version
# 提示,以后只要碰到docker有关的错误,先执行2.3.1步骤
#1.重启docker
sudo systemctl start docker
#设置系统启动时docker启动,可选
sudo systemctl enable docker
#2.将用户添加到docker组,确保在用户命令下可以执行
sudo gpasswd -a $USER docker
#3.更新用户组
newgrp docker   
# docker信息
docker info
# 测试docker,若报错详见文末附加问题1
docker run hello-world 

4.安装go
安装并解压

mkdir ~/download
cd ~/download

下载
建议下载1.13版的go,在进行测试前把go.mod改成 1.13 如图,这样三个示例,都能成功(ps:在版本上我至少折腾了有好几十个小时,血的教训!)

#wget https://studygolang.com/dl/golang/go1.14.linux-amd64.tar.gz
# 测试商业票据的时候要换成1.13版本,不知道为什么
wget https://studygolang.com/dl/golang/go1.13.linux-amd64.tar.gz
# 有解释是这个:您系统的 go 版本只需与 fabric-samples/asset-transfer-basic/chaincode-go/go.mod 中指定的版本匹配

解压

sudo tar -C /usr/local -xzf go1.13.linux-amd64.tar.gz
# sudo tar -C /usr/local -xzf go1.14.linux-amd64.tar.gz

创建go目录并配置环境:

mkdir $HOME/go
#用vi打开~./bashrc,配置环境变量
vi ~/.bashrc
# 在最下方插入
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
#使配置的环境变量生效
source ~/.bashrc
#检查是否配置正确
go version
# 配置goproxy环境变量加速国内下载
go env -w  GOPROXY=https://goproxy.io

安装示例、二进制和 Docker 镜像
克隆 hyperledger/fabric-samples 仓库

mkdir -p $GOPATH/src/github.com/hyperledger
cd $GOPATH/src/github.com/hyperledger
# 获取fabric-samples源码
git clone https://github.com/hyperledger/fabric-samples.git
#选择适当的版本标签,进入目录,切换分支
cd fabric-samples
# 可自行选择版本
git checkout release-2.2
#查看版本
git branch

3.将指定版本的 Hyperledger Fabric 平台特定二进制文件和配置文件安装到 fabric-samples 下的 /bin和 /config 目录中,下载指定版本的 Hyperledger Fabric docker 镜像
先配置镜像源:

sudo vi /etc/docker/daemon.json
#把以下代码加进去
{
"registry-mirrors":["https://registry.docker-cn.com"]
}
#如果你想要最新的生产发布版本,忽略所有的版本标识符。
# curl -sSL https://bit.ly/2ysbOFE | bash -s
# curl -sSL https://bit.ly/2ysbOFE | bash -s --   
# 若报错详见文末附加问题2
curl -sSL https://bit.ly/2ysbOFE | bash -s -- 2.2.0 1.4.7 0.4.18
# 若不行试试下面这个,查看问题2
curl -sSL https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh | bash -s  2.2.0 1.4.7 0.4.18

如果二进制文件拉取不到就去官网下载
fabric
fabric-ca
放到fabric-samples下解压
我们可以看到全部下载完毕了

cd chaincode-go
sudo vi go.mod
# 进入文件发现是1.14 自己把改成1.13 ,要与你下载的go版本匹配

在这里插入图片描述

环境变量设置

vi ~/.bashrc
# 添加下面的变量
export PATH=$PATH:$GOPATH/src/github.com/hyperledger/fabric-samples/bin
# 使之生效
source ~/.bashrc
# 检验成功否
fabric-ca-client version

现在开始测试网络

cd test-network
./network.sh up
# 报错
#ERROR: The Compose file './docker/docker-compose-test-net.yaml' is invalid because:
#networks.test value Additional properties are not allowed ('name' was unexpected)
# 请更新docker-compose
sudo curl -L https://get.daocloud.io/docker/compose/releases/download/1.29.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
#配置执行权限:
sudo chmod +x /usr/local/bin/docker-compose
# 检查更新
docker-compose -v

hyperledger fabric 实战开发——水产品溯源交易平台(一)_第1张图片
测试成了,再关掉!

./network.sh down

水产品溯源交易平台设计

先谈谈我的最终设计,有4方:养殖场,经销商,消费者,监管局。结构设计如图:
hyperledger fabric 实战开发——水产品溯源交易平台(一)_第2张图片
旨在比较以下两者查询效率高低:
1.全部原始数据上传至区块链,再通过couchdb查询。
2.存储原始数据到数据库,再把原始数据通过hash加密上链,与最终查询数据库数据hash比较,若hash值相同则数据真实。

实现步骤

1. 模板获取

1.1《汽车生产》
首先,看到这个我先想到以范例——《汽车生产》为模板,我们找到汽车生产,我使用的是javascript开发智能合约,懂go或者java的朋友也可以查看这两种语言的版本
hyperledger fabric 实战开发——水产品溯源交易平台(一)_第3张图片
现在来分析汽车生产区块链形成的流程:
在fabcar目录下以javascript语言开启脚本./startFabric.sh javascript,我们来看看这个脚本里做了哪些事情:

# 1. clean out any old identites in the wallets 如果你启动过先清除之前旧创建的文件
rm -rf ...
# 2. launch network; create channel and join peer to channel 启动网络; 创建通道并连接对等通道
pushd ../test-network  # 推到这个目录
# 关闭网络,networkDown方法执行stop org3 if exist、clearContainers、removeUnwantedImages、删除订单块和其他通道配置事务和证书等等 
./network.sh down   
# 开启网络
# up=》networkUp			       方法执行  checkPrereqs、 createOrgs 、 createConsortium
# createChannel=》createChannel    方法执行  运行scripts/createChannel.sh脚本
# 参数-ca=>CRYPTO="Certificate Authorities" 采用ca加密 
# 参数-s couchdb=>DATABASE="$2" 默认是leveldb,这里使用couchdb
[有关于network.sh脚本详解请看](https://blog.csdn.net/ling1998/article/details/121311568),篇幅问题我就不介绍了。
./network.sh up createChannel -ca -s couchdb 
# 开启链码部署到通道,-ccn链码名称,版本,....
./network.sh deployCC -ccn fabcar -ccv 1 -cci initLedger -ccl ${CC_SRC_LANGUAGE} -ccp ${CC_SRC_PATH}
# 3. 当你实例化链码后,我们可以执行以下操作
JavaScript:
#首先切换到"javascript"目录:
Start by changing into the "javascript" directory:
  cd javascript
#接下来,执行npm install 安装所有需要的软件包,完毕会发现多了一个node_moudle文件夹,里面安装了所有你需要的依赖包:
Next, install all required packages:
  npm install
#然后运行以下应用程序来注册admin用户,并注册一个新用户称为appUser,其他应用程序将使用它与已部署的应用程序进行交互 
Then run the following applications to enroll the admin user, and register a new user
called appUser which will be used by the other applications to interact with the deployed
FabCar contract:
  node enrollAdmin
  # 找到 enrollAdmin.js,看看他做了什么事情:
  # 1.加载网络配置  2.创建一个新的CA客户端来与CA交互
  # 3.创建一个新的基于文件系统的钱包来管理身份  4.注册管理员用户,并将新身份导入到钱包中)
  node registerUser
  # 找到 registerUser.js,看看他做了什么事情:
  # 1.加载网络配置  2.创建一个新的CA客户端来与CA交互
  # 3.创建一个新的基于文件系统的钱包来管理身份  4.构建一个普通用户对象,用于通过CA进行身份验证  
  # 5.注册普通用户,并将新身份导入到钱包中 
  
#您可以按照如下方式运行调用应用程序。 默认情况下,调用应用程序将创建一辆新车,但您可以更新应用程序以提交其他事务:  
You can run the invoke application as follows. By default, the invoke application will
create a new car, but you can update the application to submit other transactions:
  node invoke
  # 找到 invoke.js,看看他做了什么事情:
  # 1.加载网络配置  2.创建一个新的基于文件系统的钱包来管理身份
  # 3.创建一个新的网关来连接到我们的对等节点  4.获取我们的合约所部署的网络(频道)
  # 5.从网络获取合约:network.getContract('fabcar')待会我们看看合约 6.提交指定事务contract.submitTransaction()\
  # 7.断开网络连接
#您可以按照如下方式运行查询应用程序。 默认情况下,查询应用程序将  返回所有车辆,但您可以更新应用程序来评估其他事务: 
You can run the query application as follows. By default, the query application will
return all cars, but you can update the application to evaluate other transactions:
  node query
  # 找到 query.js,看看他做了什么事情:
  # 1.加载网络配置  2.创建一个新的基于文件系统的钱包来管理身份
  # 3.创建一个新的网关来连接到我们的对等节点  4.获取我们的合约所部署的网络(频道)
  # 5.从网络获取合约:network.getContract('fabcar')待会我们看看合约 6.查看指定事务contract.evaluateTransaction()\
  # 7.断开网络连接

# 接下来我们看看fabcar智能合约的定义,cd fabric-samples/chaincode/fabcar/javascript/lib/fabcar.js
# 有下面这些函数方法
# 1.初始化账本(async initLedger(ctx))里面定义了许多车辆信息打印输出const cars = [color:'blue',make:'Toyota'...]
# 2.查询编号为carNumber的车辆信息(queryCar(ctx, carNumber))
# 3.创建车辆信息(async createCar(ctx, carNumber, make, model, color, owner))
# 4.查询所有车辆信息(async queryAllCars(ctx))
# 5.改变车辆的拥有者(async changeCarOwner(ctx, carNumber, newOwner))

看到这里我似乎有了一点思路,如果我想这个平台,那就把一条鱼或一批鱼看成车,改变车的拥有者就是产品流通在不同的身份中(养殖场=》经销商=》消费者),但是还有一些问题不是很理解,先实现再说吧,于是

2. 模板修改

先修改智能合约,fabcar的智能合约在fabric-samples/chaincode下:
hyperledger fabric 实战开发——水产品溯源交易平台(一)_第4张图片

左侧很多文件都要修改,画红线框的部分,我是把fabcar修改成fish,修改也是一个学习的过程。
然后智能合约部分,因为我用的是JavaScript,所以我把fabric-samples/chaincodefabric-samples/fabcar下都复制了一个fabcar修改为fish,再操作,如图:
hyperledger fabric 实战开发——水产品溯源交易平台(一)_第5张图片
弄好之后,我们就可以启动链码了:
hyperledger fabric 实战开发——水产品溯源交易平台(一)_第6张图片
现在,我们进入文件夹cd javascript分别进行创建管理员身份=》创建用户=》查询数据=》创建新数据=》查询数据操作:
hyperledger fabric 实战开发——水产品溯源交易平台(一)_第7张图片
可以看到把合约初始化的数据查出来了
hyperledger fabric 实战开发——水产品溯源交易平台(一)_第8张图片
接下来我们添加交易node invoke.js ,再查询,node query.js,可以看到添加交易信息也被插入:
hyperledger fabric 实战开发——水产品溯源交易平台(一)_第9张图片
至此,我根据模板修改了一下代码,虽然没得到自己想要的功能,但对于fabric运行有了一定的理解,下一篇我主要讲讲自己学习的过程,仿照另外一篇,做出水产品溯源交易平台!

虚拟机优化(根据个人喜好选择)

1.配置sudo不要密码

sudo vi /etc/sudoers
# 把%admin....一行改为以下( 是你的用户名):
 ALL=(ALL:ALL) NOPASSWD: ALL

2.更换软件更新源

# 1.先切换到目录:
cd /etc/apt
# 2.备份源
sudo cp sources.list sources.list.old
# 3.编辑源
sudo vi sources.list
# 4.删除所有内容,进入https://mirrors.ustc.edu.cn/repogen/ 按照自己系统的版本并添加阿里云源
# 如果你是ubuntu18,请继续看下去,不要使用如下源。
deb https://mirrors.ustc.edu.cn/ubuntu/ bionic main restricted universe multiverse
deb-src https://mirrors.ustc.edu.cn/ubuntu/ bionic main restricted universe multiverse

deb https://mirrors.ustc.edu.cn/ubuntu/ bionic-security main restricted universe multiverse
deb-src https://mirrors.ustc.edu.cn/ubuntu/ bionic-security main restricted universe multiverse

deb https://mirrors.ustc.edu.cn/ubuntu/ bionic-updates main restricted universe multiverse
deb-src https://mirrors.ustc.edu.cn/ubuntu/ bionic-updates main restricted universe multiverse

deb https://mirrors.ustc.edu.cn/ubuntu/ bionic-backports main restricted universe multiverse
deb-src https://mirrors.ustc.edu.cn/ubuntu/ bionic-backports main restricted universe multiverse
# 6. 注意:ubuntu18有问题,这里我用的是如下清华源:
# 默认注释了源码镜像以提高 apt update 速度,如有需要可自行取消注释
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-updates main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-backports main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-backports main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-security main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-security main restricted universe multiverse

# 预发布软件源,不建议启用
# deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-proposed main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ bionic-proposed main restricted universe multiverse

hyperledger fabric 实战开发——水产品溯源交易平台(一)_第10张图片

3.github换源,否则clone不了

# 打开:
https://ipaddress.com
# 搜索raw.githubusercontent.com
# 修改hosts配置
sudo gedit /etc/hosts
# 添加
185.199.108.133  raw.githubusercontent.com
# 重启网络
sudo /etc/init.d/network-manager restart

hyperledger fabric 实战开发——水产品溯源交易平台(一)_第11张图片
4.开启与多机器交互

# 安装sshd服务
sudo apt-get install openssh-server
# 查看服务状态
systemctl status sshd      
#  打开服务  
systemctl start sshd       
#  关闭服务
systemctl stop sshd     
#  重起服务      
systemctl restart sshd      
#  设定开机启动
systemctl enable sshd           

你可能感兴趣的:(区块链,fabric,docker,运维)