申请一个Linux Foundation账号¶
贡献Hyperledger Fabric的代码需要一个 Linux Foundation 账户—如果你没有的话,根据下面的步骤来创建一个。
创建一个Linux Foundation ID¶
选择
I need to create a Linux Foundation ID
选项,然后填写出现的表单。- 等待几分钟,查看邮箱中的邮件是否有如下行:
“Validate your Linux Foundation ID email”。
打开收到的链接来验证你的邮箱。
验证你的浏览器显示来如下信息
You have successfully validated your e-mail address
。通过
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服务端,按照如下步骤:
- 进入 Gerrit 。
- 点击右上角你的账号名。
- 从弹出的菜单中选择
Settings
。 - 在左侧的菜单上,点击
SSH Public Keys
。 - 复制你的公钥的内容
~/.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
你已经成功地在你的电脑上检出了源代码。