hyperledger cello入门

1 概念

Master

管理节点，这些节点运行着cello服务。

Worker

存储着区块链blockchain的平台（例如docker，swarm，kubernetes，vsphere cloud）,worker节点被master节点管理着（增删改查worker节点）。

Host

host是一组资源集合，例如docker host，kubernetes cluster， swarm cluster或其他虚拟云产品。通常host有如下属性：

• name:别名
• Daemon url: docker能访问的url
• capacity:host能够存储的chains的极大值
• logging level:host中chains的日志等级，info，debug或warn
• logging type:处理日志的方式，local或者remote
• schedulable:host中chains能否给用户调度
• autofill:host节点自动填充chains，新增host时自动存储已有的chains

Chain（Cluster）

区块链网络包含一系列peer和orderer节点，例如hyperledger fabric， sawthooth lake，iroha chain。

2 Master节点配置

master节点包含如下服务：

• operator dashboard: 为管理员提供web管理端入口。

• user dashboard: 为用户提供web端入口。

• engine: 为区块链客户端提供restful api接口。

• watchdog: 提供服务端健康检查。

更多细节参考系统架构篇

System Requirement

• Hardware: 8c16g100g

• Linux Kernel >= 3.0.0

• Docker engine: 1.10.0+ (Docker 17.0+ support is experimental)

• docker-compose: 1.10.0+

master节点通过如下两个步骤部署运行：

• Clone code

• Run setup script

用法

Start/Stop/Restart

运行所有服务

$ [environment variables] make start

如下命令是运行所需的环境变量：

• SERVER_PUBLIC_IP(必须): Master 节点的ip地址

• THEME(可选): 管理端的theme主题 basic/vue/react, 默认为 basic

• NPM_REGISTRY(可选): 安装 node packages 的 npm registry

• DEV(可选): 在开发者模式或者生产模式下启动服务，默认是false ，选项是 True/False

• ENABLE_EMAIL_ACTIVE(可选): 在客户端注册用户是否需要手动激活

• SMTP_SERVER(可选): smtp server 地址

• SMTP_PORT(可选): smtp server 端口号

• SMTP_AUTH_USERNAME(可选): smtp server 用户名

• SMTP_AUTH_PASSWORD(可选): smtp server 密码

• FROM_EMAIL(可选): 用户的email地址

停止所有服务

$ make stop

重启所有服务

$ make restart

开发者模式 Start/Stop/Restart

开发者模式支持：客户端监控文件变化并自动重启；管理端会开启沙盒debug模式

开发者模式启动所有服务

$ DEV=True make start

开发者模停止所有服务

$ DEV=True make stop

开发者模式重启所有服务

$ DEV=True make restart

Check Logs

查看所有服务的日志

$ make logs

查看指定服务的日志，有watchdog服务

$ make log service=watchdog

可以通过访问 MASTER_NODE_IP:8080 管理端

Configuration

可以通过引入文件名为 CELLO_CONFIG_FILE 配置应用。默认情况下，加载config.py 文件。

Data Storage

mongo容器存储路径为/opt/cello/mongo，存储永久性数据。请确保该文件夹访问安全。