Enable the Ray operator on Google Kubernetes Engine (GKE)

Console

1. Go to the Google Kubernetes Engine page in the Google Cloud console.

   Go to Google Kubernetes Engine

2. Click add_box Create then in the Standard or Autopilot section, click Configure.

3. For Standard, from the navigation pane, under Cluster, click Features. For Autopilot, click Advanced Settings.

4. In the AI and Machine Learning section, select the Enable Ray Operator checkbox.

5. Click Create.

gcloud

Create a cluster using the --addons=RayOperator option:

gcloud container clusters create CLUSTER_NAME \
    --cluster-version=VERSION \
    --addons=RayOperator

Replace the following:

• CLUSTER_NAME: the name of the new cluster.
• VERSION: the GKE version, which must be 1.30.0-gke.1747000 or later. You can also use the --release-channel option to select a release channel. The release channel must have a default version of 1.30.0-gke.1747000 or later.

You can enable the Ray operator on an existing cluster by using the gcloud container clusters update command with option --update-addons=RayOperator=ENABLED.

Terraform

The following Terraform example creates and configures a Standard cluster:

resource "google_container_cluster" "ray-cluster" {
  name     = "gke-standard-regional-ray-operator"
  location = "us-west1"

  initial_node_count = 1

  release_channel {
    channel = "RAPID"
  }

  addons_config {
    ray_operator_config {
      enabled = true
      ray_cluster_logging_config {
        enabled = true
      }
      ray_cluster_monitoring_config {
        enabled = true
      }
    }
  }

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

To learn more about using Terraform, see Terraform support for GKE.

Console

1. Go to the Google Kubernetes Engine page in the Google Cloud console.

   Go to Google Kubernetes Engine

2. In the cluster list, click the name of the cluster that you want to verify.

3. In the Features section, confirm that the Ray Operator checkbox is selected.

gcloud

Describe your cluster:

gcloud container clusters describe CLUSTER_NAME

Replace CLUSTER_NAME with the name of the cluster.

The output is similar to the following

# Several lines omitted
addonsConfig:
  rayOperatorConfig:
    enabled: true

This output indicates that the Ray operator is enabled for the cluster.