Utiliser des réservations avec des instances Workbench Agent Platform

Utiliser des réservations avec des instances Workbench Agent Platform

Ce document explique comment utiliser les réservations Compute Engine pour vous assurer que vos instances Gemini Enterprise Agent Platform Workbench disposent de suffisamment de ressources de machines virtuelles (VM) pour s'exécuter.

Les réservations sont une fonctionnalité de Compute Engine. Elles vous permettent de vous assurer que vous disposez des ressources nécessaires pour créer des VM avec le même matériel (mémoire et processeurs virtuels) et les mêmes ressources facultatives (GPU et disques SSD locaux) chaque fois que vous en avez besoin.

Lorsque vous créez une réservation, Compute Engine vérifie que la capacité demandée est disponible dans la zone spécifiée. Si c'est le cas, Compute Engine réserve les ressources, crée la réservation et effectue les opérations suivantes :

• Les ressources réservées sont immédiatement disponibles pour votre utilisation et le restent jusqu'à ce que vous supprimiez la réservation.

• Les ressources réservées vous sont facturées au même tarif à la demande que les VM en cours d'exécution, y compris les remises applicables, jusqu'à ce que la réservation soit supprimée. Lors de l'utilisation d'une réservation, une VM n'entraîne pas de frais de ressources en double, car la réservation est déjà facturée pour le coût des ressources réservées. Pour en savoir plus, consultez Réservations de ressources zonales Compute Engine.

Limites et exigences

Toutes les limites des réservations Compute Engine s'appliquent lorsque les instances Agent Platform Workbench consomment des réservations. Consultez la section Fonctionnement des réservations.

De plus, lorsque vous utilisez des réservations avec des instances Agent Platform Workbench, les limites et exigences suivantes s'appliquent :

• Votre réservation doit correspondre à l'un des éléments suivants :

  • Dans le même projet que votre instance Agent Platform Workbench.
  • Partagé avec le même projet que votre instance Workbench Agent Platform.

• Pour utiliser une réservation, les propriétés de VM d'une réservation doivent correspondre exactement à celles de votre instance Agent Platform Workbench. Par exemple, si une réservation spécifie un type de machine e2-standard-8, l'instance Agent Platform Workbench ne peut utiliser la réservation que si elle utilise également un type de machine e2-standard-8. Consultez les conditions requises.

Avant de commencer

1. Consultez les exigences et restrictions applicables aux réservations.
2. Consultez les exigences relatives aux quotas et les restrictions applicables aux réservations partagées.
Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Enable the Compute Engine and Notebooks APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Enable the Compute Engine and Notebooks APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Rôles requis

Pour obtenir les autorisations nécessaires pour utiliser des réservations avec des instances Agent Platform Workbench, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

• Administrateur de Compute (roles/compute.admin)
• Administrateur Notebooks (roles/notebooks.admin)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

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

Créer une réservation

Créez une réservation Compute Engine. Il peut s'agir d'une réservation à projet unique ou d'une réservation partagée. La réservation peut être à la demande ou future. Pour en savoir plus, consultez Choisir un type de réservation.

Attention : Si vous souhaitez utiliser votre instance Agent Platform Workbench après la fin de votre réservation, utilisez une réservation à la demande. Évitez d'utiliser une réservation future, car lorsque celle-ci arrive à son heure de fin, Compute Engine supprime automatiquement la VM sous-jacente de votre instance, y compris son disque de données. Votre instance Agent Platform Workbench cesse de fonctionner et n'entraîne plus de frais. Pour supprimer l'instance de votre liste d'instances Workbench Agent Platform, vous devez la supprimer.

Utiliser une réservation avec une nouvelle instance

Pour créer une instance Agent Platform Workbench qui consomme une réservation, vous pouvez utiliser la console Google Cloud ou l'API REST.

Console

Pour créer une instance Agent Platform Workbench qui utilise une réservation, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Instances.

   Accéder à la page "Instances"

2. Cliquez sur Créer.

3. Dans la boîte de dialogue Nouvelle instance, cliquez sur Options avancées.

4. Dans la boîte de dialogue Créer une instance, dans la section Type de machine, sélectionnez le type de machine et la configuration de GPU correspondant à votre réservation.

5. Sous Plate-forme du processeur et GPU, dans le menu Réservations, sélectionnez la réservation à utiliser.

6. Cliquez sur Créer.

   Agent Platform Workbench crée une instance et la démarre automatiquement. Lorsque l'instance est prête à l'emploi, Agent Platform Workbench active un lien Ouvrir JupyterLab.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet.
• LOCATION : zone où se trouve votre instance
• INSTANCE_NAME : nom de l'instance
• MACHINE_TYPE : type de machine de votre instance
• RESERVATION_TYPE : type de réservation (RESERVATION_ANY ou RESERVATION_SPECIFIC)
• RESERVATION_NAME : nom de votre réservation lorsque vous utilisez le type RESERVATION_SPECIFIC
• Pour les réservations dans le même projet, vous pouvez utiliser l'ID de réservation.
• Pour les réservations dans un autre projet, vous devez utiliser le chemin d'accès complet à la réservation. Par exemple, projects/PROJECT_ID/reservations/RESERVATION_NAME.

Méthode HTTP et URL :

POST https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances?instanceId=INSTANCE_NAME

Corps JSON de la requête :

{
  "gce_setup": {
    "machine_type": "MACHINE_TYPE",
    "reservation_affinity": {
      "consume_reservation_type": "RESERVATION_TYPE",
      "key": "compute.googleapis.com/reservation-name",
      "values": ["RESERVATION_NAME"]
    }
  }
}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Remarque : Pour la commande suivante, nous partons du principe que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances?instanceId=INSTANCE_NAME"

PowerShell

Remarque : Pour la commande suivante, nous partons du principe que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances?instanceId=INSTANCE_NAME" | Select-Object -Expand Content

Si elle aboutit, le corps de la réponse contient une instance d'Operation.

Pour en savoir plus, reportez-vous à la. documentation de l'API REST projects.locations.instances.create.

Cesser d'utiliser votre réservation

Pour cesser d'utiliser votre réservation, vous pouvez supprimer votre réservation.

Si vous souhaitez continuer à utiliser votre réservation avec d'autres ressources, mais que vous ne souhaitez pas que votre instance Agent Platform Workbench existante l'utilise, vous devez supprimer l'instance.

Facturation

Lorsque vous utilisez une réservation Compute Engine, vous êtes facturé pour les éléments suivants :

• Les ressources Compute Engine, y compris les remises sur engagement d'utilisation applicables, aux tarifs Compute Engine. Ces frais sont associés au libellé goog-vertex-ai-product: workbench-instances sur le code SKU. Consultez la page Tarifs de Compute Engine.

• Des frais de gestion Agent Platform Workbench s'ajoutent à votre utilisation de l'infrastructure. Consultez les tarifs d'Agent Platform Workbench.

Résoudre les problèmes

Pour connaître les méthodes de diagnostic et de résolution des erreurs liées à l'utilisation de réservations avec les instances Agent Platform Workbench, consultez Résoudre les problèmes liés aux instances Agent Platform Workbench.

Étapes suivantes

• Pour en savoir plus sur les réservations Compute Engine, consultez la section Réservations de ressources zonales Compute Engine.