Gerrit使用说明
注意:该文档中的假定使用分支为dev。
1.Gerrit配置
其中提到的下列步骤,请确认在你即将进行的专案中,是否已经配置完成。
自動添加 Change-Id
將 commit-msg 放到工程目錄中的 .git/hooks/ 裡面,之後的 commit 就會自動添加 Change_Id 到 commit message 中
可根據需求調整 commit-msg 的內容
2.新Subject的Push及Review
2.1 Push
1.若当前需push的版本在Gerrit中不存在时,在Git中使当前分支与origin/dev在同一主线上,并且保证当前分支与origin/dev之间没有其他分支:
(注:若该主线中存在其他分支,所有分支将被push进入Gerrit Server)
2.点击“Push”,Remote分支为“Origin”, push至“refs/for/dev”:
2.2 Verify/Review
2.2.1 打开Subject
1.push成功后,所有项目相关人员均会收到邮件提醒
2.网页打开Gerrit并登陆
3.进入All->Open,可浏览当前还未Merge的Subject(Subject的名称同Commit Message相同):
右侧显示Code Review及Verify均未执行。
4.点击进入Subject,进行Verify
2.2.2 Verify
1.复制Download下的地址:
2.Git Extension中打开Git Bash(若由于配置不正确无法打开Git Bash,可进入工程目录通过点击鼠标右键,选择Git Bash进入)
3.Git Bash中点击鼠标右键粘贴已复制的地址,点击”Enter“:
4.Git Extension进行刷新,此时已进入待Verify的分支,进行build和运行,以验证改版本为可使用版本
5.若验证成功,Gerrit中点击”Review“进入Review页面,”Verified“下选择”+1 Verified“;否则选择”-1 Fails“:
2.2.3 Review
Verify成功后可进行Review动作:
1.在该Subject页面下的FilePath选择希望查看的文件:
2.此时可进行文件对比(左:原文件,右:当前版本文件):
3.双击一行可进行备注添加,点击”save“将保存备注,”discard“放弃备注:
4.Review完毕后,点击”Review“按钮可进行评分,需一次得到两分才可获取提交资格:
2.2.4 Submit
当Verify通过,且Review一次获取2分后,可进行Submit,将版本并入Server:
点击”Submint Path Set *“:
此时版本成功合并入Server。
3.已存在Subject的push
1.当Code Review没有通过(Verfiy未通过,或Review没有一次获的2分)时,需要在当前Subject下push修改后的分支时,注意可在Commit时进行Amend,是当前分支保持原地:
2.点击“Amend last commit”,使分支保持原先的Commit Message和Change Id
3.再次点击“Amend last commit”,确认修改当前分支
4.继续的向“refs/for/dev”路径的push
5.此时在该Subject下将会有两个版本:
6.继续上一节的Verify和Review动作,直至通过Review