如何向 Hyperledger Fabric 项目贡献代码

原创 2016年12月13日 15:06:16

如何向 Hyperledger Fabric 项目贡献代码

安装环境

推荐在 Ubuntu 14.04+ 环境中开发代码,并安装如下工具。

  • git:用来获取代码;
  • golang 1.6+:安装成功后配置 $GOPATH 等环境变量。

获取代码

首先注册 Linux foundation ID,并登陆 https://gerrit.hyperledger.org/,添加个人 ssh pub key。

查看项目列表,找到对应项目,以 fabric 为例,获取 Clone with commit-msg hook 的方式。

典型的,执行如下命令获取代码,其中 LF_ID 替换为你的 Linux foundation id。

$ git clone ssh://LF_ID@gerrit.hyperledger.org:29418/fabric && scp -p -P 29418 LF_ID@gerrit.hyperledger.org:hooks/commit-msg fabric/.git/hooks/

如果没有添加个人 ssh pubkey,则可以通过 https 方式 clone,需要输入用户名和密码信息。

git clone http://LF_ID@gerrit.hyperledger.org/r/fabric && (cd fabric && curl -kLo `git rev-parse --git-dir`/hooks/commit-msg http://LF_ID@gerrit.hyperledger.org/r/tools/hooks/commit-msg; chmod +x `git rev-parse --git-dir`/hooks/commit-msg)

clone 下代码后,为了方便后面的编译测试,需要放到 $GOPATH/src/github.com/hyperledger/ 路径下。

$ mkdir

编译和测试

大部分编译和安装过程都可以通过 Makefile 来执行。

安装 go tools

执行

$ make gotools

语法格式检查

执行

$ make linter

编译 peer

执行

$ make peer

生成 Docker 镜像

执行

$ make images

执行单元测试

执行

$ make unit-test

如果要运行某个特定单元测试,则可以通过类似如下格式。

$ go test -v -run=TestGetFoo

执行 BDD 测试

需先生成本地 Docker 镜像。

执行

$ make behave

提交代码

仍然使用 Linux foundation ID 登录 jira.hyperledger.org,查看有没有未分配的任务,如果对某个任务感兴趣,可以添加自己为 assignee,如对 FAB-XXX 任务。

本地创建新的分支 FAB-XXX。

$ git checkout -b FAB-XXX

实现任务代码,完成后,执行语法格式检查和测试等,确保所有检查和测试都通过。

提交代码到本地仓库。

$ git commit -a -s

会打开一个窗口需要填写 commit 信息,格式一般要求为:

Simple words to describe main change

This fixes #FAB-XXX.

A more detailed description can be here, with several
paragraphs and sentences...

之后使用 git review 命令推送到远端仓库。

$ git review

提交成功后,可以打开 gerrit.hyperledger.org/r/,查看自己最新提交的 patchset 信息,添加几位 reviewer。之后就是等待开发者团队的 review 结果,如果得到通过,则会被项目的 maintainer 们 merge 到主分支。否则还需要针对大家提出的建议进一步的修正。

修正过程跟提交代码过程类似,唯一不同是提交的时候使用

$ git commit -a --amend

表示这个提交是对旧提交的一次修订。

更多内容可以参考 区块链技术指南

转载请注明:

http://blog.csdn.net/yeasy/article/details/53609814

https://github.com/yeasy/blockchain_guide/blob/master/hyperledger/contribute.md


Hyperledger Fabric 开发环境搭建

搭建开发环境概述Hyperledge fabric项目是IBM开源的区块链项目。Github地址:https://github.com/hyperledger/fabricHyperledge fab...
  • zgljl2012
  • zgljl2012
  • 2016年10月23日 00:32
  • 16419

编译hyperledger fabric官方源码

开发环境介绍 UBUNTU 16.04 LTS docker docker-compose git go 1.8以上 进入fabric源码目录
  • pony_maggie
  • pony_maggie
  • 2017年11月27日 16:17
  • 333

hyperledger 搭建

概述 目前Hyperledge fabric的开发环境是使用一个运行在Vagrant里的Ubuntu映像,并在里边依次运行若干Docker容器。 从概念上说,就是在一个主机上启动了一个虚拟机,然后在...
  • len_yue_mo_fu
  • len_yue_mo_fu
  • 2016年12月22日 12:14
  • 613

HyperLedger fabric1架构分析及区块链技术详解

  • 2017年11月16日 11:43
  • 2.51MB
  • 下载

Hyperledger Fabric v1.0 开发环境搭建

Hyperledger Fabric v1.0 开发环境搭建
  • u010862348
  • u010862348
  • 2017年03月27日 16:24
  • 3419

Hyperledger Fabric 1.0 安装和使用

Hyperledger Fabric 1.0 版本整体 重新设计了架构,预计将于今年 3 月份发布。目前已经进入了 alpha 阶段,可以进行功能性验证。 本文将介绍如何快速启动一个 Fabric...
  • yeasy
  • yeasy
  • 2017年02月08日 16:20
  • 12078

快速搭建一个Hyperledger Fabric 1.0的环境(目前很多环境搭建方法都会中途挂掉,这个亲测有效!)

超级记账本:快速搭建一个Hyperledger Fabric 1.0的环境 之前笔者写了一篇Fabric1.0 Beta的部署和Fabric 1.0的多机部署。但是很多人在部署Fabric的时候还...
  • Bearin
  • Bearin
  • 2017年10月17日 15:09
  • 1320

区块链 HyperLedger Fabric安装

前提条件 安装docker并配置阿里云加速器 安装docker compose 安装golang 由于被禁的关系,是没有办法直接访问golang.org网站的, 不过国内提供下载的网站很多, ...
  • chenhaifeng2016
  • chenhaifeng2016
  • 2017年12月21日 11:27
  • 90

hyperledger fabric 结构分析(二)

上次分析到 部署chaincode,创建ChainCodeSupport实例,建立ChainCodeSupport实例与ChainCode的Stream通信。 1. 判断当前节点是否为VP节点,如...
  • xjmtxwd24
  • xjmtxwd24
  • 2016年10月09日 15:40
  • 3010

Hyperledger fabric 源码分析之 peer 服务启动过程

peer 服务是主服务。 该服务支持各种 peer 命令。 包括查询状态,和启动、停止节点服务等。 serve 函数 最重要的是 func serve(args []string) error...
  • yeasy
  • yeasy
  • 2016年08月02日 17:25
  • 6417
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:如何向 Hyperledger Fabric 项目贡献代码
举报原因:
原因补充:

(最多只允许输入30个字)