Afficher les clusters

Si vous êtes intéressé par les clusters d'entraînement Gemini Enterprise Agent Platform, contactez votre conseiller 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 Google Cloud 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

Si vous recherchez des instructions pour mettre à jour 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 Google Cloud pour accéder aux services et aux API Google Cloud , 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 Google Cloud .

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 permettent pas à elles seules de rendre les clusters d'entraînement visibles dans la console Google Cloud . La page Clusters d'entraînement ne s'affiche que pour les projets inscrits aux clusters d'entraînement Gemini Enterprise Agent Platform. Si vous ne voyez pas la page, contactez votre conseiller commercial.

La console Google Cloud 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 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 console Google Cloud , 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 Google Cloud , 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 répertorie les clusters de cette région. Chaque colonne de la table décrit une propriété du cluster :

    Colonne Description
    ID L'ID du cluster, que vous utilisez comme CLUSTER_ID dans les requêtes 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 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 : par l'ID du projet.
  • REGION : région où 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 d'autres éléments. Si aucune valeur n'est spécifiée, 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 réussie 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 console Google Cloud et l'API Agent Platform signalent 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 Google Cloud .

Console

  1. Dans la console Google Cloud , 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 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 des GPU, les métriques du gestionnaire de GPU de centre de données (DCGM) NVIDIA, le réseau GPU et l'état des GPU.

Pour actualiser 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 où 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 consoleGoogle Cloud .

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'un des éléments suivants : PROVISIONING, RUNNING, UPDATING, STOPPING ou ERROR. La console Google Cloud affiche PROVISIONING avec l'état Création.
  • clusterStatus.nodesStatus[] : une entrée pour chaque nœud du cluster, indiquant l'état nodeState du nœud (PREPARING, RUNNING, UPDATING ou ERROR), le nom de son instance Compute Engine, son pool de nœuds et l'heure de son dernier changement d'état.
  • clusterStatus.detail : description de l'état du cluster dans un format lisible par l'humain, lorsqu'elle est disponible.
  • clusterStatus.infrastructureNotices[] : avis de maintenance d'infrastructure actifs pour le cluster, le cas échéant. Pour en savoir plus, consultez Maintenance des clusters.

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

Maintenance du cluster

Les clusters d'entraînement Gemini Enterprise Agent Platform mettent régulièrement à jour le logiciel de gestion de cluster sur un cluster en cours d'exécution, comme le contrôleur Slurm. Pendant ou après une mise à jour de maintenance, la console Google Cloud affiche une notification dans la colonne État de la page Clusters d'entraînement et dans une bannière sur la page Détails du cluster. Dans l'API Agent Platform, les notifications actives s'affichent dans le champ clusterStatus.infrastructureNotices.

Les avis de maintenance suivants peuvent s'afficher :

  • Maintenance en cours : le cluster fait l'objet d'une maintenance de l'infrastructure et peut être temporairement indisponible. Attendez que la mise à jour de maintenance soit terminée avant d'envoyer de nouveaux jobs Slurm ou de mettre à jour le cluster.
  • Maintenance incomplète : un problème inattendu a empêché la mise à jour de maintenance de se terminer. Le cluster reste fonctionnel et aucune action n'est requise si vos charges de travail s'exécutent normalement. Si le cluster est partiellement inaccessible ou si les commandes Slurm échouent, contactez votre représentant Google ou l'équipe d'assistanceGoogle Cloud en indiquant l'ID de votre projet, l'ID du cluster et la région.

Les avis de maintenance sont automatiquement effacés une fois la maintenance terminée.

Étapes suivantes