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.

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. On EKS, we currently support AL2023 and Ubuntu images. Our main dependency is glibc, which needs to be >=2.34.

To use the cedana-managed kubernetes product, you need to have registered with us! Reach out to [email protected] to get set up with an organization.

Install

Make sure you have the helm tool installed.

First create an API token through our UI (by navigating to https://ui.cedana.com and signing in via the Magic Link).

To set up a cluster, first register it, from Monitoring -> Clusters.

The registration process gives you an ID, which can then be used to complete the helm install commands as shown below (and through the UI!):

export CEDANA_AUTH_TOKEN=<your token>
export CEDANA_CLUSTER_ID=<generated id>

helm upgrade -i cedana oci://registry-1.docker.io/cedana/cedana-helm  \
 --create-namespace -n cedana-systems \
 --set=config.clusterId=$CEDANA_CLUSTER_ID \
 --set=config.url=https://demo.cedana.ai/v1 \
 --set=config.authToken=$CEDANA_AUTH_TOKEN

Take a look at our Additional Configuration for customization.

You're all set up! From here, you can follow the individual guides to see how to perform checkpoint/restores in Kubernetes under Examples. Alternatively, follow the interactive guide here:

Uninstall

To uninstall Cedana completely, simply do:

helm uninstall cedana -n cedana-system