Kvindo™ Cloud Docs
A GitLab Runner is a dedicated VM that executes CI/CD jobs for one or more GitLab instances. It authenticates against each instance with that runner's own authentication token and runs jobs with the Docker executor. Runners scale independently of the GitLab instance they serve.
• GitLab instances — the instances to register with; each entry is a url plus a runnerToken you create for this runner inside that instance (spec.gitlabInstances)
• Concurrency — how many jobs run in parallel on this runner (spec.concurrency)
• Docker options — extra Docker executor settings as a JSON string (spec.dockerOptionsJsonString)
• Compute & storage — offer IDs size the VM (spec.vmOfferId) and data volume (spec.volumeOfferId, spec.volumeSizeGiB)
| UI Name | API / kc name | Terraform name | Optional | Format | Default | Is read only | Description |
|---|---|---|---|---|---|---|---|
| Tier | spec.tier |
spec.tier |
No | string | standard |
No | Reserved for future use — only standard is accepted today |
| GitLab instances | spec.gitlabInstances |
spec.gitlab_instances |
No | list of objects | — | No | Instances to register with |
| URL | gitlabInstances[].url |
gitlab_instances[].url |
No | string | — | No | Base URL of the GitLab instance |
| Runner token | gitlabInstances[].runnerToken |
gitlab_instances[].runner_token |
No | string (sensitive) | — | No | Authentication token (glrt-…) created for this runner in that instance — Admin → CI/CD → Runners → New instance runner. The legacy instance-wide registration token is not accepted |
| Concurrency | spec.concurrency |
spec.concurrency |
No | integer | — | No | Max jobs run in parallel |
| Version | spec.version |
spec.version |
Yes | string (≤16) | 15.11.0 |
No | Runner version; a pinned 15.11.0 is used if omitted. Must be a version the platform publishes — an unsupported one is rejected on create and on modify (the Console's picker lists them) |
| Docker options | spec.dockerOptionsJsonString |
spec.docker_options_json_string |
Yes | string (JSON, ≤1000) | — | No | Extra Docker executor options |
| VPC subnet | spec.vpcSubnetId |
spec.vpc_subnet_id |
Yes | ULID — references a VPC Subnet | — | No | Subnet the runner runs in |
| Floating IP | spec.floatingIpId |
spec.floating_ip_id |
Yes | ULID — references a Floating IP | — | No | Public address; omit for private-only access |
| VM offer | spec.vmOfferId |
spec.vm_offer_id |
Yes | string (≤32) — compute offer | — | No | VM compute offer |
| VM state | spec.vmState |
spec.vm_state |
Yes | string — running/stopped |
running |
No | Desired power state |
| Volume offer | spec.volumeOfferId |
spec.volume_offer_id |
No | string — disk offer | — | No | Data volume type |
| Volume size | spec.volumeSizeGiB |
spec.volume_size_gib |
No | integer — GiB | — | No | Data volume size |
A shared runner registered against one GitLab instance, running up to four jobs at a time.
Terraform
Python SDK
kc CLI
Resource docs
Examples