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

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 l'activation de l'accès à l'Internet public. 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 exécuter le code qu'il contient sans connaître 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 d'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'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 depuis 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 incluant des accélérateurs.

Un seul environnement d'exécution par défaut sans accélérateurs et un seul environnement d'exécution par défaut avec accélérateurs sont autorisés pour chaque utilisateur par projet et par région.

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 si le projet n'en possède pas déjà un dans la région. L'environnement d'exécution par défaut et le modèle d'environnement d'exécution s'affichent dans la console Google Cloud , où vous pouvez obtenir des informations les concernant.

Remarque : Le rôle Utilisateur Colab Enterprise (roles/aiplatform.colabEnterpriseUser) n'inclut pas l'autorisation requise pour créer un modèle d'exécution par défaut (aiplatform.notebookRuntimeTemplates.create). Cela signifie que pour créer un environnement d'exécution par défaut, s'il n'existe pas de modèle d'exécution par défaut, les utilisateurs disposant du rôle Utilisateur Colab Enterprise doivent également disposer d'un rôle incluant l'autorisation aiplatform.notebookRuntimeTemplates.create.

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'exécution correspondant s'il n'existe pas de modèle d'exécution par défaut, 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 s'il n'existe pas de modèle d'exécution par défaut avec des accélérateurs, 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 leurs modèles d'environnement d'exécution par défaut créés automatiquement incluent les spécifications suivantes :

Spécification	Par défaut	Par défaut avec GPU
Version Python	Dernière version disponible (actuellement Python 3.13)	Dernière version disponible (actuellement Python 3.13)
Type de machine	e2-standard-4	Sous réserve de disponibilité selon les régions. Consultez la section Spécifications.
Accélérateur	Aucun	Sous réserve de disponibilité selon les régions. Consultez la section Spécifications.
Disque de démarrage	Disque persistant SSD de 100 Gio (pd-ssd)	Disque persistant SSD de 100 Gio (pd-ssd)
Disque de données	Disque persistant standard de 100 Gio (pd-standard)	Sous réserve de disponibilité selon les régions. Consultez la section Spécifications.
Arrêt en cas d'inactivité	Activé, défini sur 180 minutes	Activé, défini sur 180 minutes
Réseau	Réseau cloud privé virtuel par défaut de votre projet	Réseau cloud privé virtuel par défaut de votre projet
Accès à Internet public	Activé	Activé
Authentification des identifiants de l'utilisateur final	Activé	Activé
Suppression automatique	Suppression automatique 18 heures après la création	Suppression automatique 18 heures après la création

Remarque : Lorsque votre environnement d'exécution est supprimé, Colab Enterprise ne conserve pas les modifications que vous avez apportées aux fichiers de votre environnement d'exécution. De plus, tous les fichiers que vous avez importés dans votre environnement d'exécution sont supprimés.

Définir un modèle d'exécution comme modèle d'exécution par défaut

Vous pouvez définir un modèle d'exécution existant comme modèle d'exécution par défaut pour votre projet et votre région. Lorsque vous définissez un modèle d'exécution comme modèle par défaut, les nouveaux environnements d'exécution par défaut créés dans le projet et la région actuels utilisent la configuration de ce modèle. Les environnements d'exécution existants ne sont pas affectés.

Une fois qu'un modèle d'exécution est défini comme modèle d'exécution par défaut, toutes les nouvelles exécutions créées à partir du modèle d'exécution par défaut sont automatiquement supprimées 18 heures après leur création.

Chaque combinaison de région et de projet ne peut comporter qu'un seul modèle d'exécution par défaut sans accélérateurs et un seul modèle d'exécution par défaut avec accélérateurs. Les modèles d'exécution qui étaient auparavant les modèles par défaut deviennent des modèles définis par l'utilisateur, et les nouveaux environnements d'exécution créés à partir de ceux-ci sont automatiquement supprimés au bout de six mois.

Vous pouvez définir à la fois un modèle d'exécution par défaut sans accélérateurs et un modèle d'exécution par défaut avec accélérateurs.

Remarque : Pour définir un modèle d'exécution par défaut, vous devez disposer de l'autorisation aiplatform.notebookRuntimeTemplates.setDefault. Cette autorisation est incluse dans des rôles tels que Administrateur Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) et Administrateur d'exécution de notebook (roles/aiplatform.notebookRuntimeAdmin).

Pour définir un modèle d'exécution comme modèle d'exécution par défaut, vous pouvez utiliser la consoleGoogle Cloud . Pour ce faire, accédez à la page Modèles d'exécution ou à la page d'informations d'un modèle d'exécution.

Sur la page "Modèles d'exécution" :

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

   Accéder aux modèles d'exécution

2. Dans le menu Région, sélectionnez la région qui contient votre modèle d'exécution.

3. Sur la ligne du modèle d'exécution que vous souhaitez définir par défaut, cliquez sur  Actions.

4. Selon que le modèle inclut ou non des accélérateurs :

   • Pour un modèle sans accélérateurs, cliquez sur Définir par défaut.
   • Pour un modèle avec des accélérateurs, cliquez sur Définir comme modèle par défaut avec des GPU.

5. Dans la boîte de dialogue de confirmation, cliquez sur Définir comme modèle par défaut ou Définir comme modèle par défaut avec des GPU pour confirmer.

Depuis la page d'informations sur le modèle d'exécution :

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

   Accéder aux modèles d'exécution

2. Dans le menu Région, sélectionnez la région qui contient votre modèle d'exécution.

3. Dans la colonne ID, cliquez sur l'ID du modèle d'exécution que vous souhaitez définir par défaut.

4. Dans la barre d'action en haut de la page, cliquez sur  Définir comme modèle par défaut ou  Définir comme modèle par défaut avec des GPU.

5. Dans la boîte de dialogue de confirmation, cliquez sur Définir comme modèle par défaut ou Définir comme modèle par défaut avec des GPU pour confirmer.

Versions Python

Lorsque Colab Enterprise crée un modèle d'exécution par défaut, celui-ci est configuré pour utiliser la dernière version disponible de Python (actuellement Python 3.13). Cela signifie que lorsqu'une nouvelle version de Python est disponible dans Colab Enterprise, les nouvelles exécutions créées à partir du modèle d'exécution par défaut utilisent la dernière version de Python.

Si vos modèles 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'exécution par défaut afin d'utiliser la dernière version de Python, vous devez supprimer le modèle d'exécution par défaut. Ensuite, lorsqu'un nouveau modèle d'exécution par défaut est créé, il est configuré pour utiliser la dernière version de Python.

Pour mettre à jour la version de Python d'un modèle d'exécution que vous avez créé, consultez Gérer les modèles 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 la console Google Cloud ou l'API REST.

Console

Pour modifier un modèle d'exécution, procédez comme suit :

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

   Accéder aux modèles d'exécution

2. Dans le menu Région, sélectionnez la région qui contient votre modèle d'exécution.

3. Dans la colonne ID, cliquez sur le numéro d'ID du modèle d'exécution que vous souhaitez modifier.

4. Cliquez sur  Modifier.

5. Dans le panneau Modifier le modèle d'exécution, apportez des modifications au modèle d'exécution.

6. Cliquez sur Mettre à jour.

REST

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

• REGION : région dans laquelle 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

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 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"

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 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

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 notebookRuntimeTemplates.patch.

Versions Python compatibles

Colab Enterprise est compatible avec les versions de Python pendant des périodes spécifiques.

Le tableau suivant indique la date de fin des correctifs et de l'assistance et la date de fin de disponibilité pour chaque version de Python compatible. Pour en savoir plus sur ces dates, consultez Comprendre les dates de fin de l'assistance.

Version Python	Date de fin de correctif et de fin de compatibilité	Date de fin de disponibilité
Python 3.13	À déterminer	À déterminer
Python 3.12	À déterminer	À déterminer
Python 3.11	À déterminer	À déterminer
Python 3.10	23 février 2026	17 août 2026

Comprendre les dates de fin de compatibilité

La compatibilité avec une version de Python prend fin aux dates suivantes :

• Date de fin de correctif et de fin de compatibilité : après cette date, les modifications suivantes ont lieu :

  • Vous ne pouvez pas créer de modèles d'exécution qui utilisent cette version de Python.
  • Tous vos modèles d'exécution existants qui utilisent cette version de Python sont automatiquement mis à niveau pour utiliser la dernière version de Python disponible.
  • Les environnements d'exécution existants ne peuvent plus être mis à niveau.
  • Les environnements d'exécution cessent de fonctionner six mois après leur dernière mise à niveau ou, s'ils n'ont pas été mis à niveau, six mois après leur création.

  Pour demander une prolongation de l'utilisation de cette version de Python jusqu'à la date de fin de disponibilité, contactez votre responsable de compte Google Cloud.

• Date de fin de disponibilité : après cette date, les modifications suivantes ont lieu :

  • Cette version de Python n'est pas disponible dans Colab Enterprise, même pour les utilisateurs ayant bénéficié d'une extension.
  • Tous les modèles d'exécution existants qui utilisent cette version de Python sont automatiquement mis à niveau pour utiliser la dernière version de Python disponible.

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 utilisateur

Les environnements d'exécution sont réservés à un 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, cette personne 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 basés sur le 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 avez importés sont supprimés. Si vous avez modifié des fichiers, ils reviendront à leur état d'origine lors de la création d'un environnement d'exécution. 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 des notebooks

Vous pouvez connecter plusieurs notebooks au même environnement d'exécution, mais cela n'est pas recommandé. Le partage d'un même environnement d'exécution par plusieurs notebooks peut entraîner des problèmes, y compris les suivants :

• 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écutez le deuxième 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'exécution. Consultez Vous pouvez créer plusieurs environnements d'exécution à partir du même modèle 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 les disques de données sont supprimés en même temps que les environnements d'exécution.

Les environnements d'exécution incluent toujours un disque persistant SSD de 100 Gio 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.

Pendant l'arrêt des environnements d'exécution :

• Aucuns frais de calcul ne sont générés, car aucun CPU ni GPU n'est utilisé.
• Le stockage sur disque de démarrage et sur 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'exécution autre que celui par défaut. De cette façon, vous pouvez 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 l'environnement d'exécution ne peut être utilisé qu'avec des notebooks de cette région.

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

Vous pouvez partager un modèle d'exécution avec d'autres utilisateurs. Chaque utilisateur peut ainsi créer son propre environnement d'exécution basé sur le même modèle d'environnement d'exécution. Plusieurs utilisateurs peuvent donc exécuter le même notebook sur la même configuration de VM.

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

Configuration

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

Région

Choisissez la région où 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 puisse exécuter 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 la page 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 cas d'inactivité 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 notebook 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 à l'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 permettre à votre notebook d'accéder aux Identifiants par défaut de l'application (ADC). Vous pouvez utiliser cet accès aux ADC pour exécuter du code dans votre notebook qui interagit avec Agent Platform et d'autres services Google Cloud . Lorsque les identifiants de l'utilisateur final sont activés, votre notebook utilise les identifiants de la personne 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 Configurer les ADC pour un environnement de développement local.

Frais liés au modèle d'exécution

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

Étapes suivantes

• 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.