Se connecter à un environnement d'exécution dans Colab Enterprise

Cette page vous explique comment vous connecter à un environnement d'exécution dans Colab Enterprise.

Pour exécuter du code dans votre notebook, vous devez vous connecter à un environnement d'exécution. Un environnement d'exécution est une ressource de calcul qui exécute votre code.

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.

   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

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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

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

Se connecter en utilisant différentes méthodes

Cette page vous explique comment vous connecter à un environnement d'exécution à l'aide des méthodes suivantes :

• Utiliser l'environnement d'exécution par défaut
• Se connecter à un environnement d'exécution existant
• Créer un environnement d'exécution

Utiliser l'environnement d'exécution par défaut

Cette section explique comment se connecter à l'environnement d'exécution par défaut.

Rôles requis

Pour vous assurer que votre compte utilisateur dispose des autorisations nécessaires pour se connecter à l'environnement d'exécution par défaut dans un notebook Colab Enterprise, demandez à votre administrateur d'accorder à votre compte de service le rôle IAM "Utilisateur Colab Entreprise" (roles/aiplatform.colabEnterpriseUser) 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.

Un ou plusieurs des rôles requis incluent l'autorisation dataform.repositories.list. Les utilisateurs disposant de l'autorisation dataform.repositories.list ou du rôle Créateur de code (roles/dataform.codeCreator) dans un projet peuvent répertorier les noms des composants de code de ce projet. À l'aide de l'API Dataform ou de l'interface de ligne de commande (CLI) Dataform. Les utilisateurs sans droits d'administrateur qui utilisent BigQuery Studio ne peuvent voir que les composants de code qu'ils ont créés ou qui ont été partagés avec eux.

Se connecter à l'environnement d'exécution par défaut

Lorsque vous exécutez du code dans un notebook pour la première fois, Colab Enterprise se connecte automatiquement à l'environnement d'exécution par défaut, sauf si vous en spécifiez un autre.

Pour vous connecter à l'environnement d'exécution par défaut sans exécuter de code, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Notebooks de Colab Enterprise.

   Accéder à Notebooks

2. Dans le menu Région, sélectionnez la région qui contient votre notebook.

3. Dans l'onglet Mes notebooks, cliquez sur le notebook que vous souhaitez ouvrir. Si vous n'avez pas encore créé de notebook, créez-en un.

4. Dans votre notebook, cliquez sur Connecter.
   

5. Si vous vous connectez pour la première fois à un environnement d'exécution avec les identifiants de l'utilisateur final activés, une boîte de dialogue Connexion s'affiche.

   Les identifiants de l'utilisateur final sont activés par défaut dans l'environnement d'exécution. Pour utiliser un environnement d'exécution qui n'a pas accès à vos identifiants utilisateur, créez un modèle d'exécution sans les identifiants de l'utilisateur final activés.

   Pour autoriser Colab Enterprise à accéder à vos identifiants utilisateur, procédez comme suit:

   1. Dans la boîte de dialogue Connexion, cliquez sur votre compte utilisateur.

   2. Sélectionnez Afficher, modifier, configurer et supprimer vos données Google Cloud... pour autoriser Colab Enterprise à accéder à vos identifiants utilisateur.

      

   3. Cliquez sur Continuer.

Colab Enterprise se connecte à l'environnement d'exécution par défaut. Si l'environnement d'exécution par défaut n'est pas en cours d'exécution, Colab Enterprise démarre l'environnement d'exécution par défaut, puis s'y connecte.

Se connecter à un environnement d'exécution existant

Cette section explique comment se connecter à un environnement d'exécution existant à l'aide de la boîte de dialogue Se connecter à un environnement d'exécution Vertex AI.

Rôles requis

Pour vous assurer que votre compte utilisateur dispose des autorisations nécessaires pour se connecter à un environnement d'exécution existant dans un notebook Colab Enterprise, demandez à votre administrateur d'accorder à ce compte utilisateur le rôle IAM "Utilisateur de Colab Entreprise" (roles/aiplatform.colabEnterpriseUser) 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.

Un ou plusieurs des rôles requis incluent l'autorisation dataform.repositories.list. Les utilisateurs disposant de l'autorisation dataform.repositories.list ou du rôle Créateur de code (roles/dataform.codeCreator) dans un projet peuvent répertorier les noms des composants de code de ce projet. À l'aide de l'API Dataform ou de l'interface de ligne de commande (CLI) Dataform. Les utilisateurs sans droits d'administrateur qui utilisent BigQuery Studio ne peuvent voir que les composants de code qu'ils ont créés ou qui ont été partagés avec eux.

Se connecter à l'environnement d'exécution existant

Pour vous connecter à un environnement d'exécution existant, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Notebooks de Colab Enterprise.

   Accéder à Notebooks

2. Dans le menu Région, sélectionnez la région qui contient votre notebook.

3. Dans l'onglet Mes notebooks, cliquez sur le notebook que vous souhaitez ouvrir. Si vous n'avez pas encore créé de notebook, créez-en un.

4. Dans votre notebook, cliquez sur la flèche de développement Options de connexion supplémentaires, puis sélectionnez Se connecter à un environnement d'exécution.
   

   La boîte de dialogue Se connecter à l'environnement d'exécution Vertex AI s'ouvre.

5. Pour le champ Sélectionner un environnement d'exécution, sélectionnez Se connecter à un environnement d'exécution existant.

6. Pour le champ Sélectionner une option d'environnement d'exécution existante, sélectionnez l'environnement d'exécution auquel vous souhaitez vous connecter. Si la liste ne comporte aucun environnement d'exécution, créez-en un ou connectez-vous à l'environnement d'exécution par défaut.

7. Cliquez sur Se connecter.

8. Si les identifiants de l'utilisateur final sont activés dans votre environnement d'exécution et que c'est la première fois que vous vous connectez à un environnement d'exécution avec ces identifiants activés, une boîte de dialogue Connexion s'affiche.

   Pour utiliser un environnement d'exécution qui n'a pas accès à vos identifiants utilisateur, créez un modèle d'exécution sans les identifiants de l'utilisateur final activés.

   Pour autoriser Colab Enterprise à accéder à vos identifiants utilisateur, procédez comme suit:

   1. Dans la boîte de dialogue Connexion, cliquez sur votre compte utilisateur.

   2. Sélectionnez Afficher, modifier, configurer et supprimer vos données Google Cloud... pour autoriser Colab Enterprise à accéder à vos identifiants utilisateur.

      

   3. Cliquez sur Continuer.

Colab Enterprise se connecte à l'environnement d'exécution. Si l'environnement d'exécution ne s'exécute pas, Colab Enterprise démarre l'environnement d'exécution, puis s'y connecte.

Créer un environnement d'exécution

Cette section explique comment créer un environnement d'exécution et s'y connecter à l'aide de la boîte de dialogue Se connecter à un environnement d'exécution Vertex AI. Vous pouvez également créer un environnement d'exécution à partir de l'onglet Environnements d'exécution.

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.

Un ou plusieurs des rôles requis incluent l'autorisation dataform.repositories.list. Les utilisateurs disposant de l'autorisation dataform.repositories.list ou du rôle Créateur de code (roles/dataform.codeCreator) dans un projet peuvent répertorier les noms des composants de code de ce projet. À l'aide de l'API Dataform ou de l'interface de ligne de commande (CLI) Dataform. Les utilisateurs sans droits d'administrateur qui utilisent BigQuery Studio ne peuvent voir que les composants de code qu'ils ont créés ou qui ont été partagés avec eux.

Créer un environnement d'exécution et s'y connecter

Pour créer un environnement d'exécution et vous y connecter à l'aide de la boîte de dialogue Se connecter à un environnement d'exécution Vertex AI, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Notebooks de Colab Enterprise.

   Accéder à Notebooks

2. Dans le menu Région, sélectionnez la région qui contient votre notebook.

3. Dans l'onglet Mes notebooks, cliquez sur le notebook que vous souhaitez ouvrir. Si vous n'avez pas encore créé de notebook, créez-en un.

4. Dans votre notebook, cliquez sur la flèche de développement Options de connexion supplémentaires, puis sélectionnez Se connecter à un environnement d'exécution.
   

   La boîte de dialogue Se connecter à l'environnement d'exécution Vertex AI s'ouvre.

5. Pour le champ Sélectionner un environnement d'exécution, sélectionnez Créer un environnement d'exécution.

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

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

8. Cliquez sur Se connecter.

9. Si les identifiants de l'utilisateur final sont activés dans le modèle d'exécution que vous avez sélectionné, et que c'est la première fois que vous vous connectez à un environnement d'exécution avec les identifiants de l'utilisateur final activés, une boîte de dialogue Connexion s'affiche.

   Pour utiliser un environnement d'exécution qui n'a pas accès à vos identifiants utilisateur, créez un modèle d'exécution sans les identifiants de l'utilisateur final activés.

   Pour autoriser Colab Enterprise à accéder à vos identifiants utilisateur, procédez comme suit:

   1. Dans la boîte de dialogue Connexion, cliquez sur votre compte utilisateur.

   2. Sélectionnez Afficher, modifier, configurer et supprimer vos données Google Cloud... pour autoriser Colab Enterprise à accéder à vos identifiants utilisateur.

      

   3. Cliquez sur Continuer.

Colab Enterprise démarre l'environnement d'exécution par défaut, puis s'y connecte.

Résoudre les problèmes

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

Impossible de se connecter à un environnement d'exécution

Ce problème se produit pour plusieurs raisons. Les causes les plus courantes sont les suivantes :

Le navigateur bloque les cookies tiers

Le navigateur que vous utilisez bloque un cookie tiers utilisé par Colab Enterprise pour établir une connexion HTTPS avec l'environnement d'exécution.

Pour résoudre ce problème, configurez les paramètres de votre navigateur afin d'autoriser le cookie tiers DATALAB_TUNNEL_TOKEN du domaine *.aiplatform-notebook.googleusercontent.com.

Le réseau bloque le trafic sortant vers les domaines de notebooks

Les règles de pare-feu de votre réseau bloquent le trafic sortant vers *.aiplatform-notebook.cloud.google.com ou *aiplatform.googleapis.com.

Pour résoudre ce problème, configurez les règles de pare-feu de votre réseau afin d'autoriser le trafic sortant vers *.aiplatform-notebook.cloud.google.com et *aiplatform.googleapis.com.

Étapes suivantes

• Obtenez plus d'informations sur les environnements d'exécution et les modèles d'exécution.
• Créez un modèle d'exécution.