Utiliser des réservations avec des instances Agent Platform Workbench

Utiliser des réservations avec des instances Agent Platform Workbench

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 machine virtuelle (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 les événements suivants se produisent :

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

• Vous êtes facturé pour les ressources réservées au même tarif à la demande que pour les VM en cours d'exécution, y compris les remises applicables, jusqu'à ce que la réservation soit supprimée. Lorsqu'une VM utilise une réservation, elle n'est pas facturée deux fois pour les ressources, car la réservation est déjà facturée pour le coût des ressources réservées. Pour en savoir plus, consultez la section 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 work.

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 être l'une des suivantes :

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

• Pour utiliser la 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 la section Exigences.

Avant de commencer

1. Consultez les exigences et restrictions applicables aux réservations.
2. Consultez les exigences relatives aux quotas et restrictions applicables aux réservations partagées.
Connectez-vous à votre Google Cloud compte. Si vous n'avez jamais utilisé Google Cloud, créez un compte pour évaluer les performances de nos produits dans des scénarios réels. 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 serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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 serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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 une fois votre réservation terminée, utilisez une réservation à la demande. Évitez d'utiliser une réservation future, car lorsque celle-ci arrive à son terme, 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 Agent Platform Workbench, vous devez la supprimer.

Utiliser une réservation avec une nouvelle instance

Pour créer une instance Agent Platform Workbench qui utilise une réservation, vous pouvez utiliser la Google Cloud console 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 Google Cloud console, 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 qui correspondent à votre réservation.

5. Sous Plate-forme de 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 automatiquement un lien Ouvrir JupyterLab.

REST

Avant d'utiliser les données de requête ci-dessous, 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. Doit être RESERVATION_ANY ou RESERVATION_SPECIFIC.
• RESERVATION_NAME : nom de votre réservation lorsque vous utilisez le RESERVATION_SPECIFIC type
• 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, consultez 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 portent le libellé goog-vertex-ai-product: workbench-instances sur le code SKU. Consultez la page Tarifs de Compute Engine.

• Les frais de gestion d'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 des instances Agent Platform Workbench, consultez la page Résoudre les problèmes liés aux instances Agent Platform Workbench.

Étape suivante

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