钉钉自定义机器人配合SVN钩子事件进行消息的推送实践

时间:2021-08-13 01:01:57

  目前很多公司还是使用SVN(TortoiseSVN)进行版本控制,使用简单,适合管理一般项目。协同办公软件目前钉钉比较成熟,阿里也一直在宣传推广,这两年公司也在使用,主要用于信息的沟通,其它的绩效、考勤、日志、审批等都是挂载的我们公司内部的系统,很方便,之后钉钉推出了钉钉机器人,一开始觉得没用,也就一直没关注,但是最近我看了钉钉自定义机器人,觉得这个可以好好利用起来,看到网上也有这方面的应用说明,看着很简单,但是按照流程操作起来各种坑,而且相关知识过于碎片化,今天我在这里进行一下简单的整合,梳理一下,希望对有这方面需求但是遇到问题的朋友们有所帮助。


一、环境说明

系统:CentOS7

客户端SVN版本:1.8.7(Windows版本)

服务端SVN版本:1.7.14


二、CentOS7安装SVN服务端

1、安装SVN

yum install subversion

安装完成后使用

svnserve --version

查看SVN版本,表示安装成功。

2、创建版本库

例如:创建一个 /var/svnroot/test的版本库目录,首先创建目录

mkdir -p /var/svnroot/test

然后使用svnadmin创建版本库:

svnadmin create /var/svnroot/test

创建完成之后/var/svnroot/test下面生成如下文件:

钉钉自定义机器人配合SVN钩子事件进行消息的推送实践

3、修改SVN配置文件

SVN的配置文件在conf目录下面:

钉钉自定义机器人配合SVN钩子事件进行消息的推送实践

【authz】是权限控制文件

【passwd】帐号密码文件

【svnserve.conf】SVN服务配置文件


1)创建SVN用户,设置密码

修改【authz】文件,命令:vi passwd 

在文档最下面加入如下内容:

钉钉自定义机器人配合SVN钩子事件进行消息的推送实践

2)修改权限控制

钉钉自定义机器人配合SVN钩子事件进行消息的推送实践

表示用户guof对版本库的根目录读写权限

3)配置SVN服务

vi svnserve.conf

打开以下注释:

auth-access = write #授权用户可写

password-db = passwd #使用哪个文件作为账号文件

authz-db = authz #使用哪个文件作为权限文件

realm = /var/svnroot/test  #认证空间名,版本库所在目录(此处写你的实际SVN版本库路径)

4、启动版本库

启动:

svnserve -d -r /var/svnroot/test

停止:

killall svnserve

5、Windows客户端检出测试

钉钉自定义机器人配合SVN钩子事件进行消息的推送实践

然后提示输入账户、密码即可检出。


到此为止,CentOS7上安装SVN服务端结束,很简单吧!

接下来就是钉钉机器人以及SVN钩子的配合了....

钉钉机器人相关参考资料:

  钉钉开发平台-文档中心:https://open-doc.dingtalk.com/docs/doc.htm?treeId=257&articleId=105735&docType=1

其实无非就是post请求钉钉机器人而已,大家可以下载jar包自己在处理,封装成一个jar包供SVN钩子使用,进而进行消息的通知。此处就先不说Java代码怎么封装了,有需要的可以留言联系。

什么是SVN的hooks?

svn hooks是一组“外挂”脚本程序,是svn提供的一组由svn事件触发的特别有用的程序。这些程序在服务器端执行,可以提供svn之外的一些附加功能。钩子可以调用批处理文件、可执行文件或者一些类似于perl、python等的脚本,SVN钩子有如下几种:

钉钉自定义机器人配合SVN钩子事件进行消息的推送实践

参考:https://www.cnblogs.com/gaohj/p/3154448.html

http://blog.csdn.net/wepe12/article/details/53510223

我们想在有人提交SVN后知道是谁在哪个时间提交了什么内容,那么就需要post-commit钩子了,首先我们要把post-commit.tmpl模板文件拷贝一份,改名为post-commit (注意:post-commit.tmpl是模板文件,要使用的话必须改名为post-commit,即事件名和文件名要一直,要是SVN规定的,当时就坑在这里了,忘记改名,同时赋予其可执行权限)

cp post-commit.tmpl post-commit
chmod +x post-commit # 赋予可执行权限

其中post-commit在触发后会传入两个参数,一个是当前修改的目录,一个是当前版本号,有了这俩其实就足够了,但是有人会问:我看很多人做的消息推送里面有修改时间、修改人、提交的内容以及提交的备注日志信息啊,这俩参数怎么够呢?其实开始我也是纳闷这个问题,后来仔细看了一下SVN官方文档加各种博客才知道可以使用 svnlook命令啊,例如我想知道某个版本是谁提交的,可以使用:svnlook author -r 版本号 版本库路径,想知道提交时候都写了什么说明,可以使用:svnlook log -r 版本号 版本库路径,具体可参考:https://www.cnblogs.com/wangjiyuan/p/svnnn.html

此时我们修改post-commit里面的内容,我把其中的内容都删除了,加入了我自己的:

#!/bin/sh
# 建议加上这句,防止中午乱码,也可以是export LANG=zh_CN.GBK 根据实际情况设置
export LANG=zh_CN.UTF-8
REPOS="$1"
REV="$2" # 作者
AUTHOR=$(svnlook author -r $REV $REPOS) # 备注信息
MESSAGE=$(svnlook log $REPOS -r $REV) # 本次提交的内容,返回格式: A 新建文本文档.txt 其中,A:新增 D:删除 U:修改 UU:内容和属性改变
CHANGEDLIST=$(svnlook changed -r $REV $REPOS) # 修改日期
DATE=$(svnlook date -r $REV $REPOS) # 下面调用jar包个人根据实际情况处理,不一定调用jar包,可以是Python脚本,甚至当前这个脚本都可以用Python写,就不用调用了,直接调用机器人发送消息
java -jar /var/svnroot/DingDingReboot.jar /var/svnroot/config.properties "$AUTHOR" "$REPOS" "$DATE" "$MESSAGE" "$CHANGEDLIST" "$REV"

这样的话就把提交人、版本库路径、提交时间、提交日志、改动的内容、当前版本库传入你的jar包了,然后你的jar包接收参数、处理参数、封装、按照要求post钉钉机器人即可发送消息。

相关坑和关键点说明

1、钉钉收到的消息中文乱码,例如:

钉钉自定义机器人配合SVN钩子事件进行消息的推送实践

目前的解决方案就是在post-commit头加入

export LANG=zh_CN.UTF-8 或者:
export LANG=zh_CN.GBK

2、一定要把hooks下面用到的钩子改名,即用到哪个,就把文件后缀.tmpl去掉,或者直接创建一个新文件

3、要给post-commit赋予可执行权限,不然出现255错误

4、灵活应用svnlook命令,很多你想要的信息都可以通过它获取到

最终效果:

钉钉自定义机器人配合SVN钩子事件进行消息的推送实践

钉钉自定义机器人配合SVN钩子事件进行消息的推送实践


至此svn安装、钩子配置全部完成,希望可以帮到有需要的各位!