GitLab+Jenkins持续集成

1、概述

GitLab是一个代码仓库，用来管理代码。Jenkins是一个自动化服务器，能够运行各类自动化构建、测试或部署任务。因此这二者结合起来，就能够实现开发者提交代码到GitLab，Jenkins以必定频率自动运行测试、构建和部署的任务，帮组开发团队更高效的集成和发布代码。

 

下面是我最近安装GitLab+Jenkins环境的一个过程，记录下来，以备往后参考。

另外，这篇文章虽然很长，讲得很琐碎，可是仍有未能描述清楚的地方，若是按照这篇文章未能搭建成功，请耐心分析，也可从官方文档 找找灵感，继续下去总会成功的。

 

环境

操做系统	ip地址	角色	访问地址
ubuntu-16.04.4-server-amd64	192.168.10.122	Jenkins	http://192.168.10.122:8080/
ubuntu-16.04.4-server-amd64	192.168.10.134	GitLab	http://192.168.10.134/

 

 

 

 

Jenkins 安装教程，请参考连接：

http://www.javashuo.com/article/p-clpekofp-ky.html

GitLab 安装教程，请参考连接：

http://www.javashuo.com/article/p-qijwneax-kg.html

 

2、使用GitLab建立一个项目

点击 Create a project

 

建立 test 项目

 

添加 README 文件

 

输入内容，点击肯定

 

 

效果以下：

 

建立jenkins用户

点击扳手按钮

 

点击 User

 

添加 jenkins 用户，点击最下面的Create user按钮。

 

 点击编辑

 

修改密码，这里我定义的是 jenkins@1234

 

设置jenkins 用户ssh秘钥

 点击 Impersonate ，表示冒充jenkins 用户

 

点击设置

 

点击 ssh keys

 

登陆到jenkins服务器，生成秘钥

ssh-keygen -t rsa -P "" -f ~/.ssh/id_rsa

 

查看公钥

cat /root/.ssh/id_rsa.pub

 

将公钥内容复制到网页，点击添加秘钥

 

建立Access Tokens

点击左侧的Access Tokens，输入用户 jenkins，勾选权限，点击建立

复制token，待会 jenkins 设置时，会用到。Zzis8ALsiYuytsg2GH-5

 

 

点击退出

 

从新登陆root用户，点击test

 

点击设置-成员

 

 

添加jenkins 用户，这样就能够访问项目了

 

 

3、 jenkins 安装和Git，GitLab插件

因为 jenkins安装时，勾选了推荐安装的插件，所以包含了git插件。

如今只须要安装gitlab插件便可

 

点击 Manage Jenkins --> Manage Plugins -->可选插件，搜索gitlab

勾选gitlab，点击直接安装

 

等待十几分钟

 

提示安装完成

点击 Manage Jenkins --> Configure System -->配置 -->Gitlab

 

 

Connection Name ”随便填，“Git Host URL”填GitLab的访问地址，而后点“Add”——“jenkins”，以下所示：

 

选择gitlalb api，输入 jenkins 用户建立的token Zzis8ALsiYuytsg2GH-5

 

选择 gitlab api token，点击测试链接，出现 Success，表示成功。

 

 点击最下面的保存

 

配置Git插件

点击 Manage Jenkins --> Configure System -->配置 -->Git plugin

 

设置Git插件的全局配置，而后点击最下面的保存。

 

4、建立一个Jenkins Job

在jenkins里，一个任务叫作一个job。通常咱们的项目会有多个分支，好比开发分支和产品分支，咱们能够对每个分支都新建一个job，好比，咱们对开发分支建立一个测试的job,每次有代码提交就自动运行一次测试，对产品分支建立一个打包的job，每次有代码提交就运行打包任务。

不过在这里，咱们只是单纯的建立一个job，来演示jenkins自动运行任务的过程。

 

首先，点击 新建Item，item name”能够随便起，而后点击“构建一个自由风格的软件项目”，点击Ok

至此，建立一个Job成功了

 

因为 jenkins 服务器的ssh秘钥，已经添加到gitlab上面了。那么就能够进行下一步了！

 

配置Job的源码管理

选择“源码管理”，选择“Git”,而后去GitLab中复制项目地址，粘贴到“Repository URL”,而后点击“credentials”后面的“Add”按钮

 

类型，选择 SSH Username with private key

Username 填 root

PrivateKey 选择Enter directly，点击add

 

登陆到jenkins 服务器，查看私钥

cat /root/.ssh/id_rsa

 

将内容复制到网页上面，点击添加

 

在“credentials”里选择咱们刚刚建立的认证方式：root

 

若是没报错，说明成功了，点击页面底部的“apply”。若是出错了，会在“Repository URL”和“Credentials”之间显示红色的错误信息。

jenkins job默认对master分支进行构建，你也能够自定义分支。这要求你的Gitlab代码仓库中要存在这个分支，通常来讲，就是要向代码仓库提交一次更改，请 自行完成（Gitlab项目刚建立时是空的，一个分支也没有，这样的话，自动构建时会出错）

 

 

配置Job的构建触发器

选择“构建触发器”，勾选“Pull SCM”，这个选项会每隔一段时间检查一下GitLab仓库中代码是否有更新，有的话就执行构建操做。日程表如何设置，在这个输入框下面有说明。

 

扩展阅读：

常见构建触发器、：

• Build after other projects are built 当另外一个构建任务完成以后触发
• Build periodically 周期性的触发
• Build when a change is pushed to GitLab. GitLab CI Service URL: http://191.8.2.112:12000/project/test-go-dev 当代码有更新的时候触发，经过GitLab CI
• GitHub hook trigger for GITScm polling 经过Github钩子触发
• Poll SCM 按期检查代码有无更新，有更新时触发

这只是我的理解，具体怎么样你们能够试试，Poll SCM方式我是试过的。

配置Job的构建脚本

在build栏目里，选择“jenkins execute shell”,而后输入你项目的构建命令（这依赖于你的项目，如Maven的maven build，gulp的gulp xxx 等等）

 

这里我输入一段测试命令，表示将git项目的代码复制到/tmp/test

\cp -r $WORKSPACE /tmp/test

 

点击 可用的环境变量列表，就能够看到不少变量

 

其中 WORKSPACE 表示，下载git项目后的路径。

因为git项目为test，所以路径为：/var/lib/jenkins/workspace/test

点击保存

 

点击 Build Now，点击下面的构建过程

 

点击控制台输出，就能够看到完整的cp命令

 

登陆到jenkins服务器，查看/tmp/test目录，是否有文件存在。

root@ubuntu:~# ll /tmp/test/
总用量 16
drwxr-xr-x  3 jenkins jenkins 4096 8月  28 18:27 ./
drwxrwxrwt 14 root    root    4096 8月  28 18:29 ../
drwxr-xr-x  8 jenkins jenkins 4096 8月  28 18:27 .git/
-rw-r--r--  1 jenkins jenkins   16 8月  28 18:27 README.md

 

 

本文参考连接：

http://www.javashuo.com/article/p-bmhvoegt-ka.html

http://www.javashuo.com/article/p-elkxsmbm-eb.html