Skip to content

Ray on EKS Deep Dive ​

Review baseline: Ray 2.58.0, KubeRay v1.7.0 Documentation reviewed: September 12, 2026

Overview ​

Ray distributes Python work using tasks, actors, ObjectRefs, and per-node object stores. Train, Tune, and Serve use that foundation while adding training, search, and serving policies. One object-store path does not automatically handle every communication or recovery concern.

KubeRay is the Kubernetes operator reconciling RayCluster, RayJob, and RayService. It does not select the application's ML library as a dispatcher. Ray work scheduling, Kubernetes Pod placement, and EC2 node provisioning are separate layers.

Component Map ​

ConceptProblem It SolvesDeep Dive
ArchitectureTasks, actors, and the object store that everything else builds onPart 1
KubeRay OperatorRun Ray clusters as native Kubernetes resources (RayCluster/RayJob/RayService)Part 2
Ray Train & TuneDistributed model training and hyperparameter searchPart 3
Ray ServeModel serving, including dedicated LLM-serving building blocksPart 4

Application libraries such as Train, Tune, and Serve use Ray Core tasks and actors; KubeRay separately manages Ray resources on Kubernetes.

Application libraries such as Train, Tune, and Serve use Ray Core tasks and actors; KubeRay separately manages Ray resources on Kubernetes.Open full screen ↗

Why Run This on EKS ​

The trade-off is the same one covered elsewhere in this documentation site's data/ML sections: a team already running EKS can reuse the same node-pool autoscaling (via Karpenter), IAM, and observability patterns for Ray workloads as for everything else on the cluster, in exchange for operating the KubeRay operator and its RayCluster/RayJob/RayService resources directly rather than using a managed alternative.

The foundation check is a small single-node Ray run. It is not evidence of GPU training, multi-node recovery, a live EKS installation, or autoscaling.

Currently Covered ​

  1. Part 1: Ray Architecture — tasks, actors, the object store, and the head/worker cluster model
  2. Part 2: The KubeRay Operator — RayCluster, RayJob, RayService, and the two-tier autoscaling pattern with Karpenter
  3. Part 3: Ray Train and Ray Tune — distributed training and hyperparameter tuning
  4. Part 4: Ray Serve — model serving, Ray Serve LLM, and RayService-based production deployment

Primary Sources ​