开启OpenStack社区贡献之路

今天终于完成了在gerrit上的第一次提交，添加自己的相关信息到OpenStack，现在总结一下开启OpenStack社区之旅的步骤，以帮助后来者。我所使用的环境为CentOS7，如果是其他操作系统请换成相应的命令。

1. 注册

首先是注册，主要有一下几个网站的注册：

1.1 Launchpad注册

进入https://launchpad.net网站，点击网站右上角注册链接注册，如下图：

特别需要注意输入的电子邮件与用户名。

1.2 注册OpenStack社区官网

进入http://www.openstack.org/官网，点击JOIN进行注册，对于个人贡献者，选择Fandation Member注册。

特别需要注意用户名与电子邮箱，以及填写的相关信息。

1.3 注册gerrit网站账号

进入https://review.openstack.org/#/q/status:open，点击右上角sign in，使用注册的launchpad账号登录。

特别提醒，这三个网站中的用户名和电子邮箱最好都使用一个，不然可能会出现一些莫名其妙的错误。

2. 设置必要信息

2.1 在launchpad上添加SSH Key

使用注册的账号登录，添加SSH Key。

2.2 在review网站上设置必要信息

在review中设置SSH Key等信息。

3. 安装git和git-review，并配置相关信息

3.1 安装git和git-review

安装git：

yum install git

安装git-review：

yum install git-review

如果提示找不到git-review包，则需要进行一下操作：

wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo rpm -Uvh epel-release-latest-7*.rpm

3.2 配置git

此外需要进行一下的配置：

git config --global user.name "your username"

git config --global user.email your e-mail

git config --global gitreview.username "your review username"

这里的username、review username和email与下图相同：

另外，因为国内会对29418的port屏蔽，所以我们不使用ssh上传代码，使用https的方式，所以还要进行一下配置：

git config --global gitreview.scheme https

git config --global gitreview.port 443

4. 进行代码review

4.1 下载代码

输入以下命令下载相应代码：

git clone https://github.com/stackforge/stackalytics.git

cd stackalytics

4.2 建立分支

输入以下几条命令建立分支：

git remote –v

git remote update#获取origin

git checkout master

git pull --ff-only origin master

git checkout -b update_user_info#建立分支

分支建立完成之后，输入以下命令检测是否可以进行代码review，这一步很关键，如果没有报错，则可以继续进行，否则表示前面的配置有误：

git review -s

此外，如果是有https方式提交，则还需要进行一下配置：

git remote rm gerrit

git remote add gerrit https://[email protected]/openstack/stackalytics.git

这里可以参考OpenStack官方文档：http://docs.openstack.org/infra/manual/developers.html

4.3 修改代码

分支建立完成之后，就可以修改代码了。此次主要是为了添加个人信息，所以修改以下文件即可。

vim etc/default_data.json

注意：在添加个人信息时，需要按照launchpad_id的字母顺序表进行添加，所以你需要找到自己对应的位置。

4.4 提交代码

修改完代码之后，需要编译你的代码确保没有引入问题方可提交。提交输入以下几条命令：

git add etc/default_data.json # 将修改文件添加到索引

git commit -m "add my information to default_data.json"# 提交代码到分支上

git review # review代码

期间，如果需要输入密码，则输入下图中对应的密码：

可以点击Generate Password生成密码。

还需要注意，如果在git review时提示如下错误：

fatal: remote error: 
ICLA contributor agreement requires current contact information.


Please review your contact information:


  https://review.openstack.org/#/settings/contact

则需要在下图中添加相关信息，所添加的信息需要与你在注册OpenStack中填写的信息一致，在前文中已经做了强调。

此时，你的第一次提交就完成了，进入gerrit网站便可以找到你的提交记录。

好了，这样你就可以开始你的OpenStack代码贡献之旅了。如果遇到其他问题，也欢迎留言讨论。