[原创]升级Gerrit的commit-msg,检查git commit时必须填写开发任务编号TaskID

公司使用git+gerrit+jenkins进行持续集成实践,其中gerrit用来进行Code Review。另外我们自己研发了一套敏捷项目管理系统TPM(TeamPlus Management),用来管理开发任务和电子看板。此时有一个需求,希望开发人员提交的代码能够关联到TPM上的开发任务,这样就能实现需求与代码的关联,实现 需求->backlog->userstory->task->code->build->test->deploy->prod 的全流程数据关联。

目前的一个方式是在开发人员提交代码的同时,在comments中指定TaskID,其中TaskID是TPM系统中开发任务编号。但是很多时候开发人员提交代码是,忘记在comments log中指定TaskID,导致数据缺失,不能有效辅助研发过程改进。

为此,考虑参考Gerrit的commit-msg的方式,在commit代码同时,检查comments log中是否有指定合法的TaskID。(Gerrit的commit-msg,就是在commit代码的同事,给comments log增加一个Change-ID编号)

 

首先,修改commit-msg,增加TaskID的检查。

# Check for if missing a unique TaskID related with TPM

#

check_TaskID() {

 

COMMIT_FILE=$MSG

COMMIT_MSG=$(cat $MSG)

TASK_ID=$(echo "$COMMIT_MSG" | grep -Eo "#task[A-Za-z0-9]+")

if [ -z "$TASK_ID" ]; then

echo "[ERROR] Please add TPM TaskID comment logs with a format like 'comment logs #task20180623001'"

exit 1

else

echo "[INFO] StoryId=["$TASK_ID"]"

fi

}

 

# Check for, and add if missing, a unique Change-Id

#

add_ChangeId() {

...

...

...

 

check_TaskID

add_ChangeId

 

其次,是替换旧的commit-msg文件。

检索了一遍gerrit-site目录,没有发现commit-msg文件,怀疑是在gerrit.war中。解开gerrit.war,仍然没有发现commit-msg文件,怀疑实在某个依赖lib中。我们用的gerrit版本是2.12.8。翻了一下gerrit的源代码,commit-msg是在gerrit-server/src/main/resources/com/google/gerrit/server/tools/root/hooks/commit-msg,推测是在gerrit-server的依赖lib中。解开gerrit-server-server.jar后,果然发现commit-msg。

之后有两种办法替换:

1、重新编译gerrit源码。觉得太麻烦,放弃。

2、依次解压gerrit.war和gerrit-server-server.jar,修改commit-msg,再用jar命令依次打包gerrit-server-server.jar和gerrit.war。

注意打gerrit.war的时候,需要指定Manifest,指定gerrit.war的Main-Class: Main,否则java -jar gerrit.war启动的时候找不到MainClass。

 

最后,升级修改后的gerrit。

网上找一找gerrit版本升级的网页有一堆。务必注意,升级之前一定要备份gerrit-site。

1、停止gerrit。 cd gerrit-site/bin; sh gerrit.sh stop

2、备份gerrit-site

3、启动新的gerrit。  java -jar new-gerrit.war init -d gerrit-site

之后基本上一路回车就行。这个过程会替换gerrit-site/bin/gerrit.war,并会重新配置一遍gerrit。

 

验证效果

1、启动gerrit。 cd gerrit-site/bin; sh gerrit.sh start

2、打开 http://gerrit地址/tools/hooks/commit-msg,查看是否是修改以后的文件。

3、git clone项目测试。

:~/code>git clone ssh://[项目地址] && scp -p -P 29418 [gerrit地址]:hooks/commit-msg AgileMng/.git/hooks/

Cloning into 'AgileMng'...

remote: Counting objects: 1952, done

remote: Finding sources: 100% (1952/1952)

remote: Total 1952 (delta 918), reused 1870 (delta 918)

Receiving objects: 100% (1952/1952), 1.17 MiB, done.

Resolving deltas: 100% (918/918), done.

commit-msg                                                                                                                               100% 4946     4.8KB/s   00:00   

 

:~/code/AgileMng>touch 1

:~/code/AgileMng>git add 1

:~/code/AgileMng>git status

# On branch master

# Changes to be committed:

#   (use "git reset HEAD <file>..." to unstage)

#

#       new file:   1

#

 

:~/code/AgileMng>git commit -m "add new file 1"

[ERROR] Please add TPM TaskID in comment logs with a format like 'comment logs #task20180623001'

 

:~/code/AgileMng>git commit -m "add new file 1 #task20180618 new file 1"

[INFO] TaskId=[#task20180618]

[master 48daaed] add new file 1 #task20180618 new file 1

 1 file changed, 0 insertions(+), 0 deletions(-)

 create mode 100644 1

### 如何在 Gerrit 中添加 Change-Id 以避免 missing Change-Id 错误 为了防止 `missing Change-Id` 导致的提交失败,在使用 Gerrit 进行代码审查,可以采取以下方法来确保每次提交都包含有效的 Change-Id。 #### 安装 commit-msg 钩子 Gerrit 提供了一个内置的 `commit-msg` 脚本来自动为每一次新的提交生成唯一的 Change-Id。可以通过下载并配置此脚本实现自动化管理: 1. **获取 commit-msg 脚本** 下载 Gerrit 的 `commit-msg` 脚本到本地仓库的 `.git/hooks/` 文件夹中: ```bash curl -o .git/hooks/commit-msg https://<gerrit-server>/tools/hooks/commit-msg chmod u+x .git/hooks/commit-msg ``` 2. **验证安装成功** 执行上述命令后,检查 `.git/hooks/commit-msg` 是否具有可执行权限,并确认其内容是否来自指定的 Gerrit 地址[^3]。 #### 补充已丢失的 Change-Id 对于已经存在的提交记录,如果发现某些提交缺少 Change-Id,则可通过以下方式补充: ##### 方法一:利用 `git commit --amend` 当缺失的 Change-Id 是最近一次提交,可以直接通过修改最后一次提交消息的方式重新生成 Change-Id: ```bash git commit --amend ``` 这一步骤会触发之前安装好的 `commit-msg` 钩子程序,从而自动生成一个新的 Change-Id 并更新至当前提交的消息中[^2]。 ##### 方法二:重置历史提交并通过交互式 rebase 添加 Change-Id 如果需要修复较早的历史提交中的 Change-Id 缺失问题,可以采用如下流程: 1. 使用 `git rebase -i HEAD~N` (其中 N 表示要回溯的提交数量),进入交互模式。 2. 将目标提交标记为 `edit` 或者 `e`。 3. 当到达编辑状态,运行以下命令手动添加 Change-Id: ```bash echo "some commit" > /tmp/test_generate_change_id .git/hooks/commit-msg /tmp/test_generate_change_id git commit --amend --no-edit ``` 4. 继续完成 rebase 流程: ```bash git rebase --continue ``` 以上操作完成后,再次尝试推送更改即可正常上传带有有效 Change-Id 的版本[^1]。 #### 注意事项 - 确保所有开发者均已完成 `commit-msg` 钩子的设置工作,以便统一团队内的开发环境标准。 - 若遇到任何关于权限或者网络连接方面的问题,请联系管理员核实服务器地址以及访问策略。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值