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#建立分支
如果是有https方式提交,则还需要先进行一下配置:
git remote rm gerrit
git remote add gerrit https://xiangbinbin@review.openstack.org/openstack/stackalytics.git
分支建立完成之后,输入以下命令检测是否可以进行代码review,这一步很关键,如果没有报错,则可以继续进行,否则表示前面的配置有误:
git review -s
这里可以参考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代码,有时候需要先执行一下git remote update gerrit,再执行git 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网站便可以找到你的提交记录。