clouder kubernetes

Manage Kubernetes clusters — create clusters, manage node pools, and configure kubeconfig.

Commands

clouder kubernetes create

Create a Kubernetes cluster.

clouder kubernetes create <name>

Argument	Description
name (required)	Name for the Kubernetes cluster

Example:

clouder kubernetes create my-cluster

This creates an OVH Managed Kubernetes cluster in the active OVH project context.

---

clouder kubernetes ls

List Kubernetes clusters.

clouder kubernetes ls

Shows all clusters managed by Clouder in the current context.

---

clouder kubernetes kubeconfig

Download the kubeconfig for a Kubernetes cluster.

clouder kubernetes kubeconfig <name>

Argument	Description
name (required)	Cluster name

Example:

clouder kubernetes kubeconfig my-cluster

Downloads the kubeconfig file and saves it locally.

---

clouder kubernetes use

Set a cluster's kubeconfig as the default kubectl context.

clouder kubernetes use <name>

Argument	Description
name (required)	Cluster name

Example:

clouder kubernetes use my-cluster

# Verify
kubectl get nodes

---

clouder kubernetes create-nodepool

Create a node pool in a Kubernetes cluster.

clouder kubernetes create-nodepool <cluster_name> <nodepool_name> [OPTIONS]

Argument	Description
cluster_name (required)	Cluster to add the node pool to
nodepool_name (required)	Name for the new node pool

Option	Short	Default	Description
--flavor	-f	b2-15	Node flavor / VM size
--min		3	Minimum number of nodes
--desired		3	Desired number of nodes
--max		10	Maximum number of nodes
--roles			Comma-separated role names
--variant		default	Variant for the pool
--xpu		cpu	Compute type: cpu, gpu-cuda, qpu

Examples:

# System node pool
clouder kubernetes create-nodepool my-cluster \
    system --flavor Standard_D4s_v5 \
    --min 1 --desired 2 --max 10 \
    --roles system --xpu cpu

# GPU node pool for Jupyter
clouder kubernetes create-nodepool my-cluster \
    jupyter-gpu --flavor Standard_NC6s_v3 \
    --min 0 --desired 1 --max 5 \
    --roles jupyter --variant medium --xpu gpu-cuda

# CPU node pool for Jupyter
clouder kubernetes create-nodepool my-cluster \
    jupyter-cpu --flavor Standard_B4ms \
    --min 0 --desired 3 --max 10 \
    --roles jupyter --variant small --xpu cpu

---

clouder kubernetes update-nodepool

Update a node pool in a Kubernetes cluster (e.g., scale up or down).

clouder kubernetes update-nodepool <cluster_name> <nodepool_name> [OPTIONS]

Argument	Description
cluster_name (required)	Cluster name
nodepool_name (required)	Node pool name

Option	Default	Description
--min	3	Minimum nodes
--desired	3	Desired nodes
--max	10	Maximum nodes

Examples:

# Scale down to zero (cost saving)
clouder kubernetes update-nodepool my-cluster \
    jupyter-gpu --min 0 --desired 0 --max 5

# Scale up
clouder kubernetes update-nodepool my-cluster \
    system --min 2 --desired 4 --max 10

---

Example: Full Cluster Workflow

# Requires OVH context
clouder ctx set ovh <project-id>

# 1. Create the cluster
clouder kubernetes create my-cluster

# 2. Get kubeconfig and set as default
clouder kubernetes kubeconfig my-cluster
clouder kubernetes use my-cluster

# 3. Create node pools
clouder kubernetes create-nodepool my-cluster \
    system --flavor Standard_D4s_v5 \
    --min 1 --desired 2 --max 10 \
    --roles system --xpu cpu

clouder kubernetes create-nodepool my-cluster \
    jupyter-gpu --flavor Standard_NC6s_v3 \
    --min 0 --desired 1 --max 5 \
    --roles jupyter --xpu gpu-cuda

# 4. Verify
kubectl get nodes

# 5. Scale GPU nodes to zero when idle
clouder kubernetes update-nodepool my-cluster \
    jupyter-gpu --desired 0

# 6. List clusters
clouder kubernetes ls