{"id":31199,"date":"2022-09-07T06:43:42","date_gmt":"2022-09-07T06:43:42","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=31199"},"modified":"2022-12-23T05:47:27","modified_gmt":"2022-12-23T05:47:27","slug":"gitlab-tutorials-understanding-about-config-toml-example-of-config-toml","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/gitlab-tutorials-understanding-about-config-toml-example-of-config-toml\/","title":{"rendered":"GitLab Tutorials: Understanding runner config.toml & Example of config.toml"},"content":{"rendered":"\n
The config.toml file is what configures a runner. You wouldn’t have one unless you’re running your own gitlab-runners, in which case it would be in \/etc\/gitlab\/config.toml on the host running the runner.<\/p>\n\n\n\n
You can change the behavior of GitLab Runner and of individual registered runners.<\/p>\n\n\n\n
To do this, you modify a file called config.toml, which uses the TOML format.<\/p>\n\n\n\n
GitLab Runner does not require a restart when you change most options. This includes parameters in the [[runners]] section and most parameters in the global section, except for listen_address. If a runner was already registered, you don\u2019t need to register it again.<\/p>\n\n\n\n
GitLab Runner checks for configuration modifications every 3 seconds and reloads if necessary. GitLab Runner also reloads the configuration in response to the SIGHUP signal.<\/p>\n\n\n\n
You can find the config.toml file in:<\/p>\n\n\n\n
\/etc\/gitlab-runner\/ on *nix systems when GitLab Runner is executed as root (this is also the path for service configuration)<\/li>
~\/.gitlab-runner\/ on *nix systems when GitLab Runner is executed as non-root<\/li>
A Docker container, but connect with SSH. The Docker container runs on the local machine. This setting changes how the commands are run inside that container. If you want to run Docker commands on an external machine, change the host<\/code> parameter in the runners.docker<\/code> section.<\/strong><\/td><\/tr>
ssh<\/code><\/td>
[runners.ssh]<\/code><\/td>
SSH, remotely.<\/td><\/tr>
parallels<\/code><\/td>
[runners.parallels]<\/code> and [runners.ssh]<\/code><\/td>
Parallels VM, but connect with SSH.<\/td><\/tr>
virtualbox<\/code><\/td>
[runners.virtualbox]<\/code> and [runners.ssh]<\/code><\/td>
VirtualBox VM, but connect with SSH.<\/td><\/tr>
docker+machine<\/code><\/td>
[runners.docker]<\/code> and [runners.machine]<\/code><\/td>