在 Google Kubernetes Engine (GKE) 上啟用 Ray 運算子

本頁面說明如何為 Google Kubernetes Engine (GKE) 啟用 Ray 運算子，以便使用 KubeRay API 擴充及管理 Ray 叢集。如要進一步瞭解 Ray 和 KubeRay，請參閱 GKE 中的 Ray 總覽。

事前準備

開始之前，請確認您已完成下列工作：

  • 啟用 Google Kubernetes Engine API。
    • 啟用 Google Kubernetes Engine API
  • 如要使用 Google Cloud CLI 執行這項工作，請安裝並初始化 gcloud CLI。如果您先前已安裝 gcloud CLI，請執行 gcloud components update，取得最新版本。

為叢集啟用 Ray 運算子

您可以使用 Google Cloud CLI、 Google Cloud 控制台或 Terraform，在新的或現有的 Autopilot 或 Standard GKE 叢集上啟用 Ray 運算子。

主控台

  1. 前往 Google Cloud 控制台的「Google Kubernetes Engine」頁面。

    前往「Google Kubernetes Engine」

  2. 依序點按「建立」，然後在「標準」或「Autopilot」部分中，點按「設定」。

  3. 如果是 Standard 叢集，請在導覽窗格的「Cluster」(叢集) 下方按一下「Features」(功能)。如果是 Autopilot，請按一下「進階設定」。

  4. 在「AI and Machine Learning」(AI 和機器學習) 專區中，選取「Enable Ray Operator」(啟用 Ray 運算子) 核取方塊。

  5. 點選「建立」。

gcloud

使用 --addons=RayOperator 選項建立叢集：

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

更改下列內容：

  • CLUSTER_NAME：新叢集的名稱。
  • VERSION：GKE 版本，必須為 1.30.0-gke.1747000 以上版本。你也可以使用 --release-channel 選項選取發布管道。發布管道的預設版本必須為 1.30.0-gke.1747000 以上版本。

您可以使用 gcloud container clusters update 指令搭配 --update-addons=RayOperator=ENABLED 選項，在現有叢集上啟用 Ray 運算子。

Terraform

下列 Terraform 範例會建立及設定 Standard 叢集：

resource "google_container_cluster" "default" {
  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
      }
    }
  }
}

如要進一步瞭解如何使用 Terraform，請參閱「GKE 的 Terraform 支援」。

版本管理

下列 GKE 子版本可使用 Ray 運作資源，並搭配對應的 KubeRay 版本：

GKE 子版本 KubeRay 版本
1.33 v1.3
1.32 v1.2
1.31 v1.2
1.30 v1.1
1.29 v1.1

確認已啟用 Ray 運算子

您可以使用 gcloud CLI 或 Google Cloud 控制台，確認 Autopilot 或 Standard GKE 叢集是否已啟用 Ray 運算子。

主控台

  1. 前往 Google Cloud 控制台的「Google Kubernetes Engine」頁面。

    前往「Google Kubernetes Engine」

  2. 在叢集清單中，按一下要驗證的叢集名稱。

  3. 在「Features」(功能) 專區中，確認已選取「Ray Operator」(Ray 運算子) 核取方塊。

gcloud

描述叢集：

gcloud container clusters describe CLUSTER_NAME

將 CLUSTER_NAME 替換為叢集名稱。

輸出內容會類似以下內容：

# Several lines omitted
addonsConfig:
  rayOperatorConfig:
    enabled: true

這項輸出內容表示叢集已啟用 Ray 運算子。

後續步驟