Conectarse a un entorno de ejecución en Colab Enterprise

En esta página se explica cómo conectarse a un entorno de ejecución en Colab Enterprise.

Para ejecutar código en tu cuaderno, debes conectarte a un entorno de ejecución. Un tiempo de ejecución es un recurso de computación que ejecuta tu código.

Antes de empezar

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.

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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Conectarse mediante diferentes métodos

En esta página se explica cómo conectarse a un tiempo de ejecución mediante los siguientes métodos:

• Usar el tiempo de ejecución predeterminado
• Conectarse a un entorno de ejecución
• Crear un tiempo de ejecución

Usar el tiempo de ejecución predeterminado

En esta sección se describe cómo conectarse al tiempo de ejecución predeterminado.

Roles obligatorios

Para obtener los permisos que necesitas para conectarte al entorno de ejecución predeterminado de un cuaderno de Colab Enterprise, pide a tu administrador que te conceda el rol de gestión de identidades y accesos de usuario de Colab Enterprise (roles/aiplatform.colabEnterpriseUser) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Conectarse al entorno de ejecución predeterminado

Cuando ejecutas código en un cuaderno por primera vez, Colab Enterprise se conecta automáticamente al entorno de ejecución predeterminado, a menos que especifiques otro.

Para conectarte al entorno de ejecución predeterminado sin ejecutar código, haz lo siguiente:

1. En la consola, ve a la página Mis cuadernos de Colab Enterprise. Google Cloud

   Ir a Mis cuadernos

2. En el menú Región, selecciona la región que contiene tu cuaderno.

3. Haz clic en el cuaderno que quieras abrir. Si aún no has creado ningún cuaderno, crea uno.

4. En tu cuaderno, haz clic en Conectar.
   

5. Si es la primera vez que te conectas a un tiempo de ejecución con las credenciales de usuario final habilitadas, aparecerá el cuadro de diálogo Iniciar sesión.

   Para conceder acceso a Colab Enterprise a tus credenciales de usuario, sigue estos pasos:

   1. En el cuadro de diálogo Iniciar sesión, haz clic en tu cuenta de usuario.

   2. Selecciona Ver, editar, configurar y eliminar tus datos de Google Cloud ... para conceder acceso a Colab Enterprise a tus credenciales de usuario.

      

   3. Haz clic en Continuar.

Colab Enterprise se conecta al entorno de ejecución predeterminado. Si el entorno de ejecución predeterminado no se está ejecutando, Colab Enterprise lo inicia y, a continuación, se conecta a él.

Conectarse a un entorno de ejecución

En esta sección se describe cómo conectarse a un tiempo de ejecución con el cuadro de diálogo Conectar con el tiempo de ejecución de Vertex AI.

Roles obligatorios

Para obtener los permisos que necesitas para conectarte a un entorno de ejecución en un cuaderno de Colab Enterprise, pide a tu administrador que te conceda el rol de gestión de identidades y accesos de usuario de Colab Enterprise (roles/aiplatform.colabEnterpriseUser) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Conectarse al entorno de ejecución

Para conectarte a un tiempo de ejecución, sigue estos pasos:

1. En la consola, ve a la página Mis cuadernos de Colab Enterprise. Google Cloud

   Ir a Mis cuadernos

2. En el menú Región, selecciona la región que contiene tu cuaderno.

3. Haz clic en el cuaderno que quieras abrir. Si aún no has creado ningún cuaderno, crea uno.

4. En tu cuaderno, haz clic en la flecha del desplegable Opciones de conexión adicionales y, a continuación, selecciona Conectar con un tiempo de ejecución.
   

   Se abrirá el cuadro de diálogo Conectar con el tiempo de ejecución de Vertex AI.

5. En Seleccionar un tiempo de ejecución, selecciona Conectar a un tiempo de ejecución.

6. En Seleccionar una opción de tiempo de ejecución, selecciona el tiempo de ejecución al que quieras conectarte. Si no hay ningún tiempo de ejecución en la lista, crea uno o conéctate al tiempo de ejecución predeterminado.

7. Haz clic en Conectar.

8. Si tu tiempo de ejecución tiene habilitadas las credenciales de usuario final y es la primera vez que te conectas a un tiempo de ejecución con las credenciales de usuario final habilitadas, aparecerá un cuadro de diálogo Iniciar sesión.

   Para conceder acceso a Colab Enterprise a tus credenciales de usuario, sigue estos pasos:

   1. En el cuadro de diálogo Iniciar sesión, haz clic en tu cuenta de usuario.

   2. Selecciona Ver, editar, configurar y eliminar tus datos de Google Cloud ... para conceder acceso a Colab Enterprise a tus credenciales de usuario.

      

   3. Haz clic en Continuar.

Colab Enterprise se conecta al entorno de ejecución. Si el entorno de ejecución no está en funcionamiento, Colab Enterprise lo inicia y, a continuación, se conecta a él.

Crear un tiempo de ejecución

En esta sección se describe cómo crear un tiempo de ejecución y conectarse a él mediante el cuadro de diálogo Conectar con el tiempo de ejecución de Vertex AI. También puedes crear un entorno de ejecución desde la pestaña Entornos de ejecución.

Roles obligatorios

Para obtener los permisos que necesitas para crear un tiempo de ejecución en Colab Enterprise, pídele a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Crear un tiempo de ejecución y conectarse a él

Para crear un tiempo de ejecución y conectarte a él mediante el cuadro de diálogo Conectar con el tiempo de ejecución de Vertex AI, sigue estos pasos:

1. En la consola, ve a la página Mis cuadernos de Colab Enterprise. Google Cloud

   Ir a Mis cuadernos

2. En el menú Región, selecciona la región que contiene tu cuaderno.

3. Haz clic en el cuaderno que quieras abrir. Si aún no has creado ningún cuaderno, crea uno.

4. En tu cuaderno, haz clic en la flecha del desplegable Opciones de conexión adicionales y, a continuación, selecciona Conectar con un tiempo de ejecución.
   

   Se abrirá el cuadro de diálogo Conectar con el tiempo de ejecución de Vertex AI.

5. En Seleccionar un tiempo de ejecución, selecciona Crear un tiempo de ejecución.

6. En el menú Plantilla de tiempo de ejecución, selecciona una plantilla de tiempo de ejecución. Si no hay ninguna plantilla de tiempo de ejecución en la lista, crea una.

7. En el campo Nombre de tiempo de ejecución, introduce un nombre para tu tiempo de ejecución.

8. Haz clic en Conectar.

9. Si la plantilla de tiempo de ejecución que has seleccionado tiene habilitadas las credenciales de usuario final y es la primera vez que te conectas a un tiempo de ejecución con las credenciales de usuario final habilitadas, aparecerá un cuadro de diálogo Iniciar sesión.

   Para conceder acceso a Colab Enterprise a tus credenciales de usuario, sigue estos pasos:

   1. En el cuadro de diálogo Iniciar sesión, haz clic en tu cuenta de usuario.

   2. Selecciona Ver, editar, configurar y eliminar tus datos de Google Cloud ... para conceder acceso a Colab Enterprise a tus credenciales de usuario.

      

   3. Haz clic en Continuar.

Colab Enterprise inicia el entorno de ejecución predeterminado y, a continuación, se conecta a él.

Gestión del tiempo de ejecución

De forma predeterminada, cuando creas un tiempo de ejecución, tienes automáticamente los permisos necesarios para eliminar (aiplatform.googleapis.com/notebookRuntimes.delete) e iniciar (aiplatform.googleapis.com/notebookRuntimes.start) ese tiempo de ejecución.

Para saber cómo gestionar tu tiempo de ejecución, incluido cómo eliminarlo, iniciarlo o desconectarte de él, consulta Gestionar tiempos de ejecución.

Solucionar problemas

En esta sección se explica cómo resolver problemas de conexión con los tiempos de ejecución en Colab Enterprise.

No se puede conectar a un tiempo de ejecución

Este problema se produce por varios motivos. Las causas más habituales son las siguientes:

El navegador bloquea las cookies de terceros

El navegador que estás usando está bloqueando una cookie de terceros que Colab Enterprise usa para establecer una conexión HTTPS con el tiempo de ejecución.

Para solucionar este problema, configure los ajustes de su navegador para que permita la cookie de terceros DATALAB_TUNNEL_TOKEN del dominio *.aiplatform-notebook.googleusercontent.com.

La red bloquea el tráfico saliente a los dominios de los cuadernos

Las reglas de cortafuegos de tu red bloquean el tráfico saliente a *.aiplatform-notebook.cloud.google.com o *aiplatform.googleapis.com.

Para resolver este problema, configure las reglas del cortafuegos de su red para permitir el tráfico saliente a *.aiplatform-notebook.cloud.google.com y *aiplatform.googleapis.com.

Siguientes pasos

• Consulta más información sobre los runtimes y las plantillas de runtime.
• Crea una plantilla de tiempo de ejecución.
• Para encontrar un cuaderno que te ayude a poner en marcha tu proyecto rápidamente, consulta la galería de cuadernos.