GitLab-CI(三):配置 GitLab-Runner
本文针对 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 处于空闲状态,也不会被使用。