Kvindo™ Cloud Docs
A GitLab Runner is a dedicated VM that executes CI/CD jobs for one or more GitLab instances. It registers itself using a runner token from each instance 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 obtained from 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 | Registration token from that instance |
| 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 |
| 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