Installation

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.

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. Note that we can deploy fully self hosted, and have 0 limitations about where we can store our snapshots! Mostly everything is configurable - if you have any questions about your setup and/or compatibility, please reach out to the above email.

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.

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-auth-token>
export CEDANA_CLUSTER_ID=<generated id>
export CEDANA_URL=<your-org-url>

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=$CEDANA_URL \
 --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, you can follow an interactive guide here: Walking through Managed Cedana.

Uninstall

To uninstall Cedana completely, simply do:

helm uninstall cedana -n cedana-systems