Clusters

A cluster is where your apps run. Provisioning is a thin, cost-aware facade over the platform — you express the shape, preview the €, and poll until it’s ready.

Pick a VPC

A VPC is a regional, tenant-isolated network; clusters in the same VPC talk to each other region-wide.

kubrain vpc create prod-net            # or let a standalone cluster use the default
kubrain vpc list

Create and reach a cluster

kubrain versions                        # selectable Kubernetes versions
kubrain regions                         # regions/zones with live capacity
kubrain estimate --tier ha --ram 8 --nodes 2     # €/month before committing
kubrain cluster create prod --vpc prod-net --tier ha --ram 8 --nodes 2 --k8s v1.30.2
kubrain cluster status prod             # poll until state = running

In MCP, create_cluster defaults to a dry-run that returns the full plan (node IPs, the public endpoint, cost) and applies nothing; run it for real, then poll get_cluster. The region is inherited from the VPC; ram is GiB per node (the billed dimension).

Tiers: dev (1 schedulable control plane — prototypes) · normal (1 dedicated control plane, 1+ workers) · ha (3 control planes across ≥3 zones — production). For anything you care about, choose ha: it tolerates node loss and rolls the control plane cleanly.

Get kubectl

kubrain cluster kubeconfig prod --output kubeconfig      # writes mode-0600 file
kubectl --kubeconfig kubeconfig get nodes                # until nodes are Ready

The kubeconfig’s server URL is a stable public endpoint, reachable immediately. Use kubectl to observe workloads; reach for a tool to change infrastructure.

Change a running cluster

All of these are async — poll cluster status until running again.

kubrain cluster scale   prod --workers 4      # add/remove worker nodes
kubrain cluster resize  prod --ram 16         # change per-node RAM (rolls the pool)
kubrain cluster upgrade prod --k8s v1.31.0    # control plane first, then workers
kubrain cluster reapply prod                  # re-render to pick up new platform features

scale, resize, and upgrade re-check your quota and host capacity and return a clear error if the change won’t fit. reapply re-applies the manifest unchanged and may roll the control plane once; shape and cost are unchanged.

Delete

kubrain cluster delete prod            # cascades to the VMs, frees the network block

Destructive — confirm first. Deleting also frees any LB IPs (their charge stops).