kuberay

Deploy and manage distributed Ray clusters on Kubernetes with the KubeRay operator.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/tylertitsworth/skills --skill kuberay
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kuberay
Source: https://github.com/tylertitsworth/skills/tree/main/kuberay
Command: npx skills add https://github.com/tylertitsworth/skills --skill kuberay

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Simplifies deploying and orchestrating distributed Ray workloads on Kubernetes by providing a dedicated operator and CRDs.

Core Features & Use Cases

  • Create and manage RayCluster, RayJob, and RayService resources with CRDs.
  • Enable autoscaling, TLS authentication, GCS fault tolerance, and multi-tenant deployments.
  • Integrate with Kueue for queue-based scheduling and offer robust observability via dashboards and metrics.

Quick Start

Install the KubeRay operator and apply a RayCluster manifest to launch a head and workers.

Frequently Asked Questions about kuberay

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy Ray clusters on Kubernetes?

Deploy Ray clusters on Kubernetes by using the KubeRay operator to apply CRD manifests for RayCluster resources, launching a head node and worker pods automatically. Helm-based installation sets up the operator, then you apply your RayCluster manifest to start distributed workloads.

Can I use RayServe for model serving on Kubernetes?

RayServe runs on Kubernetes by creating RayService custom resources managed by the KubeRay operator. This deploys and manages RayServe workloads natively, integrating autoscaling and TLS authentication for scalable model serving.

Does KubeRay support autoscaling for Ray worker nodes?

KubeRay supports autoscaling for Ray worker nodes within Kubernetes environments. The operator dynamically scales worker pods based on workload demand, managed via CRD-driven resource configurations.

How do I enable GCS fault tolerance in a Ray cluster on Kubernetes?

Enable GCS fault tolerance by configuring the KubeRay operator settings in your RayCluster manifest. This ensures distributed Ray workloads maintain state and recover from head node failures across the Kubernetes cluster.

What Kubernetes RBAC permissions are needed to run Ray workloads?

Running Ray workloads requires Kubernetes access with proper RBAC permissions to manage RayCluster, RayJob, and RayService CRDs. The KubeRay operator needs permissions to create and manage pods, services, and custom resources across multi-tenant environments.

Can I run Ray jobs in multi-tenant Kubernetes environments?

Ray jobs run in multi-tenant Kubernetes environments using KubeRay CRDs for tenant isolation. The operator manages RayJob resources with queue-based scheduling integration via Kueue, ensuring robust workload isolation and observability.