The config.toml
file in the config repository is used to control the deployment of runners.
Specification
The options available are specific to runner type.
Default
When applicable the defaults strike a balance between compatibility with Gitlab.com hosted runners, requiring explicit user configuration to incur additional costs, and providing a quality default experience. Therefore, the defaults do not represent the most performant configuration, but are generally expected to work without any adjustments to an existing CI setup.
Multiple
Multiple runners can be configured within a single account, but will operate completely independent of one another. All will share the account credit.
[[gitlab.enhanced.runner]]
token = "runner1"
api_token = "api"
[[gitlab.enhanced.runner]]
token = "runner2"
api_token = "api"
[[gitlab.basic.runner]]
token = "runner3"
Disable
An account can effectively be disabled by removing all runner configurations, but a subscription must be canceled through the Stripe portal.
YAML
If preferred, YAML can be used by changing the extension to .yaml
and reformating the file.