本文针对 GitLab-Runner 的配置进行讲解说明。

GitLab-CI 系列文章目前有三篇,主要讲解 GitLab-CI 的环境搭建与配置。本文为该系列的第三篇。

目录:

config.tom 文件配置

在终端内输入 gitlab-runner list 命令,获取到 config.toml 文件路径,后续将针对该文件进行讲解说明。

concurrent

该文件顶部的 concurrent 字段意味着本台机器最多可以同时运行的作业数量。

请根据需求与 CI 机器的性能修改该字段。
例如 concurrent = 2 意味着 “该台电脑同一时间只能运行2个作业”。考虑到实际情况(一个作业对应一个打包任务),即同一时间内只能同时打2个包。

建议8g内存的机器将该值设置为2,以上内存的机器可将该值设置为4。

runners

name

即注册 Runner 时填写的 description,可通过修改该值达到修改 Runner 名称的目的。
在下文介绍的描述中,也可修改。

在 GitLab - CI/CD 界面配置

找到群组/项目左侧导航栏最下方的设置按钮,依次选择 “设置(Settings) -> CI/CD -> Runners”,进入 Runner 设置页面。
找到需要编辑/配置的 Runner,点击右侧铅笔形状的 “编辑按钮”,进入编辑页面。

启用

通过勾选取消勾选该选项,可开启/关闭该 Runner,被关闭的 Runner 将无法接收新的任务。

描述

即注册 Runner 时填写的 description,可通过修改该值达到修改 Runner 名称的目的。

最大作业超时

可设置任务超时时间。

超时时间有3种:

  • Runner 处配置的超时时间,即此处配置的超时时间。优先级最高
  • Git 项目的超时时间,可在 “设置(Settings) -> CI/CD -> 流水线通用设置” 处进行设置。优先级最低。
  • 任务的超时时间,在具体的 .yml 文件中设置。优先级居中

例如:

  • Runner 配置了 2小时 超时
  • 该 git 项目配置了 1小时 超时
  • 所要执行的任务配置了 1.5小时 超时
    则使用该 Runner 执行的任务的最终超时时间为 1.5 小时

标签

可配置该 Runner 可接收的任务的标签。一个 Runner 可以设置多个标签,之间用 , 号进行分割。
只有当 Runner 的标签列表包含将要执行的任务的标签时,才会选择该 Runner 去执行这个任务。否则即使该 Runer 处于空闲状态,也不会被使用。