Afficher les clusters

Si vous êtes intéressé par les clusters d'entraînement Gemini Enterprise Agent Platform, contactez votre représentant commercial pour y accéder.

Cette page explique comment lister et afficher les clusters d'entraînement de votre projet à l'aide de la Google Cloud console ou de l'API Agent Platform (Google Cloud CLI n'est pas compatible).

L'affichage d'un cluster vous permet de confirmer les éléments suivants :

  • Configuration du cluster
  • État du cluster et des nœuds
  • Informations sur le nœud de connexion
  • Utilisation des ressources du cluster

Pour obtenir des instructions sur la mise à jour d'un cluster, consultez Gérer un cluster.

Avant de commencer

Authentifiez-vous auprès de Gemini Enterprise Agent Platform, sauf si vous l'avez déjà fait.

Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

Console

Lorsque vous utilisez la Google Cloud console pour accéder aux Google Cloud services et aux API, vous n'avez pas besoin de configurer l'authentification.

REST

Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

    Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée.

Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l' Google Cloud authentification.

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher les clusters d'entraînement, demandez à votre administrateur de vous accorder le rôle IAM Lecteur Agent Platform (roles/aiplatform.viewer) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour afficher les clusters d'entraînement. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les clusters d'entraînement :

  • Pour afficher la liste des clusters : aiplatform.modelDevelopmentClusters.list
  • Pour afficher les détails d'un seul cluster : aiplatform.modelDevelopmentClusters.get

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Visibilité de la console

Les autorisations IAM ne rendent pas les clusters d'entraînement visibles dans la Google Cloud console. La page Clusters d'entraînement ne s'affiche que pour les projets inscrits aux clusters d'entraînement Gemini Enterprise Agent Platform. Si la page ne s'affiche pas, contactez votre représentant commercial.

La Google Cloud console nécessite également que les API suivantes soient activées dans votre projet. Si l'une d'elles est manquante, la page Clusters d'entraînement affiche un bouton Activer les API au lieu de vos clusters :

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

Authentification pour l'API

Les exemples d'API Agent Platform de cette page utilisent l'alias suivant, qui appelle la Google Cloud CLI pour générer un jeton d'accès :

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

Afficher la liste des clusters

Les deux interfaces listent les clusters une région à la fois. Dans la Google Cloud console, vous choisissez la région dans une liste, et avec l'API Agent Platform, la région fait partie de l'URL de la requête.

Console

  1. Dans la Google Cloud console, accédez à la page Clusters d'entraînement.

    Accéder à la page "Clusters d'entraînement"

  2. Dans la liste Région, sélectionnez la région dans laquelle vous souhaitez afficher les clusters.

    La page liste les clusters de cette région. Chaque colonne du tableau décrit une propriété du cluster :

    Colonne Description
    ID ID du cluster, que vous utilisez comme CLUSTER_ID dans les requêtes de l'API Agent Platform.
    Nom Nom à afficher pour le cluster.
    État État du cluster : Creating, Running, Updating, Stopping ou Error.
    Nœuds Nombre de nœuds dans le cluster.
    Date de création Date de création du cluster.
    Types de machines Types de machines utilisés par les pools de nœuds du cluster.
    Modèles de consommation Mode d'obtention de la capacité du cluster : Reservation, Spot, Flex-start ou On-demand.

  3. Pour ouvrir un cluster, cliquez sur son nom dans la colonne Nom.

REST

Pour afficher la liste des clusters d'une région, envoyez une requête GET à la collection modelDevelopmentClusters :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • REGION : région dans laquelle se trouvent vos clusters.

La méthode list accepte les paramètres de requête facultatifs suivants pour contrôler la pagination :

  • pageSize (entier, facultatif) : nombre maximal de clusters à renvoyer dans la réponse. Le service peut renvoyer une valeur inférieure à celle-ci, même si d'autres éléments existent. Si ce paramètre n'est pas spécifié, une taille de page par défaut est utilisée.
  • pageToken (chaîne, facultatif) : jeton reçu d'un appel de liste précédent. Fournissez ce jeton pour récupérer la page de résultats suivante.

L'exemple suivant demande la première page de résultats, avec un maximum de cinq clusters par page :

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

Une réponse positive contient un tableau modelDevelopmentClusters avec jusqu'à cinq ressources de cluster, et peut également inclure une chaîne nextPageToken.

Afficher les détails d'un cluster

La Google Cloud console et l'API Agent Platform indiquent la configuration d'un cluster et son état actuel, y compris l'état de chacun de ses nœuds. Les tableaux de bord Cloud Monitoring ne sont disponibles que dans la Google Cloud console.

Console

  1. Dans la Google Cloud console, accédez à la page Clusters d'entraînement.

    Accéder à la page "Clusters d'entraînement"

  2. Dans la liste Région, sélectionnez la région dans laquelle se trouve le cluster.

  3. Dans la colonne Nom, cliquez sur le nom du cluster que vous souhaitez afficher. La page Détails du cluster s'ouvre dans l'onglet Présentation.

  4. Sélectionnez un onglet pour afficher les détails correspondants :

    • Présentation : nom, description et emplacement du cluster, ainsi que ses paramètres de calcul, de réseau et d’orchestration configurés, son nœud de connexion et ses partitions Slurm.

    • Nœuds : deux tableaux décrivant les nœuds du cluster.

    • Nœuds de connexion, avec les colonnes État, Nom, Zone, Type de machine, Adresse IP interne, Adresse IP externe et Se connecter. Utilisez Se connecter pour ouvrir une session SSH sur un nœud de connexion.

    • Nœuds de calcul, avec les colonnes État, Nom, Zone, Type de machine, Adresse IP interne et Partition.

    • Observabilité : tableaux de bord Cloud Monitoring prédéfinis couvrant l'utilisation du processeur, de la mémoire et du réseau dans le cluster, ainsi que l'utilisation du GPU, les métriques du gestionnaire de GPU du centre de données NVIDIA (DCGM), le réseau GPU et l'état du GPU.

Pour recharger la page avec l'état actuel du cluster, cliquez sur Actualiser. Pour supprimer le cluster, cliquez sur Supprimer.

REST

Pour afficher les détails d'un seul cluster, envoyez une requête GET à la ressource de cluster :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • REGION : région dans laquelle se trouve votre cluster.
  • CLUSTER_ID : ID du cluster que vous souhaitez afficher. Il s'agit de la valeur affichée dans la colonne ID de la page Clusters d'entraînement de la Google Cloud console.

La réponse est une ressource ModelDevelopmentCluster. Outre la configuration du cluster, son champ clusterStatus indique l'état actuel du cluster et de chacun de ses nœuds :

  • clusterStatus.state: état du cluster, qui peut être PROVISIONING, RUNNING, UPDATING, STOPPING ou ERROR. La Google Cloud console affiche PROVISIONING comme Création.
  • clusterStatus.nodesStatus[]: une entrée pour chaque nœud du cluster, indiquant le nodeState du nœud (PREPARING, RUNNING, UPDATING ou ERROR), le nom de son instance Compute Engine, son pool de nœuds et l'heure à laquelle son état a été modifié pour la dernière fois.
  • clusterStatus.detail: description lisible de l'état du cluster, lorsqu'elle est disponible.

Pour obtenir une description des champs de configuration, consultez la référence des paramètres.

Étape suivante