作者:ethanlu(ethanlu@mail.ustc.edu.cn)
创建于:2018年7月17日
最后修改:2018年7月18日
安装虚拟机没什么好说的,工作站,虚拟盒,VMware Fusion都可以,下载最新版本,ubuntu16.04镜像建议科大镜像,稳定且快。
镜像地址:https://mirrors.ustc.edu.cn/
在安装完的Ubuntu的的的后,需要保证易源是国内的,不然如果是国外的话会很慢具体做法是:
如图1所示,打开的的的ubuntu的的系统设置
2,源更新为科大的
1,Ubuntu的的的的的的易于得到的虽然提供了围棋的安装,但是版本比较旧会报错,最好的办法如下:
wget https://storage.googleapis.com/golang/go1.10.3.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.10.3.linux-amd64.tar.gz
2,解压到/ usr / local文件夹下,设置GO环境变量。
vi ~/.profile
3,在文档最后添加以下内容:(GOPATH为去的工作文档,GOROOT为走的安装目录,这个地方设置错了后面会报错)
export PATH=$PATH:/usr/local/go/bin
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$HOME/go/bin
4,编辑保存并退出VI后,记得把这些环境载入:
source ~/.profile
5,我们把去的目录GOPATH设置为当前用户的文件夹下,所以记得创建去文件夹:
cd ~
mkdir go
如图6所示,这个时候看下去的环境变量设置是否正确,环境变量的设置会影响到后期织物是否能跑通:
go env
7,检查路径是否正确:
建议安装Docker CE,CE是社区免费版,推荐按照官方文档安装,之前试过阿里云,大刀云都会报错无法解决。推荐根据官方安装靠谱。官网链接:https://docs.docker.com/ 安装/ Linux的/泊坞窗-CE / Ubuntu的/#支持存储司机
1,更新apt
:
$ sudo apt-get update
2,安装包以网网求允许是什么意思?apt
通过HTTPS使用存储库:
sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
software-properties-common
3,添加泊坞的官方GPG密钥:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88
通过搜索最后8个字符,验证密钥:
sudo apt-key fingerprint 0EBFCD88
pub 4096R/0EBFCD88 2017-02-22
Key fingerprint = 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88
uid Docker Release (CE deb) <docker@docker.com>
sub 4096R/F273FCD8 2017-02-22
5,安装最新版本的Docker CE(若使用最新则会报错,此步忽略直接直接第六步用18.03版本),或转到下一步安装特定版本:
sudo apt-get install docker-ce
6,安装特定版本的Docker CE,请列出repo中的可用版本,然后选择并安装一个。列出仓库中可用的版本:
apt-cache madison docker-ce
docker-ce | 18.03.0~ce-0~ubuntu | https://download.docker.com/linux/ubuntu xenial/stable amd64 Packages
按其完全限定的包名称安装特定版本,如,包名称(docker-ce
)“=”版本字符串(第2列)docker-ce=18.03.0~ce-0~ubuntu
:
sudo apt-get install docker-ce=<VERSION>
7,通过运行hello-world
映像验证是否正确安装了Docker CE:
sudo docker run hello-world
如图8所示,此命令下载测试映像并在容器中运行它当容器运行时,它会打印一条如下信息性消息并退出。:
泊坞窗,撰写也是推荐根据官方文档安装,,不会出错
官网链接:https://docs.docker.com/compose/install/
1,下载最新版本的泊坞撰写:
sudo curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
2,对二进制文件应用可执行权限:
sudo chmod +x /usr/local/bin/docker-compose
3,若安装成功,则显示下方信息:
docker-compose --version
docker-compose version 1.21.2, build 1719ceb
1,我们可以使用GIT中命令下载源码,首先需要建立对应的目录,然后进入该目录,GIT中源码下来:
mkdir -p ~/go/src/github.com/hyperledger
cd ~/go/src/github.com/hyperledger
git clone https://github.com/hyperledger/fabric.git
2,由于织物一直在更新,所有我们并不需要最新最新的源码,需要切换到V1.0.0版本的源码即可,一定要都是1.0否则后期会报错:
cd ~/go/src/github.com/hyperledger/fabric
git checkout release-1.0
3,如果没有1.0.0就gir branch根据提示git checkout -bv按住TAB出新的分支版本。
1,这个其实很简单,因为我们已经设置了Docker Hub镜像地址,所以下载也会很快。官方文件也提供了批量下载的脚本。我们直接运行:
cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli/
source download-dockerimages.sh -c x86_64-1.0.0 -f x86_64-1.0.0
这样就可以下载所有需要的Fabric Docker镜像了。由于我们设置了国内的镜像,所以下载应该是比较快的。
2,下载完毕后,我们运行以下命令检查下载的镜像列表:
docker images
3,会出现如下信息
我们仍然停留在e2e_cli文件夹,这里提供了启动,关闭Fabric网络的自动化脚本。我们要启动Fabric网络,并自动运行Example02 ChainCode的测试,执行一个命令:( 不提sudo权限会报错)
sudo ./network_setup.sh up
这个做了以下操作:
7.1编译生成织物公私,证书的程序,程序在目录:织物/释放/ Linux的AMD64 / bin中
7.2基于configtx.yaml生成创世区块和通道相关信息,并保存在信道的工件文件夹。
7.3基于加密config.yaml生成公私钥和证书信息,并保存在加密的配置文件夹中。
7.4基于搬运工 - 构成-cli.yaml启动1Orderer + 4Peer + 1CLI的织物容器。
7.5在CLI启动的时候,会运行脚本/ script.sh文件,这个脚本文件包含了创建通道,加入通道,安装Example02,运行Example02等功能。
运行成功,我们可以看到这样的界面(这一步会遇到很多问题报错):
如果看到这个界面,这说明我们整个单机部署光纤网络已经搭建成功了。
1,我们仍然是以现在安装好的e2e_cli为例,在官方例子中,信道名字默认是mychannel,链码的名字是mycc我们首先进入CLI,我们重新打开一个命令行窗口,输入:
docker exec -it cli bash
2,运行以下命令可以查询一个账户的余额:
3,然后,我们试一试把一个账户的余额再转20元给b账户,运行命令:
peer chaincode invoke -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 -c '{"Args":["invoke","a","b","20"]}'
运行结果为:
如图4所示,现在转账完毕,我们试一试再查询一下一个账户的余额,没问题的话,应该是只剩下70了我们看看实际情况:
5,果然,一切正常最后我们要关闭布网络,首先需要运行退出命令退出CLI容器关闭织物的命令与启动类似,命令为。:
cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli
./network_setup.sh down
1,network_setup.sh分析:
network_setup.sh其中包括两个部分,一个是利用generateArtifacts.sh脚本文件配置组织关系和颁发证书,另一个是搬运工-构成-cli.yaml用于根据配置启动集群并测试chaincode的示例代码。
具体流程如下:
2,generateArtifacts.sh脚本文件
generateArtifacts.sh包含三个函数:
3,搬运工-撰写-cli.yaml文件
docker-compose-cli.yaml文件根据组织关系启动docker集群,并在cli容器中执行命令命令运行./scripts/script.sh脚本文件
./scripts/script.sh脚本包含以下函数:
4,configtxgen文件
configtxgen工具生成两个内容:Orderer的bootstrap block和Fabric的通道配置事务。
orderer block是订购服务的创世区块;渠道交易文件在创建渠道时会被广播给orderer。
configtx.yaml
包含网络的定义,并给出了网络组件的拓扑结构-2个成员(Org0和ORG1)分别管理维护2个对等体。还指出每个网络实体的加密材料的存储位置。crypto
目录包含每个实体的管理员证书,CA证书,签名证书和私钥。
为了方便使用,我们提供了一个脚本generateCfgTrx.sh
,脚本该整合性了configtxgen
的执行过程,执行后会生成两个配置结果:orderer.block
和channel.tx
。如果运行你过上边的network_setup.sh
则这两个配置查询查询结果已生成,到要先crypto/orderer
目录将之删除。
5,在启动的过程中,是先启动configtxgen的二进制文件,包含密钥,启动顺序是
mychannel;
ORG1,peer0;
ORG1,方1;
ORG2,peer0;
ORG2,方1;
1,出现这种
或者这种
或者
原因是分支版本,镜像版本,configtxgen版本都应是1.0.0。没有安装mycc合约。报错的内容好多个文件都不存在。英文的应该之前的环节出了问题
方法的英文版本通过Ë月刊下载状语从句:它的镜像就是时指定版本使三者保持一致(还有更好的办法,重装:))
2,安装去环境变量遇到报错,在最前面加上须藤以根用户的身份运行。运行后,在在/ usr /本地/下就可以看到进入目录了。如果是自己用软件解压的,可以拷贝到在/ usr /本地/去下,但是要保证你的去文件夹下是垃圾桶,SRC,DOC等目录,不要去文件夹下又是一个去文件夹,这样就双重嵌套了。
然后就要配置环境变量了,LINUX下又两个文件可以配置,其中的/ etc / profile文件是针对所有用户都有效的; $ HOME / .profile文件是针对当前用户有效的,可以根据自己的情况选择。
针对所有用户的需要重启电脑才可以生效;针对当前用户的,在终端里使用源命令加载这个$ HOME / .profile中即可生效。
3,最常见也是最容易忽视的问题,每次当解决完一个问题,其实已经设置好了,但是还是和之前一样报错,这个时候是权限问题,只要加一个须藤,或者苏进入根模式即可,这个能让很多人困惑,明明我已经解决了问题,为什么还是报同样的错?
4、
原因是:
e2e_cli目录是固定的,启动后会创建一个docker network以此为名字,这里是e2e_cli。如果修改该目录,要修改/opt/gopath/src/github.com/hyperledger/fabric/examples/e2e_cli/base目录下的peer-base.yaml
将网络名改成如下名称即可
- CORE_VM_DOCKER_HOSTCONFIG_NETWORKMODE=e2e_cli_default