After registering, a git repository for configuration will be accessible.
Clone
Replace {username}
with the value provided during registration and clone the repository.
git clone git@api.cedarci.com:u/{username}/config
Tokens
The cloned repository will contain a commented out template configuration in config.toml
. Edit the file to provide, at
minimum, the required values token
and api_token
.
[[gitlab.enhanced.runner]]
token = "glrt-J3MyWt1GhsR2Rw3nvEcL"
api_token = "glrt-J3MyWt1GhsR2Rw3nvEcL"
See the config file documentation for a complete reference of available options.
Apply
To apply your configuration, commit and push the config.toml
changes.
git commit -a
git push
During the push, the configuration will be validated and applied.
remote: Loading context...
remote: Validating push...
remote: - 6ce13484: Upgrade our CI to save engineer time.
remote: Validating config...
remote: - gitlab.enhanced.runner[0]:
remote: > Testing runner token connectivity...
remote: > Testing API token connectivity...
remote: Applying config...
remote: - gitlab.enhanced.runner[0]: Created
remote: Completed successfully!
See verification documentation for an explanation on how to check that the runner is connected properly. An enhanced runner should start almost immediately, while a basic runner will take around 3 minutes for initial creation.
Update
To make adjustments commit and push again.
Fingerprint
The ED25519 key fingerprint is: SHA256:VTDH0GtrrCyKvtnPS7u3qs+ZRQ2tOI3adcQdlV9k4VA
.
Add the following entry to ~/.ssh/known_hosts
to trust prior to connection:
api.cedarci.com ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIL76Vgd9/HpZY4e5THWZKEgjifJJQImnWYCie7ZfrjY7