【视频】超级账本HyperLedger:为Fabric的Peer节点配置CouchDB

作者:李佶澳  更新时间:2018/07/29 13:08:07

目录

说明

这是”网易云课堂IT技术快速入门学院使用的素材。操作和讲解视频位于《HyperLedger Fabric手把手入门》第三章。

当前(1.1~1.2)版本的Fabric的Peer的数据存储支持LevelDB和CouchDB两种方式,默认为LevelDB。

LevelDB是Google实现的高效kv数据库,可以应用于很多平台,是很多大数据系统的底层存储方案。

CouchDB是Apache旗下的文档型数据库,提供了更多样的数据操作,支持数据同步,CouchDB Technical Overview

文档型数据库是相对于关系型数据而言的,文档数据库中可以直接存、取包含多种信息的文本,相比预先设计表结构的关系型数据库,文档数据库能应对变化、多样的数据。

Fabric的Peer在CouchDB中存储的是json数据,所有写入Fabric的数据都需要转换成json格式。Fabric部署之后,不支持在CouchDB和LevelDB之间切换!

相关笔记

都是一边学习一边记录的,有疑惑地方以官方文档为准:

视频演示:

【视频】超级账本HyperLedger:Fabric的全手动、多服务器部署教程

【视频】超级账本HyperLedger:使用Ansible进行Fabric多节点分布式部署(实战)

【视频】超级账本HyperLedger:Fabric从1.1.0升级到1.2.0

【视频】超级账本HyperLedger:Fabric使用kafka进行区块排序(共识)

【视频】超级账本HyperLedger:为Fabric的Peer节点配置CouchDB

【视频】超级账本HyperLedger:Fabric-CA的使用演示(两个组织一个Orderer三个Peer)

【视频】超级账本HyperLedger:Fabric的Chaincode(智能合约、链码)开发、使用示

【视频】超级账本HyperLedger:Fabric Go SDK的使用

【视频】超级账本HyperLedger:Fabric nodejs SDK的使用

【视频】超级账本HyperLedger:Fabric进阶,在已有的Channel中添加新的组织

文字介绍:

超级账本HyperLedger:超级账本工作组旗下项目介绍

超级账本HyperLedger:Fabric掰开揉碎,一文解惑

超级账本HyperLedger:Fabric的基本概念与基础用法

超级账本HyperLedger:FabricCA的基本概念与用法讲解

超级账本HyperLedger:FabricCA的级联使用(InterMediateCA)

超级账本HyperLedger:Fabric Chaincode(智能合约、链码)开发方法

超级账本HyperLedger:Fabric Channel配置的读取转换

超级账本HyperLedger:Explorer安装使用

超级账本HyperLedger:Cello部署和使用

问题汇总:

超级账本HyperLedger:Fabric部署过程时遇到的问题汇总

超级账本HyperLedger:Fabric的Chaincode开发过程中遇到的问题

超级账本HyperLedger:Fabric Node.js SDK使用时遇到的问题

超级账本HyperLedger:Fabric Golang SDK使用时遇到的问题

超级账本HyperLedger:Fabric 1.2.0使用时遇到的问题

CouchDB部署启动

Installation on Unix-like systems中出了在多种系统上安装方式,这里使用的CentOS系统。

创建文件/etc/yum.repos.d/bintray-apache-couchdb-rpm.repo,内容如下:

[bintray--apache-couchdb-rpm]
name=bintray--apache-couchdb-rpm
baseurl=http://apache.bintray.com/couchdb-rpm/el7/$basearch/
gpgcheck=0
repo_gpgcheck=0
enabled=1

安装:

yum -y install epel-release && yum install couchdb

默认安装在/opt/couchdb/目录中:

$ ls /opt/couchdb/
LICENSE  bin  data  erts-8.3.5  etc  lib  releases  share  var

启动:

systemctl start couchdb

默认监听127.0.0.1:5984:

$ curl 127.0.0.1:5984
{"couchdb":"Welcome","version":"2.1.2","features":["scheduler"],"vendor":{"name":"The Apache Software Foundation"}}

CouchDB配置与控制台的使用

配置文件位于/opt/couchdb/etc/目录中:

$ ls etc/
default.d/  default.ini  local.d/  local.ini  vm.args

default.d和default.ini在版本更新的时候会被覆盖,因此自行配置的参数在local.ini和local.d中修改。

在local.d中创建一个以.ini结尾的文件,couchdb.ini

[chttpd]
port = 5984
bind_address = 0.0.0.0

[admins]
admin = password

然后重启couchdb:

systemctl restart couchdb

5984端口提供了一个web控制台,使用下面的url访问:

http://192.168.88.10:5984/_utils

如果没有创建couchdb.ini,都使用默认配置,刚启动时候默认所有人都可以访问,且都是管理员

可以在web控制台中设置管理员名称和密码。

CouchDB的其它内容

可以直接在web控制台中创建数据库和文档,也可以使用CouchDB API

登录认证:CouchDB Authentication

为每个Peer配置CouchDB

修改每个Peer的core.yaml文件,设置

ledger:
  blockchain:
  state:
    stateDatabase: CouchDB   #将goleveldb修改为CouchDB
    couchDBConfig:
       couchDBAddress: 127.0.0.1:5984
       username: admin
       password: password

然后重启启动Peer。

注意:如果以前使用的是goleveldb,切换未CouchDB后,之前的数据不会被转移到CouchDB中!!

first-network中的couchDB

可以看一下HyperLedgerFabric提供的All-in-One部署方式中的couchdb,这里直接使用Fabric1.2.0。

创建一个目录存放1.2.0的文件:

mkdir fabric-1.2.0-example
cd fabric-1.2.0-example/

下载fabric1.2.0的程序文件,这里使用的mac版:

wget https://nexus.hyperledger.org/content/repositories/releases/org/hyperledger/fabric/hyperledger-fabric/darwin-amd64-1.2.0/hyperledger-fabric-darwin-amd64-1.2.0.tar.gz
wget https://nexus.hyperledger.org/content/repositories/releases/org/hyperledger/fabric/hyperledger-fabric/darwin-amd64-1.2.0/hyperledger-fabric-darwin-amd64-1.2.0.tar.gz.md5
tar -xvf hyperledger-fabric-darwin-amd64-1.2.0.tar.gz

下载Fabric1.2.0匹配的镜像:

./bin/get-docker-images.sh

如果下载失败,例如:

$ ./bin/get-docker-images.sh
Pulling hyperledger/fabric-peer:amd64-1.2.0-stable

这是因为docker hub上没有1.2.0-stable这个标签。

修改./bin/get-docker-images.sh:

ARCH=amd64
#VERSION=1.2.0-stable
VERSION=1.2.0          <-- 没有-stable

然后重新执行:

$ ./bin/get-docker-images.sh

并将latest标签加到最新到镜像上:

docker tags hyperledger/fabric-tools:amd64-1.2.0  hyperledger/fabric-tools:latest

将bin目录添加到PATH环境变量中:

export PATH="/Users/lijiao/Work/Fabric/fabric-1.2.0-example/bin/:$PATH"

下载fabric-samples,这是HyperLedger提供Fabric部署示例:

git clone https://github.com/hyperledger/fabric-samples.git

启动,注意要用-s couchdb指定使用couddb:

cd fabric-samples/first-network
./byfn.sh up -s couchdb

cli容器启动时执行scripts/script.sh,完成channel设置。

我运行的时候cli容器出错,说是连接不上节点,基本上已经不依赖官方的例子了,所以没有深入分析@2018-07-19 21:27:23

参考

  1. HyperLedger Fabric: Using CouchDB
  2. A light-weight, single-purpose library for persistence with bindings to many platforms
  3. Apache CouchDB
  4. CouchDB Technical Overview
  5. Installation on Unix-like systems
  6. CouchDB Config
  7. CouchDB API Reference
  8. CouchDB Authentication

关注加微信,一般不闲聊(直接说事)

相关页面,推荐阅读

Copyright @2011-2019 All rights reserved. 转载请添加原文连接,合作请加微信lijiaocn或者发送邮件: [email protected],备注网站合作

友情链接:  微信公众号精选文章  发现知识星球