[RayServe] Documentation is misleading about what services get created by a RayService

[boyleconnor]

Description

I tried creating a sample RayService, following the documentation: https://docs.ray.io/en/latest/serve/production-guide/kubernetes.html#deploying-a-serve-application :

$ kubectl apply -f https://raw.githubusercontent.com/ray-project/kuberay/5b1a5a11f5df76db2d66ed332ff0802dc3bbff76/ray-operator/config/samples/ray-service.text-ml.yaml
rayservice.ray.io/rayservice-sample created

With KubeRay operator 1.3.0:

$ helm list 
NAME                    NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
kuberay-operator        default         2               2025-02-27 12:13:41.616923988 -0800 PST deployed        kuberay-operator-1.3.0             

Although the documentation implied that this would create services with names such as:

rayservice-sample-head-svc                         ClusterIP   ...        8080/TCP,6379/TCP,8265/TCP,10001/TCP,8000/TCP,52365/TCP   XXs
rayservice-sample-raycluster-454c4-dashboard-svc   ClusterIP   ...        52365/TCP                                                 XXs
rayservice-sample-raycluster-454c4-head-svc        ClusterIP   ...        8000/TCP,52365/TCP,8080/TCP,6379/TCP,8265/TCP,10001/TCP   XXs
rayservice-sample-serve-svc                        ClusterIP   ...        8000/TCP                                                  XXs

No service with a name rayservice-sample-head-svc was created:

$ kubectl get services
NAME                                           TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                                         AGE
kubernetes                                     ClusterIP   10.100.0.1      <none>        443/TCP                                         2d18h
rayservice-sample-raycluster-47q27-head-svc    ClusterIP   None            <none>        10001/TCP,8265/TCP,6379/TCP,8080/TCP,8000/TCP   4m10s

Link

https://docs.ray.io/en/latest/serve/production-guide/kubernetes.html#deploying-a-serve-application