今天終於完成了在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代碼貢獻之旅了。如果遇到其他問題,也歡迎留言討論。