Créer un environnement d'exécution

Cette page vous explique comment créer, démarrer et supprimer un environnement d'exécution dans Colab Enterprise.

Vous pouvez créer un environnement d'exécution pour exécuter du code sur un environnement d'exécution dont la configuration est différente de la configuration par défaut. Les environnements d'exécution sont créés à partir d'un modèle d'exécution, qui inclut des spécifications comme le type de machine et la taille du disque.

Pour en savoir plus sur les environnements d'exécution, consultez la page Environnements d'exécution et modèles d'exécution.

Avant de commencer

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI, Dataform, and Compute Engine APIs.

    Enable the APIs

    5.

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI, Dataform, and Compute Engine APIs.

    Enable the APIs

    8.

Rôles requis

Pour vous assurer que votre compte utilisateur dispose des autorisations nécessaires pour créer un environnement d'exécution dans Colab Enterprise, demandez à votre administrateur d'accorder à votre compte utilisateur le rôle IAM Administrateur Colab Enterprise roles/aiplatform.colabEnterpriseAdmin) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Votre administrateur peut également attribuer à votre compte utilisateur les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Créer un environnement d'exécution

Pour créer un environnement d'exécution, vous pouvez utiliser la console Google Cloud ou la Google Cloud CLI.

Console

Pour créer un environnement d'exécution, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Environnements d'exécution de Colab Enterprise.

    Accédez à la page "Environnements d'exécution".

  2. Dans le menu Région, sélectionnez la région dans laquelle vous souhaitez créer votre environnement d'exécution. Il doit se trouver dans la même région que le notebook qui l'utilise.

  3. Cliquez sur  Créer.

    La boîte de dialogue Créer un environnement d'exécution Vertex AI s'affiche.

  4. Dans le menu Modèle d'exécution, sélectionnez un modèle d'exécution. Si aucun modèle d'exécution ne s'affiche, créez-en un.

  5. Dans le champ Nom de l'environnement d'exécution, saisissez un nom pour votre environnement d'exécution.

  6. Cliquez sur Créer.

Par défaut, lorsque vous créez un environnement d'exécution, vous disposez automatiquement des autorisations requises pour le démarrer et le supprimer.

gcloud

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • DISPLAY_NAME: nom à afficher de votre environnement d'exécution.
  • RUNTIME_TEMPLATE_ID: ID du modèle d'exécution. Le modèle d'environnement d'exécution spécifie la configuration de calcul de votre environnement d'exécution.
  • PROJECT_ID : ID de votre projet.
  • REGION: région dans laquelle vous souhaitez créer votre environnement d'exécution.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud colab runtimes create --display-name="DISPLAY_NAME" \
    --runtime-template=RUNTIME_TEMPLATE_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes create --display-name="DISPLAY_NAME" `
    --runtime-template=RUNTIME_TEMPLATE_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes create --display-name="DISPLAY_NAME" ^
    --runtime-template=RUNTIME_TEMPLATE_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Par défaut, lorsque vous créez un environnement d'exécution, vous disposez automatiquement des autorisations requises pour le démarrer et le supprimer.

Pour en savoir plus sur la commande permettant de créer un modèle d'exécution à partir de la ligne de commande, consultez la documentation de la CLI gcloud.

Résoudre les problèmes

Cette section explique comment résoudre les problèmes de création d'environnements d'exécution dans Colab Enterprise.

Impossible de créer un environnement d'exécution

Ce problème se produit lorsque vous ne parvenez pas à créer un environnement d'exécution. Consultez également la section Impossible de créer un environnement d'exécution par défaut. Les causes les plus courantes sont les suivantes :

Quota insuffisant

Si vous ne parvenez pas à créer un environnement d'exécution, vous avez peut-être dépassé votre quota d'environnements d'exécution Compute Engine.

Colab Enterprise utilise un quota Compute Engine pour les environnements d'exécution. Pour plus d'informations, consultez la page Présentation des quotas et des limites de Compute Engine.

Pour résoudre ce problème, demandez un quota plus élevé.

Ressources indisponibles

L'erreur suivante se produit lorsque vous essayez de créer un environnement d'exécution.

No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

Cette erreur se produit si aucune ressource n'est disponible pour la configuration de votre type de machine dans la région de votre notebook.

Pour résoudre ce problème, essayez un environnement d'exécution avec une configuration de type de machine différente ou réessayez ultérieurement.

Un environnement d'exécution par défaut existe déjà

L'erreur suivante se produit lorsque vous essayez de créer un environnement d'exécution à partir du modèle d'environnement d'exécution par défaut alors que l'environnement d'exécution par défaut existe déjà. 

Failed to create runtime

One click runtime already exists.

Si vous essayez de créer un environnement d'exécution à partir d'un modèle d'environnement d'exécution par défaut, Colab Enterprise tente de créer un environnement d'exécution par défaut. Il ne peut y avoir qu'un seul environnement d'exécution par défaut par utilisateur, projet et région. Si l'environnement d'exécution par défaut existe déjà, Colab Enterprise ne peut pas en créer un autre.

Pour résoudre ce problème, connectez-vous à l'environnement d'exécution par défaut existant ou créez-en un à partir d'un modèle d'environnement d'exécution autre que celui par défaut.

Impossible de créer un environnement d'exécution par défaut

Lorsque Colab Enterprise crée un environnement d'exécution par défaut, il crée d'abord un modèle d'environnement d'exécution par défaut qu'il utilise pour générer l'environnement d'exécution par défaut. Si vous essayez de créer un environnement d'exécution par défaut sans les autorisations requises pour créer un modèle d'exécution, Colab Enterprise ne peut pas créer l'environnement d'exécution par défaut.

Pour résoudre ce problème, demandez à votre administrateur de vous attribuer un rôle qui inclut l'autorisation aiplatform.notebookRuntimeTemplates.create.

Étape suivante