Kvindo™ Cloud Docs
A Node Group is a pool of worker nodes in a Kubernetes cluster that share the same VM offer, disk, and network settings. A cluster can have several groups — for example a general-purpose group and a high-memory group. You set the node count directly; the group provisions that many identical VMs.
• Cluster — the parent cluster this group belongs to (spec.kubernetesId)
• Node count — how many worker nodes to run (spec.desiredNodeCount); change it to scale the group up or down
• Compute & storage — offer IDs size each node's VM (spec.vmOfferId) and data volume (spec.volumeOfferId, spec.volumeSizeGiB)
• Network — nodes run in spec.vpcSubnetId; spec.createPublicIpv4 gives each node a public IPv4
| UI Name | API / kc name | Terraform name | Optional | Format | Default | Is read only | Description |
|---|---|---|---|---|---|---|---|
| Cluster | spec.kubernetesId |
spec.kubernetes_id |
No | ULID — references a Cluster | — | No | Parent Kubernetes cluster |
| VPC subnet | spec.vpcSubnetId |
spec.vpc_subnet_id |
No | ULID — references a VPC Subnet | — | No | Subnet the nodes run in |
| Node count | spec.desiredNodeCount |
spec.desired_node_count |
No | integer | — | No | Number of worker nodes |
| Public IPv4 | spec.createPublicIpv4 |
spec.create_public_ipv4 |
Yes | boolean | false |
No | Give each node a public IPv4 |
| VM offer | spec.vmOfferId |
spec.vm_offer_id |
Yes | string — compute offer | — | No | Node VM compute offer — there is no server-side default, pass one explicitly |
| VM state | spec.vmState |
spec.vm_state |
Yes | string — running/stopped |
running |
No | Desired node power state |
| Volume offer | spec.volumeOfferId |
spec.volume_offer_id |
No | string — disk offer | — | No | Per-node data volume type |
| Volume size | spec.volumeSizeGiB |
spec.volume_size_gib |
No | integer — GiB | — | No | Per-node data volume size |
| Nodes | status.nodes |
status.nodes |
— | list of objects | — | Yes | The provisioned worker nodes |
| Public IPv4 | nodes[].publicIpV4 |
nodes[].public_ipv4 |
— | string | — | Yes | Set when nodes have a public IPv4 |
| Public IPv6 | nodes[].publicIpV6 |
nodes[].public_ipv6 |
— | string | — | Yes | Node public IPv6. IPv6 is not yet implemented — reserved for future use |
| Private IPv4 | nodes[].privateIpV4 |
nodes[].private_ipv4 |
— | string | — | Yes | Node address on the VPC subnet |
| Private IPv6 | nodes[].privateIpV6 |
nodes[].private_ipv6 |
— | string | — | Yes | Node private IPv6. IPv6 is not yet implemented — reserved for future use |
A three-node worker group on an existing cluster and subnet.
Terraform
Python SDK
kc CLI
Resource docs
Examples
More in this section