Skip to main content

Deploy a Cluster

This example walks through deploying a new Kubernetes cluster using Qumulus.

Prerequisites​

  • Access to the Qumulus management cluster
  • Appropriate RBAC permissions
  • kubectl configured with admin credentials

Create a TenantControlPlane​

Define your cluster specification:

apiVersion: kamaji.clastix.io/v1alpha1
kind: TenantControlPlane
metadata:
  name: my-cluster
  namespace: my-org
spec:
  kubernetes:
    version: "1.28.0"
  controlPlane:
    replicas: 3

Apply the configuration:

kubectl apply -f tenant-control-plane.yaml

Monitor Provisioning​

Watch the cluster come up:

kubectl get tenantcontrolplanes -n my-org -w

Retrieve Kubeconfig​

Once the cluster is ready, get your credentials:

kubectl get secret my-cluster-admin-kubeconfig -n my-org \
  -o jsonpath='{.data.admin\.conf}' | base64 -d > ~/.kube/config.my-cluster

Verify Access​

export KUBECONFIG=~/.kube/config.my-cluster
kubectl get nodes