关于gitlab-ci自动化部署的一些探索

96
MarlonFan
2016.07.22 14:09* 字数 860

因为团队中想使用PHPCS来检查代码风格,所以考虑了两个方案.一个是基于GIT HOOKS的行为触发,一个是基于GITLAB-CI的一系列部署.考虑再三使用了gitlab-ci的解决方案.

了解gitlab-ci的运行机制.

要想使用gitlab-ci,首先要明白它的组成. 这个东西有两个东西来支撑:

  1. gitlab-ci server
  2. gitlab-ci-runner

gitlab-ci server负责调度、触发Runner,以及获取返回结果. 而gitlab-ci-runner则是主要负责来跑自动化CI的一个宿主机子.

那么我们总结一下流程,其实是这个样子的:

2016-07-22_13:48:39.jpg
2016-07-22_13:48:39.jpg

Runner的概念

runner可以想象成一个守护进程,来守护你注册好的servicegitlab-ci绑定. 一个宿主机里的runner可以维护多个不同的service. 而gitlab-ci在收到需要build的请求时,会通知service执行你在.gitlab-ci.yml里面指定好的脚本,然后根据命令行的返回结果来决定这次build的成功还是失败.

在了解完了这些概念以后我们就可以很轻松的搭建一个runner了.

GITLAB-CI搭配Runner的使用

安装Runner

  • 首先要找一台服务器来创建Runner,因为是要跟你的gitlab服务关联,所以服务器要可以访问你的gitlab服务。

  • 安装gitlab-CI-multi-runner

  • gitlab-ci-multi-runner是CI runner的运行程序,这里有多种安装方式(见这里),这里我们使用了第一种:在linux中安装软件。

友情提示: 在安装时由于网络问题不好安装,可以直接找到deb包下载后安装.

gitlab-ci-multi-runner命令介绍

  • 执行gitlab-ci-multi-runner help可以看到所有命令的简介,在每个命令加--help可以看到更加具体的参数,比如gitlab-ci-multi-runner start --help,命令的执行顺序为:register(注册runner)-->install(安装服务)-->start(运行服务).

GITLAB-CI配置

打开网址(比如你的gitlab服务地址是: http://gitlab.your.company/,那gitlab CI的地址就是:http://gitlab.your.company/ci),找到想要配置CI的项目,点击后面的按钮Add project to CI
,给项目配置CI功能.进入CI项目,进入Runners标签页面,可以看到CI的url和token,这2个值是待会用命令注册runner时所需要的。

runner的服务器上注册runner,执行命令gitlab-ci-multi-runner register --user="你的用户",下面是执行命令后的交互信息。

友情提示:如果你用的是docker的执行方式,可以先把对应的docker的image下载下来,不然第一次执行CI会比较慢。
  • 安装服务

执行命令gitlab-ci-multi-runner install -n "服务名",后面的服务名是自己定义的名称,用来后面启动命名使用,与其相对的命令是uninstall.

启动服务,执行命令gitlab-ci-multi-runner start -n "服务名",与其相类似的命令有stop
restart.

验证runner,执行gitlab-ci-multi-runner verify,可以看到runner的运行情况.

root@cloudeye:~# gitlab-ci-multi-runner verify

aliveINFO[0000] 79bf814a Veryfing runner... is 
aliveINFO[0000] 207a4b34 Veryfing runner... is 
aliveINFO[0000] 20f849f7 Veryfing runner... is 
aliveINFO[0000] 6e07e13a Veryfing runner... is
aliveINFO[0000] 23be6deb Veryfing runner... is 
aliveINFO[0000] 4e348964 Veryfing runner... is

启动服务后,可以在刚才的CI runners页面看到已经有runner出现了。

gitlab-ci.yaml文件

配置好了runner,要让CI跑起来,还需要在项目根目录放一个.gitlab-ci.yml文件,在这个文件里面可以定制CI的任务,下面是简单的示例文件,更多的用法可以看官方文档

jobName:
  script:
    - ls
    - php command.php
    ...(比喻,使用直接删掉本行)
  only:
    develp

自己磕磕碰碰总结出来的,有不对的地方希望可以指正.

技术
Web note ad 1