原创：小姐姐味道（微信公众号ID：xjjdog），欢迎分享，转载请保留出处。任何不保留此声明的转载都是抄袭。

“公司的代码资产，要放在公司内部。防止一切不可见的敌人，通过腐朽老套的方式，对公司的利益产生非法的侵占。”

SVN的年代，已经一去不复返，现在都用上了高大上的git。虽然有Gitea、Gogs这样更加轻量级的git代码托管平台，但目前应用最广泛的，还是gitlab。

搭建GitLab过程并没有想象中的简单，因为它是Ruby写的，又是依赖DB，又是依赖Redis，而且有权限要求。但这东西，也就折腾一次，剩下的就是享受它的功能了。

我们平常的开发中，不可或缺的有一些持续集成的需求。比起再部署一个jenkins，使用gitlab的CI功能，更加如丝般柔滑。

1. 一个样例

gitlab实现ci功能很简单，直接在仓库的顶层目录，创建一个.gitlab-ci.yml文件，就可以了。我们大多数的应用，就配置这样一个文件就OK了。

下面是一个vuepress项目的ci文件。

image: xjjdog.cn:5000/node:8.16.2pages:
  tags:- pages
  cache:paths:  - node_modules/

  script:- npm config set registry http://xjjdog.cn:8082/repository/npm-all/- npm install- npm run docs:build
  artifacts:paths:  - public
  only:- master复制代码

以上的脚本，将在每次提交代码到master的时候，自动触发执行。它将自动编译node项目，并发布到该发布的地方。

在左侧菜单，可以找到相关的菜单。

点击进入，可以看到执行的结果和操作人等等。码、包一体，是不是比jenkins更加直观？好用？

2. yaml文件

所以我们的工作内容，就全部集中到yaml文件的编写上。

你会发现，不论你是使用docker-compose，还是使用k8s，甚至是现在的Gitlab CI，你本质上，就是一个YAML工程师。

YAML工程师！是自动化时代先进生产力的代表。

我们来瞧一下.gitlab-ci.yml中的关键概念。其实从它身上，我们能够看到Makefile的一点影子。

• images/services 这个关键字可以使用Docker的镜像和服务运行Job
• only only是匹配的意思，比如上面只匹配master分支的提交和merge
• stages 一个stages可以定义多个分段，用于定义一个pipeline的不同流程节点（job）
• stage 表示一个stages的子项，一般用来给job定一个一个名字。比如，我们上面的pages，就是job的名字
• cache cache用来定义一些需要在任务之间进行缓存的目录和文件
• script 真正要执行的命令，可以是一个shell脚本。如果脚本执行不成功，流程就会终止
• before_script,after_script用来定义前置和后置脚本
• variables 自定义构建变量
• artifacts 将生成的资源作为pipeline运行成功的附件上传，并在gitlab交互界面上提供下载。如果你发布的是一个静态目录，比如vuepress编译后的结果，这个是最合适的。
• tags tags是Job的一个标记。

3. runner

这个tags是什么意思呢？当你第一次使用的时候，可能会因为它的配置错误，造成ci无法执行。

我们在左侧的菜单里面，找到全局的settings，里面也有一个CI/CD，其中有一个Runners选项，就是用来配置Runner锁关联的tag的。

也就是说，你需要安装一个叫做GitLab Runner的东西。它才是我们任务真正执行的节点。

安装完毕之后，需要执行 gitlab-runner register注册进来。只有你在看到下面字样的时候，才证明你的tags为pages的任务能够执行。

从上面的描述中，我们就可以看出来，这个gitlab-runner，是分布式的，我们可是利用空间的机器，部署多个runner。所以，不用担心会对原gitlab服务器造成压力。

End

任务执行时间太长，一直挂着占用资源怎么办？

可以使用timeout来设置过期时间。

JobName:
  script: restart
  timeout: 30m复制代码

为什么gitlab可以作为一个比较理想的CI平台呢？

因为在它之上，有最原始的代码。有持续集成工具。有Wiki，甚至想要更高级的Pages，也有。

对于一个git项目来说，可以说你想要的，它都有了。而且所有的变更，都可以在一个普通的.gitlab-ci.yml文件里进行变更。可以说gitlab是一个十分锋利的工具了。

事实上，为了让操作更加柔滑，我们使用了gitlab的rest api。通过配置相应的token，就可以使用Java代码，控制gitlab的所有行为。

把它集成在自己公司的工具库里面，感觉是非常棒的。

作者简介：小姐姐味道  (xjjdog)，一个不允许程序员走弯路的公众号。聚焦基础架构和Linux。十年架构，日百亿流量，与你探讨高并发世界，给你不一样的味道。我的个人微信xjjdog0，欢迎添加好友，进一步交流。

xjjdog.cn 对200+原创文章进行了细致的分类，阅读更流畅，欢迎收藏。