使用TortoiseSVN的客户端钩子脚本触发Jenkins构建

我们项目在开发过程中使用了Jenkins构建Windows版本，为了通过自动触发使构建的版本保持最新，可以采用的方法如下：

• Jenkins Poll SCM：设置Jenkins定时检查变更，在SVN版本号有变更的情况下执行构建；
• Jenkins Remote Trigger + SVN Post Commit Hook：配置SVN仓库的Post Commit Hook，在提交完成后触发Jenkins远程构建；

显然，第二种方法更可取一些。但是在公司内配置SVN Server Hooks需要申请权限和访问规则。

幸好，我们使用的TortoiseSVN支持客户端钩子脚本(Hook Scripts)。

 

客户端钩子脚本的类型和参数

TortoiseSVN的客户端钩子脚本支持以下几种类型：

我们需要的是Post-commit类型的脚本。在脚本执行的时候，TortoiseSVN会传递的参数信息如下：

这些参数的意义如下：

其中，PATH指向的文件包含了本次提交影响到的所有文件的路径，ERROR指向的文件包含了本次提交的错误信息。这两个参数是我们需要关心的。

Post-commit脚本

我们使用的脚本如下：

HOOKS/POST_COMMIT_HOOK.BAT

Python脚本的封装，内容如下：

 

1 2	set current_path=%~dp0 python.exe %current_path%\post_commit_hook.py %*

 

HOOKS/POST_COMMIT_HOOK.PY

实际的钩子脚本，内容如下：

 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72

#!/usr/bin/env python # -*- coding:utf-8 -*-   import sys import os from shutil import copyfile   import json import urllib2   if len(sys.argv) < 2:     sys.exit()   current_path = os.path.dirname(os.path.abspath(__file__))   with open(current_path + '/post_commit.log','w') as f:     f.write(str(sys.argv[1:]))      if len(sys.argv) < 7:     sys.exit()   path = sys.argv[1] depth = sys.argv[2] message_file = sys.argv[3] revision = sys.argv[4] error = sys.argv[5] cwd = sys.argv[6]   #copyfile(path, current_path + '/path.tmp') #copyfile(message_file, current_path + '/message_file.tmp') #copyfile(error, current_path + '/error.tmp')   # if error is not empty, the commit should not success try:     if os.stat(error).st_size > 0:        print "[INFO] error happened"        sys.exit() except OSError:     # no such file, which should not happen     print "[ERROR] no error file"     sys.exit()      # if files include source files or project files, trigger ci build source_extensions = ['.h', '.cpp', '.cc', '.c', '.vcxproj', '.vcxproj.filters']   def SourcePath(file_path):     for extension in source_extensions:         if file_path.endswith(extension):             return True       return False   source_changed = False   with open(path) as f:     for line in f:         if SourcePath(line.strip()):             source_changed = True             break;   if not source_changed:     print "[INFO] source not changed"     sys.exit()      print "[INFO] source changed"   jenkins_job_url = 'http://USER:USER_API_TOKEN@JENKINS_URL/job/JOB_NAME/buildWithParameters?token=TOKEN_NAME&cause=svn-post-commit'   req = urllib2.Request(jenkins_job_url ) response = urllib2.urlopen(req)   print "[INFO] response = " + str(response)

钩子脚本的主要工作如下：

1. 判断本次提交是否出错，如果有错误，说明提交未成功，退出脚本；
2. 遍历本次提交影响到的所有文件，如果包括源代码文件(‘.h’, ‘.cpp’, ‘.cc’, ‘.c’)，或者项目配置文件(‘.vcxproj’, ‘.vcxproj.filters’)，则说明需要触发构建，否则退出脚本；
3. 调用jenkins_job_url触发构建。

JENKINS JOB URL

钩子脚本中jenkins_job_url的定义如下：

 

1	jenkins_job_url = 'http://USER:USER_API_TOKEN@JENKINS_URL/job/JOB_NAME/buildWithParameters?token=TOKEN_NAME&cause=svn-post-commit'

其中的变量含义分别如下：

USER/USER_API_TOKEN

Jenkins用户名和对应的API TOKEN。

JENKINS_URL

Jenkins的访问路径。

JOB_NAME

项目名称。

TOKEN_NAME

在项目的远程构建中设置的身份验证，需要启用触发远程构建的选项。

设置钩子脚本

打开TortoiseSVN设置界面，选择钩子脚本：

点击增加，打开设置钩子脚本界面：

进行以下设置：

• 设置钩子类型为提交之后；
• 设置工作副本路径为trunk目录；
• 设置执行的命令行为post_commit_hook.bat;
• 选中运行时隐藏脚本和总是执行这些脚本选项，不要选中等待脚本运行结束选项。

验证构建

在提交版本后，检查Jenkins中是否触发了构建。如果成功触发了构建，控制台输出应该如下：

参考

• • TortoiseSVN’s Settings > Client Side Hook Scripts

转载于:https://www.cnblogs.com/h2zZhou/p/10382350.html