Kvindo™ Cloud Docs


Language

Kubernetes Cluster

A Kubernetes Cluster is a managed Kubernetes control plane for running containerized workloads. The platform provisions and maintains the control plane; you run workloads on worker nodes defined by one or more Node Groups. Access is managed through Kubernetes Users and User Roles.

Key concepts

• Version — the Kubernetes version to run (spec.version, e.g. 1.31.6) — a full X.Y.Z version is required

• Control-plane placement — one entry per subnet the control plane runs in (spec.controlPlaneLocations[].vpcSubnetId)

• Public API server — spec.assignPublicIpV4 exposes the API server on a public IPv4; leave it off for private-only access

• API server endpoint — the URL for kubectl is reported in status.apiServerUrl once the cluster is running

• Node Groups — worker capacity is added separately; a cluster with no Node Group has no place to schedule pods

• Node Group required before Users/Roles — create at least one Node Group with a nonzero node count before adding a Kubernetes User or User Role; a cluster with no worker capacity cannot successfully reconcile those resources

• Control-plane VM — each control-plane location runs on a dedicated VM (offer g3-2c8-100, 20 GiB volume); this is a real, billed VM like any other resource, not free platform overhead

Parameters
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
Version spec.version spec.version No string — Kubernetes version (full X.Y.Z) — No e.g. 1.31.6 — the only version offered today; a bare 1.31 fails to provision
Public API server spec.assignPublicIpV4 spec.assign_public_ipv4 Yes boolean false No Expose the API server on a public IPv4
Control-plane locations spec.controlPlaneLocations spec.control_plane_locations No list of objects — No Subnets the control plane runs in (immutable after creation)
VPC subnet controlPlaneLocations[].vpcSubnetId control_plane_locations[].vpc_subnet_id No ULID — references a VPC Subnet — No Subnet for a control-plane node (immutable after creation)
API server URL status.apiServerUrl status.api_server_url — string — Yes API server endpoint for kubectl
Examples

A cluster with a public API server on an existing subnet. Add a Node Group next to run workloads.

Terraform

Python SDK

kc CLI


Related pages

Resource docs

Examples

An unhandled error has occurred. Reload 🗙