Kubernetes Setup

Begin checkpoint/migrate/restoring stateful workloads in Kubernetes in under 5 minutes!

We provide a helm chart to easily install our services on your cluster.

Currently the host images should be debian:bookworm or ubuntu:22.04 and above.

We don't properly support non-debian based images. Consider switching to Ubuntu AMI for k8s nodes on AWS EKS from Amazon Linux.

When running Cedana against an EKS cluster, cgroupsv2 must be used by your container runtime and be installed on your AMI. The minimum Linux kernel version is 6.1.x.

If you're a customer with an organization registered with us, replace https://sandbox.cedana.ai/v1 with https://myorganization.cedana.ai/v1.

Install

Make sure you have the helm tool installed.

To run the controller we require your CEDANA_AUTH_TOKEN, which you can generate here.

export CEDANA_AUTH_TOKEN=<your token>

helm install cedana oci://registry-1.docker.io/cedana/cedana-helm \
    --create-namespace -n cedana-system \
    --set config.url="https://sandbox.cedana.ai/v1" \
    --set config.authToken="${CEDANA_AUTH_TOKEN}" \
    --set config.clusterName=my-cluster

Take a look at our Additional Configuration for customization.

If you want the latest changes or in case the above fails to work feel free to use our helm chart repo.

git clone https://github.com/cedana/cedana-helm-charts --depth=1

helm install cedana ./cedana-helm-charts/cedana-helm \
    --create-namespace -n cedana-system \
    --set config.url="https://sandbox.cedana.ai/v1" \
    --set config.authToken="${CEDANA_AUTH_TOKEN}" \
    --set config.clusterName=my-cluster

Uninstall

To uninstall Cedana completely, simply do:

helm uninstall cedana -n cedana-system