クラスタを表示

Gemini Enterprise Agent Platform トレーニング クラスタに関心をお持ちの場合は、営業担当者にお問い合わせください。

このページでは、プロジェクト内のトレーニングクラスタを一覧表示して確認する方法について説明します。 Google Cloud コンソールまたは Agent Platform API（Google Cloud CLI はサポートされていません）を使用します。

クラスタを表示すると、次のことを確認できます。

  • クラスタ構成
  • クラスタとノードの状態
  • ログインノード情報
  • クラスタ リソースの使用量

クラスタの更新方法については、 クラスタを管理するをご覧ください。

始める前に

まだ行っていない場合は、 Gemini Enterprise Agent Platform に対する認証を行います。

このページのサンプルをどのように使うかに応じて、タブを選択してください。

コンソール

コンソール Google Cloud を使用してサービスと Google Cloud API にアクセスする場合、 認証を設定する必要はありません。

REST

このページの REST API サンプルをローカル開発環境で使用するには、 gcloud CLI に指定した認証情報を使用します。

    Google Cloud CLI をインストールし、 フェデレーション ID を使用して gcloud CLI にログインします。

詳細については、 REST を使用して認証する 認証ドキュメントの Google Cloud をご覧ください。

必要なロール

トレーニング クラスタを表示するために必要な権限を取得するには、プロジェクトに対するAgent Platform 閲覧者 （roles/aiplatform.viewer）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

この事前定義ロールには トレーニング クラスタの表示に必要な権限が含まれています。必要とされる正確な権限については、必要な権限セクションを開いてご確認ください。

必要な権限

トレーニング クラスタを表示するには、次の権限が必要です。

  • クラスタのリストを表示するには: aiplatform.modelDevelopmentClusters.list
  • 単一クラスタの詳細を表示するには: aiplatform.modelDevelopmentClusters.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

コンソールの可視性

IAM 権限だけでは、トレーニング クラスタは コンソールに Google Cloud 表示されません。[トレーニング クラスタ] ページは、Gemini Enterprise Agent Platform トレーニング クラスタに登録されているプロジェクトにのみ表示されます。ページが表示されない場合は、営業担当者にお問い合わせください。

Google Cloud コンソールでは、 プロジェクトで次の API を有効にする必要もあります。いずれかが欠落している場合、[トレーニング クラスタ] ページにはクラスタではなく [API を有効にする] ボタンが表示されます。

  • aiplatform.googleapis.com
  • compute.googleapis.com
  • file.googleapis.com
  • hypercomputecluster.googleapis.com
  • lustre.googleapis.com
  • servicenetworking.googleapis.com
  • storage.googleapis.com

API の認証

このページの Agent Platform API の例では、Google Cloud CLI を呼び出してアクセス トークンを生成する次のエイリアスを使用します。

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

クラスタの一覧を表示する

どちらのインターフェースでも、クラスタはリージョンごとに一覧表示されます。コンソール Google Cloud では、リストからリージョンを選択します。Agent Platform API では、リージョンはリクエスト URL の一部です。

コンソール

  1. コンソール Google Cloud で、[トレーニング クラスタ] ページに移動します。

    [トレーニング クラスタ] に移動

  2. [リージョン] リストで、クラスタを表示するリージョンを選択します。

    ページに、そのリージョンのクラスタが一覧表示されます。テーブルの各列は、クラスタのプロパティを表します。

    列 説明
    ID クラスタ ID。Agent Platform API リクエストで CLUSTER_ID として使用します。
    名前 クラスタの表示名。
    ステータス クラスタの状態: Creating、Running、Updating、Stopping、Error。
    ノード クラスタ内のノード数。
    作成日 クラスタが作成された日時。
    マシンタイプ クラスタのノードプールで使用されるマシンタイプ。
    消費モデル クラスタの容量の取得方法: Reservation、Spot、Flex-start、On-demand。

  3. クラスタを開くには、[名前] 列でその名前をクリックします。

REST

1 つのリージョン内のクラスタのリストを表示するには、modelDevelopmentClusters コレクションに GET リクエストを送信します。

gcurl -X GET https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/modelDevelopmentClusters

次のように置き換えます。

  • PROJECT_ID: 実際のプロジェクトの ID。
  • REGION: クラスタが存在するリージョン。

list メソッドは、ページネーションを制御するために次のオプションのクエリ パラメータをサポートしています。

  • pageSize （整数、省略可）: レスポンスで返されるクラスタの最大数。アイテムがさらに存在する場合でも、サービスが返す値はこれよりも少ないことがあります。指定しない場合、デフォルトのページサイズが使用されます。
  • pageToken （文字列、省略可）: 前回のリスト呼び出しから受け取ったトークン。 結果の次のページを取得するには、このトークンを指定します。

次の例では、ページあたりの最大クラスタ数が 5 の結果の最初のページをリクエストします。

gcurl "https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/modelDevelopmentClusters?pageSize=5"

成功したレスポンスには、最大 5 つのクラスタ リソースを含む modelDevelopmentClusters 配列が含まれます。また、nextPageToken 文字列が含まれる場合もあります。

クラスタの詳細を表示する

Google Cloud コンソールと Agent Platform API はどちらも、クラスタの構成 と現在の状態（各ノードの状態を含む）をレポートします。Cloud Monitoring ダッシュボードは、 コンソール Google Cloud でのみ使用できます。

コンソール

  1. コンソール Google Cloud で、[トレーニング クラスタ] ページに移動します。

    [トレーニング クラスタ] に移動

  2. [リージョン] リストで、クラスタが存在するリージョンを選択します。

  3. [名前] 列で、表示するクラスタの名前をクリックします。 [クラスタの詳細] ページが [概要] タブで開きます。

  4. タブを選択して、対応する詳細を表示します。

    • 概要: クラスタの名前、説明、ロケーション、 構成済みのコンピューティング、ネットワーク、オーケストレーションの設定、ログインノード、 Slurm パーティション。

    • ノード: クラスタ内のノードを説明する 2 つのテーブル。

    • [**ログインノード**]、列は [**ステータス**]、[**名前**]、[**ゾーン**]、 [**マシンタイプ**]、[**内部 IP**]、[**外部 IP**]、[**接続**]。[接続] を使用して、ログインノードで SSH セッションを開きます。

    • [**コンピューティング ノード**]、列は [**ステータス**]、[**名前**]、[**ゾーン**]、 [**マシンタイプ**]、[**内部 IP**]、[**パーティション**]。

    • 可観測性: クラスタ全体の CPU、 メモリ、ネットワークの使用状況をカバーする事前構築済みの Cloud Monitoring ダッシュボード。GPU 使用率、 NVIDIA Data Center GPU Manager（DCGM）指標、GPU ネットワーク、GPU の健全性。

クラスタの現在の状態でページを再読み込みするには、 [更新] をクリックします。クラスタを削除するには、 [削除]をクリックします。

REST

単一クラスタの詳細を表示するには、クラスタ リソースに GET リクエストを送信します。

gcurl -X GET https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/modelDevelopmentClusters/CLUSTER_ID

次のように置き換えます。

  • PROJECT_ID: 実際のプロジェクトの ID。
  • REGION: クラスタが存在するリージョン。
  • CLUSTER_ID: 表示するクラスタの ID。これは、 コンソールの [Training Clusters] ページの [ID] 列に表示される Google Cloud 値です。

レスポンスは ModelDevelopmentCluster リソースです。クラスタの構成とともに、clusterStatus フィールドには、クラスタと各ノードの現在の状態がレポートされます。

  • clusterStatus.state: クラスタの状態。PROVISIONING、RUNNING、UPDATING、STOPPING、ERROR のいずれか。コンソール Google Cloud では、 PROVISIONING は [作成中] と表示されます。
  • clusterStatus.nodesStatus[]: クラスタ内の各ノードのエントリ。ノードの nodeState（PREPARING、RUNNING、UPDATING、ERROR）、Compute Engine インスタンス名、ノードプール、状態が最後に変更された時刻を示します。
  • clusterStatus.detail: クラスタのステータスの人間が読める説明（利用可能な場合）。

構成フィールドの説明については、 パラメータ リファレンスをご覧ください。

次のステップ