Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
CLICommands

orl kube cluster create

Create a Kubernetes cluster, part of the orl CLI for OpenRelay GPU VMs, pods, batches and billing. Usage, every flag and an example.

orl kube cluster create --location-id <location-id> --name <name>

Starts creating a cluster with a managed control plane in one data center and answers 202 with its id; poll getKubernetesCluster for its status. Node pools in the request are added once the control plane is ready; add more later with createKubernetesNodePool. A cluster's name is unique within the organization: a create with the name of one of its clusters answers 409 NAME_TAKEN until that cluster's deletion completes. An organization has a configured limit on clusters creating at once; a create at that limit answers 409 TOO_MANY_CLUSTERS_CREATING until one of them leaves creating. A create that meets a concurrent change to the organization answers 409 CONCURRENT_UPDATE; retry it. A legacy API key needs clusters:write.

Flags

FlagTypeRequired
--kubernetes-versionv1.37.1noKubernetes version. v1.37.1 is the only supported version, and a cluster is not upgraded in place.
--location-idstringyesThe data center for the cluster's nodes, one of listLocations.
--namestringyes
--node-poolsjsonnoNode pools to add once the control plane is ready, each as createKubernetesNodePool takes it.
--bodystringnoa JSON object of request body fields, merged under any of this command's own flags that are also set, e.g. {"key":"value"}
--body-filestringnoread the --body JSON object from a file (- for stdin)

This wraps the createKubernetesCluster API operation.

On this page