Runner
Runner就像一个个的工人,而Gitlab-CI就是这些工人的一个管理中心,所有工人都要在Gitlab-CI里面登记注册,并且表明自己是为哪个工程服务的。当相应的工程发生变化时,Gitlab-CI就会通知相应的工人执行软件集成脚本。如下图所示:
gitlab里面的runner叫Gitlab-Runner
,Gitlab-Runner是配合Gitlab-CI进行使用的。一般地,Gitlab里面的每一个工程都会定义一个属于这个工程的软件集成脚本,用来自动化地完成一些软件集成工作。当这个工程的仓库代码发生变动时,比如有人push了代码,GitLab就会将这个变动通知Gitlab-CI。这时Gitlab-CI会找出与这个工程相关联的Runner,并通知这些Runner把代码更新到本地并执行预定义好的执行脚本(也就是在Job执行流程
那个图中所示的第三步:script),所以,Gitlab-Runner就是一个用来执行软件集成脚本script
的东西。
Runner类型
Gitlab-Runner可以分类两种类型:Shared Runner(共享型)和Specific Runner(指定型)。
- Shared Runner:这种Runner(工人)是所有工程都能够用的。只有系统管理员能够创建Shared Runner。
- Specific Runner:这种Runner(工人)只能为指定的工程服务。拥有该工程访问权限的人都能够为该工程创建Shared Runner。
什么情况下需要注册Shared Runner?
- 比如,GitLab上面所有的工程都有可能需要在公司的服务器上进行编译、测试、部署等工作,这个时候注册一个Shared Runner供所有工程使用就很合适。
什么情况下需要注册Specific Runner?
- 比如,我可能需要在我个人的电脑或者服务器上自动构建我参与的某个工程,这个时候注册一个Specific Runner就很合适。
Runner搭建
1、linux操作系统,安装docker环境。(如果安装了devops,docker环境可以不用安装)
2、安装gitlab-runner
1. Runner 安装
在GitLab Runner 10
之前,gitlab-runner的名称叫gitlab-ci-multi-runner
,安装命令如下
1 |
|
在GitLab Runner 10
及其以上,可执行文件已重命名为gitlab-runner
。
linux系统,可以通过以下命令安装
1 | # For Debian/Ubuntu/Mint |
如果要安装特定版本的GitLab Runner:
1 | # for DEB based systems |
授予其执行权限:
1 | sudo chmod +x /usr/local/bin/gitlab-runner |
创建一个GitLab CI用户:
1 | sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash |
安装并作为服务运行:
1 | sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner |
2. 获取Runner注册Token
安装好Runner之后,需要向Gitlab进行注册,注册Runner需要GitLab-CI的url和token。可根据需求注册选择所需类型Runner。这里介绍spercific runners为例
图中的Url和Token是runner链接到仓库的两个重要参数
3.runner配置
执行注册runner的命令(如果你是安装的gitlab-ci-multi-runner
):sudo gitlab-ci-multi-runner register
执行注册runner的命令(如果你是安装的gitlab-runner
):sudo gitlab-runner register
接下来会提示你输入一系列配置内容
注意,在要求输入
tag
时,想好tag的名字,这个就相当于你的runner的id
1 | ## 输入url |
注册完成后,会出现一个runner,我这里注册了两个,所以会有两个tag
runner 左边会有一个
小绿点
,表示该runner是能正常执行的
Gitlab-runner的配置
GitLab-CI会为这个Runner生成一个唯一的token,以后Runner就通过这个token与GitLab-CI进行通信。
那么,问题来了。注册好了的Runner的信息存放在哪儿了呢?
原来,Runner的信息是存放在一个配置文件里面的,配置文件的格式一般是.toml。这个配置文件的存放位置有以下几种情况:
- 在类Unix操作系统下(0.5.0之后版本)
- 如果是以root用户身份运行gitlab-runner register,那么配置文件默认是/etc/gitlab-runner/config.toml
- 如果是以非root用户身份运行gitlab-runner register,那么配置文件默认是~/.gitlab-runner/config.toml
- 在其他操作系统下以及0.5.0之前版本
配置文件默认在当前工作目录下./config.toml
一般情况下,使用默认的配置文件存放Runner的配置信息就可以了。当然,如果你有更细化的分类需求,你也可以在注册的时候通过-c或–config选项指定配置文件的位置。具体查看register命令的使用方法:gitlab-runner register --help
。
问题:如果不运行gitlab-runner register
命令,直接在配置文件里面添加Runner的配置信息可以吗?
回答:当然不可以。因为gitlab-ci-runner register的作用除了把Runner的信息保存到配置文件以外,还有一个很重要的作用,那就是向GitLab-CI发出请求,在GitLab-CI中登记这个Runner的信息并且获取后续通信所需要的token。
让注册好的Runner运行起来
Runner注册完成之后还不行,还必须让它运行起来,否则它无法接收到GitLab-CI的通知并且执行软件集成脚本。怎么让Runner运行起来呢?gitlab-runner提供了这样一条命令gitlab-runner run-single
以上的就是在linux机器上直接安装runner的过程,关于gitlab ci怎么使用runner执行我们想要执行的任务,可参考这篇文章:
使用docker安装gitlab runner:Gitlab Runner的容器化安装与使用
更多精彩内容:mrxccc