《使用Jenkins搭建CI并集成至phabricator》

一. 持续集成的作用

持续集成可以保证代码在多人协作，高频次提交的情况下持续可用。一般可以在code review流程中或者在pull request时触发CI并作为是否通过的重要依据。CI可以保证系统尽可能的维护一个可用的最新的版本。我们在实际使用中，将CI引入到了code review流程中，并与phabricator集成

二. CI框架的选型

CI的框架根据支持的OS和语言等等的不同，有很多种选择。如下列表

部分CI框架列表

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

【mxnet的travis】

travis项目界面

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

【mxnet的jenkins】

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 build节点

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

build任务配置

说明，使用gradlew clean assemble进行编译

3. 搭建cpp build 节点

搭建cpp节点需要配置好所需要的tool_chain和依赖库的环境变量

cpp build 示例

四. 集成至phabricator

phabricator是facebook开源的项目&代码管理的平台。功能齐全，稳定。国内很多的团队都使用该工具。我们需要配置phabricator使之能够在提交code review的同时，将diff 提交到CI平台进行build和test并返回报表。这需要配置2个部分。详细可以参考插件的github地址phabricator-jenkins-plugin