《使用Jenkins搭建CI并集成至phabricator》
一. 持续集成的作用
持续集成可以保证代码在多人协作,高频次提交的情况下持续可用。一般可以在code review流程中或者在pull request时触发CI并作为是否通过的重要依据。CI可以保证系统尽可能的维护一个可用的最新的版本。我们在实际使用中,将CI引入到了code review流程中,并与phabricator集成
二. CI框架的选型
CI的框架根据支持的OS和语言等等的不同,有很多种选择。如下列表

其中travis-ci跟github高度集成,界面简洁。个人十分推荐。但是如果项目不是public的话,需要每月129美元的费用

另一个用的比较广泛的就是Jenkins。在百度,QA构建CI就是基于集群化的Jenkins

综合考虑,我们选择Jenkins作为CI的构建框架
大致架构是:

我们需要为不同的语言构建不同的build环境,作为slave挂载到master上,通过tag来将不同的build任务分发到不同的环境
android: 统一到android studio的编译工具环境,使用gradle进行编译
cpp: 统一到makefile和cmake,后面希望尝试blade或者bazel来管理cpp的代码库
三. 搭建步骤
1. 搭建Jenkins master 节点
我们使用docker搭建jenkins节点,并使用卷volume进行数据的持久化。Jenkins docker home中有详细的使用说明
docker run -p 8080:8080 -p 50000:50000 -v /your/home:/var/jenkins_home jenkins
所有数据都会持久化在/your/home的目录中。docker下载镜像的过程由于网络原因会比较慢。可以使用daocloud提供的镜像来加速这个过程。参考【daocloud docker工具】
中间有个密码需要记录,后面会用来激活,进入安装流程页面

我们使用到的必须的插件有:git,gradle,ssh agent,phabricator
2. 搭建android build 节点
系统管理->管理节点

注意:需要在新加入的节点上配置好ANDROID_HOME和JAVA_HOME环境
最后在新添加的CI任务中指定android项目在该节点上编译

说明,使用gradlew clean assemble进行编译
3. 搭建cpp build 节点
搭建cpp节点需要配置好所需要的tool_chain和依赖库的环境变量

四. 集成至phabricator
phabricator是facebook开源的项目&代码管理的平台。功能齐全,稳定。国内很多的团队都使用该工具。我们需要配置phabricator使之能够在提交code review的同时,将diff 提交到CI平台进行build和test并返回报表。这需要配置2个部分。详细可以参考插件的github地址phabricator-jenkins-plugin
- phabricator部分
Herald, 配置指定提交code review的同时,提交CI到Jenkins。注意,此时代码的commit还只在本地,没有push到远端。


通过http触发Jenkins开始持续集成的构建
- Jenkins配置
需要分别配置“ 参数化构建过程”,“Apply Phabricator Differential”和“Post To Phabricator”来与Phabricator联动
最终的效果如下图。CI的进度和消息会融合在Code Review的Feeds中,作为Code Review重要的依据
