Environnements d'exécution et modèles d'environnement d'exécution

Cette page décrit les environnements d'exécution et les modèles d'exécution pour Colab Enterprise.

Un environnement d'exécution est une machine virtuelle (VM) provisionnée par Google qui peut exécuter le code de votre notebook (fichier IPYNB).

Un modèle d'exécution est une configuration de VM qui spécifie un type de machine et d'autres caractéristiques de la VM, ainsi que des paramètres courants tels que le réseau et si l'accès à Internet public est activé. Lorsque vous créez un environnement d'exécution, sa VM est créée conformément aux spécifications d'un modèle d'environnement d'exécution.

Workflow

Vous pouvez créer un notebook Colab Enterprise et y exécuter du code sans avoir à comprendre le fonctionnement des environnements d'exécution. Lorsque vous exécutez votre code pour la première fois, Colab Enterprise provisionne un environnement d'exécution par défaut et y exécute votre code. Colab Enterprise continue à utiliser l'environnement d'exécution par défaut jusqu'à ce que vous vous connectiez à un autre environnement d'exécution.

Pour configurer un environnement d'exécution afin de répondre à des besoins spécifiques, vous devez :

1. Créez un modèle d'environnement d'exécution avec la configuration dont vous avez besoin.

2. Créez un environnement d'exécution basé sur ce modèle.

3. Connectez-vous à l'environnement d'exécution à partir de votre notebook et exécutez votre code.

Environnements d'exécution

Cette section décrit les caractéristiques des environnements d'exécution.

Environnement d'exécution par défaut

Si vous ne créez pas d'environnement d'exécution, un environnement d'exécution sans accélérateurs est créé pour vous la première fois que vous exécutez du code ou que vous vous connectez à l'environnement d'exécution par défaut. Vous pouvez utiliser l'environnement d'exécution par défaut sans accélérateurs ou passer à un environnement d'exécution par défaut qui inclut des accélérateurs.

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 correspondant. Le runtime et le modèle de runtime apparaissent dans la console Google Cloud , où vous pouvez obtenir des informations à leur sujet.

Si vous utilisez des environnements d'exécution par défaut sans accélérateurs, Colab Enterprise crée un environnement d'exécution par défaut sans accélérateurs et son modèle d'environnement d'exécution correspondant, par projet et par région.

Si vous utilisez des environnements d'exécution par défaut avec des accélérateurs, Colab Enterprise crée un environnement d'exécution par défaut avec des accélérateurs et son modèle d'exécution correspondant, par projet et par région.

Spécifications d'environnement d'exécution par défaut

Les environnements d'exécution par défaut et les modèles d'environnement d'exécution par défaut correspondants incluent les spécifications suivantes:

Versions Python

À partir de mai 2025, lorsque Colab Enterprise crée un modèle d'exécution par défaut, il est configuré pour utiliser la dernière version de Python (actuellement Python 3.11). Cela signifie que lorsqu'une nouvelle version de Python est disponible dans Colab Enterprise, les nouveaux environnements d'exécution créés à partir du modèle d'environnement d'exécution par défaut utilisent la dernière version de Python.

Si vos modèles d'environnement d'exécution par défaut ont été créés en mai 2025 ou avant, ils peuvent être configurés pour utiliser Python 3.10. Pour mettre à jour un modèle d'environnement d'exécution par défaut afin d'utiliser la dernière version de Python, vous devez supprimer le modèle d'environnement d'exécution par défaut. Ensuite, lorsqu'un nouveau modèle d'environnement d'exécution par défaut est créé, il est configuré pour utiliser la dernière version de Python.

Pour mettre à jour la version Python d'un modèle d'environnement d'exécution que vous avez créé, consultez la section Modifier la version Python d'un modèle d'environnement d'exécution.

La version Python des environnements d'exécution existants ne change pas automatiquement, même lorsqu'une nouvelle version de Python est disponible dans Colab Enterprise. Il n'est pas possible de modifier la version de Python d'un environnement d'exécution existant. Vous devez plutôt créer un environnement d'exécution dérivé d'un modèle d'environnement d'exécution qui utilise la version de Python souhaitée.

Modifier la version Python d'un modèle d'exécution

Pour modifier la version Python d'un modèle d'exécution, vous pouvez utiliser l'API REST.

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

• REGION: région où se trouve votre modèle d'exécution.
• PROJECT_ID : ID de votre projet.
• NOTEBOOK_RUNTIME_TEMPLATE_ID: ID de votre modèle d'exécution.
• RELEASE_NAME: nom de la version de l'image que vous souhaitez utiliser. Par exemple, py311 est le nom de la version de l'image Python 3.11. Pour définir l'image sur Latest, laissez RELEASE_NAME vide.

Méthode HTTP et URL :

PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name

Corps JSON de la requête :

{
  softwareConfig: {
    colabImage: {
      releaseName: "RELEASE_NAME"
    }
  }
}

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

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"

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

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | Select-Object -Expand Content

Pour en savoir plus, reportez-vous à la. documentation de l'API REST notebookRuntimeTemplates.patch.

Les environnements d'exécution sont régionaux

Les environnements d'exécution sont régionaux et doivent se trouver dans la même région que votre notebook.

Les environnements d'exécution sont réservés à un seul utilisateur

Les environnements d'exécution sont réservés à un seul utilisateur. Vous ne pouvez pas partager vos environnements d'exécution avec d'autres utilisateurs ni utiliser les leurs. Même si vous partagez un notebook avec quelqu'un, il n'a pas accès à votre environnement d'exécution et doit exécuter le notebook sur son propre environnement d'exécution.

Toutefois, les utilisateurs peuvent créer leurs propres environnements d'exécution sur la base du même modèle d'environnement d'exécution. Consultez Les modèles d'exécution peuvent être partagés avec les utilisateurs.

Gérer les fichiers de votre environnement d'exécution

Vous pouvez accéder aux fichiers de votre environnement d'exécution et les modifier à l'aide du bouton  Fichiers dans Colab Enterprise. Vous pouvez également importer des fichiers dans votre environnement d'exécution.

Lorsque votre environnement d'exécution est supprimé, tous les fichiers que vous importez le sont également. Si vous avez modifié des fichiers, ils retrouveront leur état d'origine lorsqu'un nouvel environnement d'exécution sera créé. Consultez la période de suppression automatique dans la section Spécifications d'exécution par défaut.

Les environnements d'exécution peuvent être partagés par les notebooks

Vous pouvez associer plusieurs notebooks au même environnement d'exécution, mais cela n'est pas recommandé. Plusieurs notebooks partageant le même environnement d'exécution peuvent entraîner des problèmes, y compris:

• Les notebooks peuvent s'exécuter lentement, car ils partagent les ressources de calcul de l'environnement d'exécution.

• Le code d'un notebook peut affecter l'état de la VM de l'environnement d'exécution pour l'autre notebook. Par exemple, si vous installez la version 1.3 d'un package dans un notebook, mais que votre autre notebook nécessite la version 1.2, vous risquez de rencontrer une incompatibilité de version lorsque vous exécuterez le second notebook.

Au lieu d'exécuter du code à partir de plusieurs notebooks sur le même environnement d'exécution, vous pouvez créer un environnement d'exécution pour chaque notebook en fonction du même modèle d'environnement d'exécution. Consultez la section Vous pouvez créer plusieurs environnements d'exécution à partir du même modèle d'environnement d'exécution.

Frais d'exécution

Les frais de traitement des environnements d'exécution sont calculés en fonction du type de machine et des accélérateurs que vous utilisez. Le stockage du disque de démarrage et du disque de données vous est également facturé. Les disques de démarrage et de données sont supprimés lorsque les environnements d'exécution sont supprimés.

Les environnements d'exécution incluent toujours un disque persistant SSD de 100 Go en plus du disque de données spécifié dans le modèle d'exécution. Le disque de démarrage n'est pas configurable.

Lorsque les environnements d'exécution sont arrêtés:

• Les frais de calcul ne sont pas générés, car aucun CPU ni GPU n'est utilisé.
• Le stockage sur le disque de démarrage et le disque de données est facturé.

Pour en savoir plus, consultez la page Tarifs de Colab Enterprise.

Vous pouvez créer plusieurs environnements d'exécution à partir du même modèle d'exécution.

Vous pouvez créer plusieurs environnements d'exécution à partir d'un seul modèle d'environnement d'exécution non par défaut. Vous pouvez ainsi exécuter plusieurs notebooks sur des VM avec la même configuration sans partager les ressources de cette VM.

Modèles d'exécution

Cette section décrit les caractéristiques des modèles d'exécution.

Les modèles d'exécution sont régionaux

Les modèles d'exécution sont régionaux. Lorsque vous créez un environnement d'exécution, il se trouve dans la même région que le modèle d'environnement d'exécution, et ne peut être utilisé qu'avec des notebooks dans cette région.

Les modèles d'exécution peuvent être partagés avec les utilisateurs

Vous pouvez partager un modèle d'exécution avec d'autres utilisateurs. De cette façon, chaque utilisateur peut créer son propre environnement d'exécution basé sur le même modèle d'environnement d'exécution. Par conséquent, plusieurs utilisateurs peuvent exécuter le même notebook sur la même configuration de VM.

Pour en savoir plus, consultez la section Gérer l'accès à un modèle d'exécution.

Configuration

Les modèles d'environnement d'exécution déterminent la configuration de la VM de votre environnement d'exécution. Vous pouvez spécifier l'une des valeurs suivantes:

Région

Choisissez la région dans laquelle se trouve votre notebook. Les environnements d'exécution créés à partir de modèles d'exécution se trouvent dans la même région que le modèle d'exécution. Pour que le notebook exécute du code dans l'environnement d'exécution, le notebook et l'environnement d'exécution doivent se trouver dans la même région.

Type de machine

Vous pouvez configurer le type de machine de votre modèle d'exécution. Pour en savoir plus sur les types de machines, consultez le Guide des ressources de familles de machines et guide comparatif.

Disque de données

Vous pouvez configurer le type et la taille du disque de données dans votre modèle d'exécution.

Lorsque votre environnement d'exécution est créé, il inclut également un disque de démarrage. Le disque de démarrage est un disque persistant SSD de 100 Gio et ne peut pas être configuré.

Accélérateurs

Vous pouvez ajouter des accélérateurs à la configuration de votre modèle d'exécution. La disponibilité des accélérateurs dépend du type de machine et de la région.

Réseau

Spécifiez votre réseau ou utilisez le réseau cloud privé virtuel par défaut du projet.

Arrêt en cas d'inactivité

Colab Enterprise active l'arrêt en veille par défaut. Ce paramètre arrête votre instance après 180 minutes d'inactivité. Vous pouvez modifier le nombre de minutes d'inactivité avant l'arrêt ou désactiver l'arrêt en cas d'inactivité.

Accès Internet public

Pour mieux contrôler la sécurité de votre ordinateur portable et d'autres ressources, vous pouvez désactiver l'accès à l'Internet public. Si vous configurez votre modèle d'exécution de cette manière, les notebooks qui utilisent des environnements d'exécution créés à partir du modèle d'exécution n'auront pas accès à Internet public.

Authentification des identifiants de l'utilisateur final

Par défaut, les modèles d'exécution utilisent l'authentification par identifiants de l'utilisateur final pour donner à votre notebook accès aux Identifiants par défaut de l'application (ADC). Vous pouvez utiliser cet accès aux identifiants par défaut de l'application pour exécuter du code dans votre notebook qui interagit avec Vertex AI et d'autres services Google Cloud . Lorsque les identifiants de l'utilisateur final sont activés, votre notebook utilise les identifiants de l'utilisateur qui l'exécute pour déterminer l'accès aux ressources Google Cloud .

Si les identifiants de l'utilisateur final ne sont pas activés, vous pouvez accéder à ADC en authentifiant l'utilisateur via le code de votre notebook. Pour en savoir plus, consultez la section "Identifiants utilisateur" de la page Configurer les ADC pour un environnement de développement local.

Frais liés aux modèles d'exécution

La création et le stockage de modèles d'exécution sont gratuits. Consultez également la section Frais d'exécution.

Étape suivante

• Créez un environnement d'exécution basé sur un modèle d'environnement d'exécution.
• Connectez-vous à un environnement d'exécution.
• Créez un modèle d'exécution.