KubeRay is an open-source Kubernetes operator written in Go that enables the deployment and management of Ray applications on Kubernetes clusters. The project serves as a bridge between Ray, a distributed computing framework, and Kubernetes, providing custom resource definitions that abstract away the complexity of running Ray workloads in containerized environments.
The core of KubeRay consists of three primary custom resource definitions. RayCluster manages the complete lifecycle of Ray clusters on Kubernetes, handling cluster creation, deletion, autoscaling, and fault tolerance automatically. RayJob simplifies job execution by automatically creating a RayCluster and submitting a job once the cluster is ready, with optional automatic cleanup of the cluster after job completion. RayService combines a RayCluster with a Ray Serve deployment graph to provide zero-downtime upgrades and high availability for serving workloads.
Beyond the core operator, KubeRay includes several ecosystem components at various maturity levels. The kubectl plugin, available since version 1.3.0, provides a command-line interface that simplifies common Ray deployment workflows for users unfamiliar with Kubernetes. The KubeRay APIServer, currently in alpha, offers a simplified configuration layer for KubeRay resources and is used internally by some organizations to power user interfaces. The KubeRay Dashboard, introduced in version 1.4.0 as an experimental feature, allows users to view and manage KubeRay resources through a graphical interface, though it is not yet production-ready.
The repository demonstrates significant community engagement and active maintenance. GitGenius tracking shows a median issue and pull request response latency of 0.0 hours with a mean of 3881.6 hours across 1284 tracked items, indicating rapid initial responses to community contributions. The most active contributor, kevin85421, has logged 2590 events, followed by Future-Outlier with 720 events and andrewsykim with 468 events. Enhancement requests represent the most common issue type with 685 tracked items, followed by bug reports with 360 items and good-first-issue labels with 153 items, suggesting an active development cycle and welcoming environment for new contributors.
KubeRay integrates extensively with the broader Kubernetes ecosystem, supporting observability tools like Prometheus and Grafana, queuing systems including Volcano, Apache YuniKorn, and Kueue, and ingress controllers such as Nginx. The project has gained adoption across major technology companies, with documented case studies from organizations including Workday, Klaviyo, Niantic, Samsara, Google Cloud, DoorDash, Spotify, Instacart, and others demonstrating real-world applications in model serving, batch training, and distributed machine learning.
The project maintains active community engagement through a dedicated Slack channel monitored by maintainers, bi-weekly community meetings, and comprehensive documentation hosted on the Ray project's documentation site. User-facing documentation was consolidated to the Ray documentation starting in September 2023, while the KubeRay repository focuses on development and maintenance documentation. The project is licensed under the Apache 2.0 License and welcomes contributions following its established guidelines.
