KubeRay 部署十分钟上手装好 Ray Operator跑通第一个 RayCluster【免费下载链接】kuberayA toolkit to run Ray applications on Kubernetes项目地址: https://gitcode.com/GitHub_Trending/ku/kuberayKubeRay 是一个在 Kubernetes 上运行 Ray 应用的 Operator本文带你完成 KubeRay 部署与上手全流程。装好 Operator 后它接管 Ray 集群的完整生命周期你只需提交一份 YAML节点就会自动拉起。看完这篇你的第一个 RayCluster 就能跑起来并且知道该改哪里。核心亮点管理 RayCluster、RayJob、RayService 三类自定义资源覆盖长驻服务和一次性任务内置自动扩缩容与容错Worker 节点数随负载自动增减可接入 Volcano、YuniKorn 等批量调度器可选 kubectl 插件、API Server、Web 控制台等扩展组件一、环境要求与安装 这一步把 KubeRay Operator 装进你的 Kubernetes 集群是后续所有操作的前提。前置条件清单可访问的 Kubernetes 集群版本 1.23 及以上已配置好kubectl并能连上集群使用 Helm 方式时需要 Helm v3 及以上方式一通过 Helm 仓库安装推荐细节见 docs/deploy/helm.mdhelm repo add kuberay https://ray-project.github.io/kuberay-helm/ helm install kuberay-operator kuberay/kuberay-operator方式二克隆仓库后本地安装git clone https://gitcode.com/GitHub_Trending/ku/kuberay cd kuberay/helm-chart/kuberay-operator helm install kuberay-operator .验证是否装好kubectl get pods # kuberay-operator-xxxx 1/1 Running 0 17s kubectl get crd | grep ray.io # rayclusters / rayjobs / rayservices / raycronjobs看到 Operator Pod 处于 Running且 4 个 CRD 都在说明安装成功。二、仓库目录速览改配置、查源码前先花一分钟认清仓库的主干结构. ├── ray-operator/ # 核心 Operator控制器、CRD 定义、示例 YAML ├── helm-chart/ # 安装 Operator 与 API Server 的 Helm 图表 ├── apiserver/ # 资源管理 APIServer可选组件 ├── dashboard/ # 实验性 Web 管理控制台 ├── kubectl-plugin/ # kubectl ray 插件简化常用命令 ├── clients/ # Python SDK 客户端 ├── historyserver/ # 日志收集与历史会话服务 ├── docs/ # 安装、部署与开发文档 └── benchmark/ # 性能测试与 Operator 内存基准测试新手优先看 ray-operator/ 和 helm-chart/ 两个目录前者是全部控制器源码和示例所在地后者是安装配置所在地。Operator 与监控组件的协作关系如下图所示三、快速上手跑通你的第一个 RayCluster 现在提交一个 RayCluster验证整套 KubeRay 部署是否真正可用。把下面这份最小配置保存为raycluster.yaml更完整的版本可参考 ray-operator/config/samples/。apiVersion: ray.io/v1 kind: RayCluster metadata: name: my-raycluster spec: rayVersion: 2.52.0 headGroupSpec: template: spec: containers: - name: ray-head image: rayproject/ray:2.52.0 ports: - containerPort: 8265 name: dashboard workerGroupSpecs: - replicas: 1 groupName: worker-group template: spec: containers: - name: ray-worker image: rayproject/ray:2.52.0应用并观察状态kubectl apply -f raycluster.yaml kubectl get raycluster # NAME DESIRED WORKER RUNNING WORKER STATUS # my-raycluster 1 1 RUNNING成功的样子STATUS 列变为 RUNNING说明 Head 和 Worker 节点都已就绪。此时用kubectl port-forward把 8265 端口转发到本地浏览器打开就能看到 Ray Dashboard集群页如下四、配置要点 ⚙️生产使用前把下面几个高频配置项过一遍。Operator 侧配置在 helm-chart/kuberay-operator/values.yaml集群侧配置在 RayCluster YAML 里。配置项作用示例image.tagOperator 镜像版本默认 nightly1.1.0replicasOperator 副本数1batchScheduler.name指定自定义批量调度器volcano、yunikorn、scheduler-pluginsrayVersion集群内 Ray 版本须与镜像一致2.52.0workerGroupSpecs[].minReplicas/maxReplicasWorker 自动扩缩容范围最小1最大10最易配错的一点rayVersion字段必须与rayproject/ray镜像的 tag 完全一致不一致时集群会一直无法进入 RUNNING排查时先看这里。五、常见问题 ❓Q装 CRD 需要集群管理员权限装 Operator 不需要怎么分工管理员先单独安装 CRD开发者再用helm install加--skip-crds参数只装 Operator详细步骤见 docs/deploy/helm.md。Q如何彻底卸载 KubeRay执行helm uninstall kuberay-operatorOperator Pod 和 release 都会移除如需连同 CRD 一起清理删除时额外执行helm uninstall对应的 CRD 资源即可。Qkubectl apply之后一直不 RUNNING怎么排查先核对rayVersion与镜像版本是否一致再用kubectl logs查看 head Pod 日志定位具体报错。一句话总结KubeRay 部署就是 Helm 装 Operator、验证 CRD、提交 RayCluster YAML 这三步。想继续深入建议浏览 docs/ 目录下的部署文档和 ray-operator/config/samples/ 里的各类示例。【免费下载链接】kuberayA toolkit to run Ray applications on Kubernetes项目地址: https://gitcode.com/GitHub_Trending/ku/kuberay创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 KubeRay 部署十分钟上手：装好 Ray Operator，跑通第一个 RayCluster
KubeRay 部署十分钟上手装好 Ray Operator跑通第一个 RayCluster【免费下载链接】kuberayA toolkit to run Ray applications on Kubernetes项目地址: https://gitcode.com/GitHub_Trending/ku/kuberayKubeRay 是一个在 Kubernetes 上运行 Ray 应用的 Operator本文带你完成 KubeRay 部署与上手全流程。装好 Operator 后它接管 Ray 集群的完整生命周期你只需提交一份 YAML节点就会自动拉起。看完这篇你的第一个 RayCluster 就能跑起来并且知道该改哪里。核心亮点管理 RayCluster、RayJob、RayService 三类自定义资源覆盖长驻服务和一次性任务内置自动扩缩容与容错Worker 节点数随负载自动增减可接入 Volcano、YuniKorn 等批量调度器可选 kubectl 插件、API Server、Web 控制台等扩展组件一、环境要求与安装 这一步把 KubeRay Operator 装进你的 Kubernetes 集群是后续所有操作的前提。前置条件清单可访问的 Kubernetes 集群版本 1.23 及以上已配置好kubectl并能连上集群使用 Helm 方式时需要 Helm v3 及以上方式一通过 Helm 仓库安装推荐细节见 docs/deploy/helm.mdhelm repo add kuberay https://ray-project.github.io/kuberay-helm/ helm install kuberay-operator kuberay/kuberay-operator方式二克隆仓库后本地安装git clone https://gitcode.com/GitHub_Trending/ku/kuberay cd kuberay/helm-chart/kuberay-operator helm install kuberay-operator .验证是否装好kubectl get pods # kuberay-operator-xxxx 1/1 Running 0 17s kubectl get crd | grep ray.io # rayclusters / rayjobs / rayservices / raycronjobs看到 Operator Pod 处于 Running且 4 个 CRD 都在说明安装成功。二、仓库目录速览改配置、查源码前先花一分钟认清仓库的主干结构. ├── ray-operator/ # 核心 Operator控制器、CRD 定义、示例 YAML ├── helm-chart/ # 安装 Operator 与 API Server 的 Helm 图表 ├── apiserver/ # 资源管理 APIServer可选组件 ├── dashboard/ # 实验性 Web 管理控制台 ├── kubectl-plugin/ # kubectl ray 插件简化常用命令 ├── clients/ # Python SDK 客户端 ├── historyserver/ # 日志收集与历史会话服务 ├── docs/ # 安装、部署与开发文档 └── benchmark/ # 性能测试与 Operator 内存基准测试新手优先看 ray-operator/ 和 helm-chart/ 两个目录前者是全部控制器源码和示例所在地后者是安装配置所在地。Operator 与监控组件的协作关系如下图所示三、快速上手跑通你的第一个 RayCluster 现在提交一个 RayCluster验证整套 KubeRay 部署是否真正可用。把下面这份最小配置保存为raycluster.yaml更完整的版本可参考 ray-operator/config/samples/。apiVersion: ray.io/v1 kind: RayCluster metadata: name: my-raycluster spec: rayVersion: 2.52.0 headGroupSpec: template: spec: containers: - name: ray-head image: rayproject/ray:2.52.0 ports: - containerPort: 8265 name: dashboard workerGroupSpecs: - replicas: 1 groupName: worker-group template: spec: containers: - name: ray-worker image: rayproject/ray:2.52.0应用并观察状态kubectl apply -f raycluster.yaml kubectl get raycluster # NAME DESIRED WORKER RUNNING WORKER STATUS # my-raycluster 1 1 RUNNING成功的样子STATUS 列变为 RUNNING说明 Head 和 Worker 节点都已就绪。此时用kubectl port-forward把 8265 端口转发到本地浏览器打开就能看到 Ray Dashboard集群页如下四、配置要点 ⚙️生产使用前把下面几个高频配置项过一遍。Operator 侧配置在 helm-chart/kuberay-operator/values.yaml集群侧配置在 RayCluster YAML 里。配置项作用示例image.tagOperator 镜像版本默认 nightly1.1.0replicasOperator 副本数1batchScheduler.name指定自定义批量调度器volcano、yunikorn、scheduler-pluginsrayVersion集群内 Ray 版本须与镜像一致2.52.0workerGroupSpecs[].minReplicas/maxReplicasWorker 自动扩缩容范围最小1最大10最易配错的一点rayVersion字段必须与rayproject/ray镜像的 tag 完全一致不一致时集群会一直无法进入 RUNNING排查时先看这里。五、常见问题 ❓Q装 CRD 需要集群管理员权限装 Operator 不需要怎么分工管理员先单独安装 CRD开发者再用helm install加--skip-crds参数只装 Operator详细步骤见 docs/deploy/helm.md。Q如何彻底卸载 KubeRay执行helm uninstall kuberay-operatorOperator Pod 和 release 都会移除如需连同 CRD 一起清理删除时额外执行helm uninstall对应的 CRD 资源即可。Qkubectl apply之后一直不 RUNNING怎么排查先核对rayVersion与镜像版本是否一致再用kubectl logs查看 head Pod 日志定位具体报错。一句话总结KubeRay 部署就是 Helm 装 Operator、验证 CRD、提交 RayCluster YAML 这三步。想继续深入建议浏览 docs/ 目录下的部署文档和 ray-operator/config/samples/ 里的各类示例。【免费下载链接】kuberayA toolkit to run Ray applications on Kubernetes项目地址: https://gitcode.com/GitHub_Trending/ku/kuberay创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考