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

orl kubernetes cluster update

Update a Kubernetes cluster (asks for confirmation; --yes to skip), part of the orl CLI for OpenRelay GPU VMs, pods, batches and billing.

orl kubernetes cluster update <id>

Replaces the cluster's API server sources and sets or clears its externalClusterIPAccess, together or not at all, and answers 202 with the cluster. The API server sources are the networks the cluster's API endpoint answers besides its own nodes and the platform. The gateway applies the new list within a few minutes, and the cluster's conditions report the change until it does; a cluster still creating stays creating, and mints no credential, until then. A change cuts the connections a removed network holds on the endpoint. A null externalClusterIPAccess clears the cluster's setting, so it runs the value its managed add-ons carry. A change of the value the cluster runs, by a new setting or a cleared one, restarts the cluster's Cilium agents, all at once on a cluster whose traffic between nodes is encrypted and two nodes at a time on one whose encryption waits for its nodes (NodeEncryptionPending); a restart that stops progressing for 10 minutes sets the AddonsFailed condition with reason AgentRollStalled until it completes. A body that changes nothing answers 202 and writes nothing. A cluster that is failed or deleting answers 409 INVALID_CLUSTER_STATE, a list with an entry that is not an IPv4 network 400 INVALID_API_SERVER_SOURCES, an externalClusterIPAccess value the cluster's add-ons cannot apply yet 409 SETTING_UNSUPPORTED, and an expectedApiServerSources that differs from the cluster's list 409 CONCURRENT_UPDATE. A legacy API key needs clusters:write.

Flags

FlagTypeRequired
--api-server-sources[]stringnoThe cluster's new API server sources, replacing the list it holds. A list naming 0.0.0.0/0 admits any source. Absent leaves the list as it is. A change cuts the connections a removed network holds on the endpoint.
--expected-api-server-sources[]stringnoOptional list the caller reviewed, compared with the cluster's list as a set, ["0.0.0.0/0"] standing for any source. If they differ, answers 409 CONCURRENT_UPDATE without changing anything, so a change made since the review is not undone. The comparison and write are atomic.
--external-cluster-ip-accessbool or null (--external-cluster-ip-access=null)noWhether a ClusterIP answers packets that enter a node from outside the cluster. Absent leaves the setting as it is, and null clears it, so the cluster runs the value its managed add-ons carry. A change of the value the cluster runs restarts its Cilium agents: all at once on a cluster whose traffic between nodes is encrypted, two nodes at a time on one whose encryption waits for its nodes (NodeEncryptionPending).
--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)
--yesboolnoskip the confirmation prompt
--forceboolnoalias for --yes

This wraps the updateKubernetesCluster API operation.

On this page