gitlab + jenkins 持续集成

一、概述

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

gitlab + jenkins 持续集成

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

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

环境

操作系统ip地址角色访问地址
ubuntu-16.04.4-server-amd64192.168.10.122Jenkinshttp://192.168.10.122:8080/
ubuntu-16.04.4-server-amd64192.168.10.134GitLabhttp://192.168.10.134/

Jenkins 安装教程,请参考链接:

https://www.cnblogs.com/xiao987334176/p/11323795.html

GitLab 安装教程,请参考链接:

https://www.cnblogs.com/xiao987334176/p/11329018.html

二、使用GitLab创建一个项目

点击 Create a project

gitlab + jenkins 持续集成

创建 test 项目

gitlab + jenkins 持续集成

添加 README 文件

gitlab + jenkins 持续集成

输入内容,点击确定

 gitlab + jenkins 持续集成

效果如下:

gitlab + jenkins 持续集成

创建jenkins用户

点击扳手按钮

gitlab + jenkins 持续集成

点击 User

gitlab + jenkins 持续集成

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

gitlab + jenkins 持续集成

 点击编辑

gitlab + jenkins 持续集成

修改密码,这里我定义的是 

gitlab + jenkins 持续集成

设置jenkins 用户ssh秘钥

 点击 Impersonate ,表示冒充jenkins 用户

gitlab + jenkins 持续集成

点击设置

gitlab + jenkins 持续集成

点击 ssh keys

gitlab + jenkins 持续集成

登录到jenkins服务器,生成秘钥

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

查看公钥

cat /root/.ssh/id_rsa.pub

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

gitlab + jenkins 持续集成

创建Access Tokens

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

gitlab + jenkins 持续集成

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

gitlab + jenkins 持续集成

点击退出

gitlab + jenkins 持续集成

重新登录root用户,点击test

gitlab + jenkins 持续集成

点击设置-成员

 gitlab + jenkins 持续集成

添加jenkins 用户,这样就可以访问项目了

gitlab + jenkins 持续集成

三、 jenkins 安装和Git,GitLab插件

由于 jenkins安装时,勾选了推荐安装的插件,因此包含了git插件。

现在只需要安装gitlab插件即可

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

勾选gitlab,点击直接安装

gitlab + jenkins 持续集成

等待十几分钟

gitlab + jenkins 持续集成

提示安装完成

gitlab + jenkins 持续集成

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

 gitlab + jenkins 持续集成

Connection Name ”随便填,“Git Host URL”填GitLab的访问地址,然后点“Add”——“jenkins”,如下所示:

gitlab + jenkins 持续集成

选择gitlalb api,输入 jenkins 用户创建的token Zzis8ALsiYuytsg2GH-5

gitlab + jenkins 持续集成

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

gitlab + jenkins 持续集成

 点击最下面的保存

gitlab + jenkins 持续集成

配置Git插件

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

 gitlab + jenkins 持续集成

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

gitlab + jenkins 持续集成

四、创建一个Jenkins Job

在jenkins里,一个任务叫做一个job。一般我们的项目会有多个分支,比如开发分支和产品分支,我们可以对每一个分支都新建一个job,比如,我们对开发分支创建一个测试的job,每次有代码提交就自动运行一次测试,对产品分支创建一个打包的job,每次有代码提交就运行打包任务。

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

首先,点击 新建Item,item name”可以随便起,然后点击“构建一个自由风格的软件项目”,点击Ok
gitlab + jenkins 持续集成

至此,创建一个Job成功了

由于 jenkins 服务器的ssh秘钥,已经添加到gitlab上面了。那么就可以进行下一步了!

配置Job的源码管理

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

gitlab + jenkins 持续集成

类型,选择 SSH Username with private key

Username 填 root

PrivateKey 选择Enter directly,点击add

gitlab + jenkins 持续集成

登录到jenkins 服务器,查看私钥

cat /root/.ssh/id_rsa

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

gitlab + jenkins 持续集成

在“credentials”里选择我们刚刚创建的认证方式:root

 gitlab + jenkins 持续集成

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

jenkins job默认对master分支进行构建,你也可以自定义分支。这要求你的Gitlab代码仓库中要存在这个分支,一般来说,就是要向代码仓库提交一次更改,请 自行完成(Gitlab项目刚创建时是空的,一个分支也没有,这样的话,自动构建时会出错)

gitlab + jenkins 持续集成

配置Job的构建触发器

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

gitlab + jenkins 持续集成

扩展阅读:

常见构建触发器、:

  • 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 等等)

gitlab + jenkins 持续集成

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

\cp -r $WORKSPACE /tmp/test

gitlab + jenkins 持续集成

点击 可用的环境变量列表,就可以看到很多变量

gitlab + jenkins 持续集成

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

由于git项目为test,因此路径为:/var/lib/jenkins/workspace/test

点击保存

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

gitlab + jenkins 持续集成

点击控制台输出,就可以看到完整的cp命令

gitlab + jenkins 持续集成

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

:~# 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

相关推荐