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 vous explique comment lister et afficher les clusters d'entraînement de votre projet à l'aide de la console Cloud de Confiance ou de l'API Agent Platform (Google Cloud CLI n'est pas compatible).

L'affichage d'un cluster vous permet de confirmer les points suivants :

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

Si vous recherchez 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 console Cloud de Confiance pour accéder aux services et aux API Cloud de Confiance by S3NS , 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'authentification Cloud de Confiance .

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 de la plate-forme d'agents (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 suffisent pas à rendre les clusters d'entraînement visibles dans la console Cloud de Confiance . 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 console Cloud de Confiance nécessite également l'activation des API suivantes dans votre projet. S'il en manque, 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 sur 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 console Cloud de Confiance , vous choisissez la région dans une liste. Avec l'API Agent Platform, la région fait partie de l'URL de la requête.

Console

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

    Accéder aux 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 du cluster.
    Status É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 Méthode utilisée pour obtenir 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 : par l'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 un nombre inférieur à cette valeur, même s'il existe plus d'éléments. Si aucune taille de page n'est spécifiée, une taille de page par défaut est utilisée.
  • pageToken (chaîne, facultatif) : jeton reçu lors 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 réussie contient un tableau modelDevelopmentClusters avec un maximum de cinq ressources de cluster et peut également inclure une chaîne nextPageToken.

Afficher les détails d'un cluster

La console Cloud de Confiance 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 console Cloud de Confiance .

Console

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

    Accéder aux 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 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 l'ensemble du 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 : par l'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 consoleCloud de Confiance .

La réponse est une ressource ModelDevelopmentCluster. En plus de 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, l'une des valeurs PROVISIONING, RUNNING, UPDATING, STOPPING ou ERROR. La console Cloud de Confiance affiche PROVISIONING avec l'état Création en cours.
  • 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 changé pour la dernière fois.
  • clusterStatus.detail : description de l'état du cluster dans un format lisible, le cas échéant.

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

Étapes suivantes