申请一个Linux Foundation账号

贡献Hyperledger Fabric的代码需要一个 Linux Foundation 账户—如果你没有的话,根据下面的步骤来创建一个。

创建一个Linux Foundation ID

  1. 登录 Linux Foundation ID 网站

  2. 选择 I need to create a Linux Foundation ID 选项,然后填写出现的表单。

  3. 等待几分钟,查看邮箱中的邮件是否有如下行:

    “Validate your Linux Foundation ID email”。

  4. 打开收到的链接来验证你的邮箱。

  5. 验证你的浏览器显示来如下信息 You have successfully validated your e-mail address

  6. 通过 Sign In 访问Gerrit, 然后使用你的 Linux Foundation account ID进行登录。

在Gerrit上配置SSH

Gerrit使用SSH来和Git客户端交互。如果你已经有了SSH密钥对,那么你可以跳过解释怎么生成SSH密钥对的部分。

下述步骤解释了如何在Linux环境下生成SSH密钥对—可以在你的操作系统上进行等价的步骤。

首先,使用如下命令创建SSH密钥对:

ssh-keygen -t rsa -C "John Doe john.doe@example.com"

Note: 这会提示你输入一个密码来保护这个唯一的私钥。请对密码进行保密,不要填写空格。

生成的SSH密钥对可以在 ~/.ssh/id_rsa~/.ssh/id_rsa.pub 文件中找到。

接下来,把在 id_rsa 文件中的私钥添加到key ring中,例如:

ssh-add ~/.ssh/id_rsa

最后,将生成的密钥对的公钥添加到Gerrit服务端,按照如下步骤:

  1. 进入 Gerrit
  2. 点击右上角你的账号名。
  3. 从弹出的菜单中选择 Settings
  4. 在左侧的菜单上,点击 SSH Public Keys
  5. 复制你的公钥的内容 ~/.ssh/id_rsa.pub 点击 Add key

注意: id_rsa.pub 文件在文本编辑器中打开,确保该文件所有的内容都被选中, 复制粘贴到Gerrit的 Add SSH key 窗口中。

Note: SSH密钥生成指南是基于你是用默认的命名的假设前提下操作的。 当然也可以生成多个SSH迷药对,使用不同的命名。参考 ssh-keygen 文档进行操作。一旦你生成了一个不是默认名字的密钥对,你需要配置SSH对Gerrit 使用正确的密钥。在这种情况下,你需要仿照下面的模型创建 ~/.ssh/config 配置文件。

host gerrit.hyperledger.org
 HostName gerrit.hyperledger.org
 IdentityFile ~/.ssh/id_rsa_hyperledger_gerrit
 User <LFID>

LFID是你的Linux Foundation ID,IdentityFile是你生成的公钥的名字。

Warning: 潜在的危险! 不要拷贝你的私钥 ~/.ssh/id_rsa 仅仅使用公钥 ~/.ssh/id_rsa.pub

检出源代码

一旦你设置了之前讲的SSH,你可以通过下面的命令克隆源代码:

git clone ssh://<LFID>@gerrit.hyperledger.org:29418/fabric fabric

你已经成功地在你的电脑上检出了源代码。