配置参数
配置默认在 /etc/gitlab-runner/config.toml 下，配置文件更改时不需要重启服务，每隔三秒GitLab Runner 会检查配置修改，并重新加载。
全局配置
| 配置项 |
描述 |
| concurrent |
限制可以同时运行的作业数量 |
| log_level |
日志级别 |
| log_format |
日志格式 |
| check_interval |
检查新作业的间隔长度，默认为3秒 |
| sentry_dsn |
启用Sentry错误跟踪 |
| listen_address |
http服务监听地址 |
[session_server]
| 配置项 |
描述 |
| listen_address |
会话服务器的内部 URL |
| advertise_address |
访问会话服务器的 URL |
| session_timeout |
作业完成后会话可以保持活动状态的秒数，默认值为1800秒 |
[[runners]]
| 配置项 |
描述 |
| name |
描述 |
| url |
GitLab 实例 URL |
| token |
runner的的特殊令牌（不是注册令牌） |
| tls-ca-file |
使用 HTTPS 时验证对等方的证书的文件 |
| tls-cert-file |
使用 HTTPS 时与对等方进行身份验证的证书的文件 |
| tls-key-file |
使用 HTTPS 时要与对等方进行身份验证的私钥的文件 |
| limit |
限制同时处理作业数量，0（默认）表示不限制 |
| executor |
选择应如何构建项目 |
| shell |
生成脚本的 shell 的名称，默认值取决于平台。 |
| builds_dir |
构建存储在所选执行程序上下文中的目录的绝对路径。例如，本地、Docker 或 SSH。 |
| cache_dir |
构建缓存存储在所选执行程序上下文中的目录的绝对路径。例如，本地、Docker 或 SSH。如果使用dockerexecutor，则需要在其volumes参数中包含该目录 |
| environment |
追加或覆盖环境变量。 |
| request_concurrency |
限制来自 GitLab 的新作业的并发请求数，默认为1 |
| output_limit |
最大构建日志大小，默认值为4096(4MB) |
| pre_clone_script |
在克隆 Git 存储库之前执行的命令 |
| pre_build_script |
在克隆 Git 存储库之后但在执行构建之前执行的命令 |
| post_build_script |
在执行构建之后执行的命令 |
| clone_url |
覆盖 GitLab 实例的 URL |
| debug_trace_disabled |
禁用CI_DEBUG_TRACE特性。当设置为true时，即使用户将CI_DEBUG_TRACE设置为true，调试日志(跟踪)也将保持禁用状态 |
| referees |
额外的工作，将结果作为工作工件传递给 GitLab |
例子：
[[runners]]
name = "ruby-2.6-docker"
url = "https://CI/"
token = "TOKEN"
limit = 0
executor = "docker"
builds_dir = ""
shell = ""
environment = ["ENV=value", "LC_ALL=en_US.UTF-8"]
clone_url = "http://gitlab.example.local"
executors
| 执行者 |
所需配置 |
作业运行 |
| shell |
|
默认执行器 |
| docker |
[runners.docker] and Docker Engine
|
docker容器 |
| docker-windows |
[runners.docker] and Docker Engine
|
Windows Docker 容器 |
| docker-ssh |
[runners.docker], [runners.ssh], 和Docker 引擎
|
Docker 容器，使用 SSH 连接 |
| ssh |
[runners.ssh] |
远程SSH |
| parallels |
[runners.parallels] 和 [runners.ssh] |
Parallels VM，使用 SSH 连接 |
| virtualbox |
[runners.virtualbox] 和 [runners.ssh] |
VirtualBox VM，但使用 SSH 连接 |
| docker+machine |
[runners.docker] 和 [runners.machine] |
类似docker，但使用自动缩放的 Docker 机器
|
| docker-ssh+machine |
[runners.docker] 和 [runners.machine] |
类似docker-ssh，但使用自动缩放的 Docker 机器
|
| kubernetes |
[runners.kubernetes] |
Kubernetes pods |
[runners.docker] 部分
| 配置项 |
描述 |
| allowed_images |
可以在.gitlab-ci.yml文件中指定的镜像的通配符列表；如果不存在，则允许所有镜像（相当于["/:*"]） |
| allowed_services |
可以在.gitlab-ci.yml文件中指定的服务的通配符列表；如果不存在，则允许所有镜像（相当于["/:*"]） |
| cache_dir |
缓存目录，此路径可以是绝对路径，也可以是路径 |
| cap_add |
向容器添加额外的 Linux 功能 |
| cap_drop |
从容器中删除其他 Linux 功能 |
| cpuset_cpus |
对照组的CpusetCpus |
| cpu_shares |
用于设置相对 CPU 使用率的 CPU 份额数，默认为1024 |
| cpus |
CPU 数量（在 Docker 1.13 或更高版本中可用） |
| devices |
与容器共享其他主机设备 |
| disable_cache |
Docker 执行器有两个级别的缓存：全局缓存和基于 Docker 卷的本地缓存，此配置标志仅作用于禁用自动创建（未映射到主机目录）缓存卷的本地配置标志 |
| disable_entrypoint_overwrite |
禁用镜像覆盖entrypoint |
| dns |
供容器使用的 DNS 服务器列表 |
| dns_search |
DNS 搜索域列表 |
| extra_hosts |
应该在容器环境中定义的主机 |
| gpus |
Docker 容器的 GPU 设备使用与dockercli相同的格式查看Docker 文档中的详细信息 |
| helper_image |
（高级）用于克隆存储库和上传工件的默认帮助程序镜像
|
| helper_image_flavor |
设置辅助镜像风格（alpine或ubuntu）默认为alpine. |
| host |
自定义 Docker 端点默认为DOCKER_HOST环境或unix:///var/run/docker.sock. |
| hostname |
Docker 容器的自定义主机名 |
| image |
用于运行作业的镜像 |
| links |
应与运行作业的容器链接的容器 |
| memory |
内存限制 |
| memory_swap |
总内存限制 |
| memory_reservation |
内存软限制 |
| network_mode |
将容器添加到自定义网络 |
| oom_kill_disable |
如果发生内存不足 (OOM) 错误，不终止容器中的进程 |
| oom_score_adjust |
OOM 分数调整阳性意味着更早杀死 |
| privileged |
使容器以特权模式运行不安全 |
| pull_policy |
镜像拉取策略：never，if-not-present或always（默认）查看拉取策略文档中的详细信息您还可以添加多个拉取策略
|
| runtime |
Docker 容器的运行时 |
| security_opt |
安全选项（–security-opt in docker run）获取:分隔键/值的列表 |
| shm_size |
镜像的共享内存大小（以字节为单位） |
| sysctls |
sysctl选项 |
| tls_cert_path |
存储 ca.pem、cert.pem 或 key.pem 的目录，用于与 Docker 建立安全的 TLS 连接。在 boot2docker 中很有用。 |
| tls_verify |
启用或禁用对 Docker 守护程序连接的 TLS 验证，默认禁用 |
| userns_mode |
启用用户命名空间重新映射选项时，容器和 Docker 服务的用户命名空间模式，在 Docker 1.10 或更高版本中可用 |
| volumes |
安装挂载卷与 Docker-v标志的语法相同 |
| volumes_from |
从另一个容器继承挂载卷，访问级别默认为读写，但可以手动设置为ro（只读）或rw（读写） |
| volume_driver |
用于容器的挂载卷驱动程序 |
| wait_for_services_timeout |
等待 Docker 服务的时间设置0为禁用默认为30 |
例子：
[runners.docker]
host = ""
hostname = ""
tls_cert_path = "/Users/ayufan/.boot2docker/certs"
image = "ruby:2.6"
memory = "128m"
memory_swap = "256m"
memory_reservation = "64m"
oom_kill_disable = false
cpuset_cpus = "0,1"
cpus = "2"
dns = ["8.8.8.8"]
dns_search = [""]
privileged = false
userns_mode = "host"
cap_add = ["NET_ADMIN"]
cap_drop = ["DAC_OVERRIDE"]
devices = ["/dev/net/tun"]
disable_cache = false
wait_for_services_timeout = 30
cache_dir = ""
volumes = ["/data", "/home/project/cache"]
extra_hosts = ["other-host:127.0.0.1"]
shm_size = 300000
volumes_from = ["storage_container:ro"]
links = ["mysql_container:mysql"]
allowed_images = ["ruby:*", "python:*", "php:*"]
allowed_services = ["postgres:9", "redis:*", "mysql:*"]
[[runners.docker.services]]
name = "registry.example.com/svc1"
alias = "svc1"
entrypoint = ["entrypoint.sh"]
command = ["executable","param1","param2"]
[[runners.docker.services]]
name = "redis:2.8"
alias = "cache"
[[runners.docker.services]]
name = "postgres:9"
alias = "postgres-db"
[runners.docker.sysctls]
"net.ipv4.ip_forward" = "1"
更多配置项
https://docs.gitlab.com/runner/configuration/advanced-configuration.html
