Kuberay operator upgrade from v1.0.0 to v1.2.2

Ray Clusters Kubernetes
1

Hello

We have kuberay operator which is deployed at namespace level at version v1.0.0. We want to upgrade to latest version of v1.2.2. Cant find enough documentation on

  • If there are any breaking changes of directly upgrading to v1.2.2 from v1.0.0 or the prerequisites
  • I see that for version v1.1.0 ray version needs to be 2.8.0 or higher. What happens to existing jobs or services once we upgrade to latest version 1.2.2, would they start erroring out ?
  • Whats clean way to upgrade

Thanks & Regards

2

Please refer to the KubeRay upgrade guide.

Upgrading from KubeRay v1.0.0 to v1.2.2 requires first upgrading the CRD:

kubectl replace -k "github.com/ray-project/kuberay/ray-operator/config/crd?ref=v1.2.2"

If there are still v1alpha Ray resources in your cluster, you will need to use kubectl edit or kubectl apply to update them to v1.

Additionally, if any Ray resources are using a Ray version below 2.8.0, you need to upgrade them to 2.8.0 or above.

Note that changing the image in the RayCluster spec (e.g., from rayproject/ray:2.0.0 to rayproject/ray:2.9.0) will not automatically recreate the existing pods associated with this RayCluster. The existing pods will not restart automatically; instead, only when the old pods are deleted will new pods be created with the updated image. So for RayCluster you need to either delete and recreate it or use suspend in its spec to delete all pods. For RayService, changing the image in the RayService spec will trigger a zero-downtime upgrade, so a new RayCluster will be created for you.

Finally, you can upgrade the KubeRay operator itself:

helm upgrade kuberay-operator kuberay/kuberay-operator --version v1.2.2
1 Like