搭建自己的GitLab CI Runner 运行Laravel测

本文操作目标：搭建GitLab以及使用GitLab的CI Runner服务，对项目进行测试。
操作过一次，才知道并非想像中的那么复杂，也没有像想中的那么简单。

准备工作：

Centos7机器，2台。 一台安装GitLab和Runner，一台用来充当Runner的操作机。

Docker安装

GitLab功能十在是太丰富，安装的服务太多。服务器资源紧缺，所以一台服务器上用Docker来做安装测试喽。

Docker的安装及基础使用，本章不做阐述。

GitLab安装

从Gitblit转移至GitLab，发现其复杂度真不是一个数量级的。如果不需要在源码上做很多服务，还是Gitblit用的随心。
使用Docker安装GitLab，找了一个9.x的中文版

$ docker pull docker.io/twang2218/gitlab-ce-zh
$ docker images
docker.io/twang2218/gitlab-ce-zh   latest              b8165a7e3d68        3 months ago        1.39 GB
$ docker run --detach \
--hostname 192.168.1.8 \
--publish 8082:8082 --name gitlab9 \
--restart always \
--volume /home/gitlab:/var/opt/gitlab/git-data \
docker.io/twang2218/gitlab-ce-zh
$ docker ps

这里有一点要说明，端口映射，写的是8082到8082，就是说访问物理主机（192.168.1.8）的8082端口，相当于访问docker主机的8082端口。
但是GitLab默认的服务端口是80，要下入docker主机，改一下配置。

# 进入docker主机的ssh
$ docker exec -it gitlab9 /bin/bash

# 修改 /etc/gitlab/gitlab.rb
bash: warning: setlocale: LC_ALL: cannot change locale (en_US.UTF-8)
root@192:/# vim /etc/gitlab/gitlab.rb

#修改项目
external_url 'http://192.168.1.8:8082'

应用配置更新

gitlab-ctl reconfigure

雷点：直接重启GitLab服务，配置是不会更新的

此时，访问 http://192.168.1.8:8082，基本是OK的了。更新密码，创建项目之流，基本不需要指导

.gitlab-ci.yml

资料显示，GitLab8之后的版本，默认集成，并启用了GitLabCI，所以无需额外的任何配置。还是亲儿子营养多。
唯一的要求，就是你的项目代码里，必须有一个叫.gitlab-ci.yml的文件。使用GitLab管理后台，可以添加文件，添加时可以选择对应的模板文件，还是很贴心的。有如下图示：

.gitlab-ci.yml文件

文件大概的内容，就是一堆任务，包构建命令（能够把项目需要的环境构建出来，以便运行测试）测试命令，及其它你想执行的命令。
这里直接使用Laravel模板。然后需要针对自己的系统，对脚本微调：

1. apt-get替换成yum。因为我的目标机是centos7
2. 删除docker相关的内容。因为我的目标操作机没有安装docker，是一个台空白机
3. 将 https 替换成 http
4. 增加tags laravel，（很重要）增加完如下

test:
  # 下两行 很重要
  tags:
    - laravel
  script:

  # 进入后台项目目录
  - cd backend

  # run laravel tests
  - php vendor/bin/phpunit --coverage-text --colors=never 

脚本的任何错误，将造成任务运行失败

GitLab管理端，也可以看到此文件的语法检查

语法检查

CI Runner 安装 注册

先说一下大致流程：
1，安装runner
2，runner注册到 GitLab
3，当代码提交后，GitLab根据 .yml的配置，通知runner，起来，干活啦
4，runner收到任务，开始执行作业
5，GitLab接收并显示 runner 的运行结果

CI Runner的安装，依然使用Docker的方式

GitLab Runner 官方安装指南

无脑执行

$ docker pull gitlab/gitlab-runner:latest
$ docker run -d --name gitlab-runner --restart always \
  -v /srv/gitlab-runner/config:/etc/gitlab-runner \
  -v /var/run/docker.sock:/var/run/docker.sock \
  gitlab/gitlab-runner:latest

下面开始实施注册

1，首先需要在GitLab的后台，找到接收runner注册的页面，如下图指引：

设置--流水线

简单一点，我们搞一个特定的Runners，页面内会提供注册需要的url和密钥

2，执行注册命令
需要进入运行runner的docker主机，执行相关命令，过程如下：

# 进入docker主机的shell
$ docker exec -it gitlab-runner  /bin/bash
# 注册命令
root@94652dec6e02:/# gitlab-ci-multi-runner register
Running in system-mode.

Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):
http://192.168.1.8:8082/
Please enter the gitlab-ci token for this runner:
zQRBTAAmh1Zc9BxU6G61
Please enter the gitlab-ci description for this runner:
[94652dec6e02]: just for test
Please enter the gitlab-ci tags for this runner (comma separated):
laravel
Whether to run untagged builds [true/false]:
[false]:
Whether to lock the Runner to current project [true/false]:
[true]:
Registering runner... succeeded                     runner=zQRBTAAm
Please enter the executor: docker-ssh+machine, kubernetes, docker, docker-ssh, shell, ssh, parallels, virtualbox, docker+machine:
ssh
Please enter the SSH server address (e.g. my.server.com):
192.168.1.4
Please enter the SSH server port (e.g. 22):
Please enter the SSH user (e.g. root):
xx
Please enter the SSH password (e.g. docker.io):
xx
Please enter path to SSH identity file (e.g. /home/user/.ssh/id_rsa):

Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

其中的 tags 非常重要。 要和 .yml文件中的tags一致，否则会出来诸如“未找到有效的Runner”等错误提示，使流水线作业搁置

可以检查本地注册情况

# gitlab-runner list
Listing configured runners                          ConfigFile=/etc/gitlab-runner/config.toml
first test                                          Executor=ssh Token=e23c4a3320a90c3e81074de0f87fdc URL=http://192.168.1.8:8082/
just for test                                       Executor=ssh Token=7ff71f37a5c9b108dbcb2234b574f2 URL=http://192.168.1.8:8082/

然后不要忘记，要启动runner服务

# gitlab-runner start

这里我选择了ssh的方式。此方式相当于给runner找一个『肉机』去跑项目的集成测试代码。其它方式待研究

同时，注册成功之后，GitLab管理后台，也可以看到注册信息

image.png

测试

文行致此，已万事俱备
push你的代码至版本库，GitLabCI即开始工作，如果你想看到绿色的成功图标，根据提示一步一步调试你的 .yml脚本吧

全是失败

文章写的比较仓促，主要用以记录一次CI之旅。如有运行不通，请与交流

比持续集成更重要的，是你首先要在你的项目里写好各类测试，提高测试的覆盖率，写好从源码到可运行测试的构建脚本，然后再寻求可自动化的方法

参考博文
使用Gitlab-Runner Docker 构建 node 项目
Docker搭建自己的Gitlab CI Runner
使用docker运行gitlab服务
GitLab-CI 从安装到差点放弃